Velocity Annotations are added to your K8s entity definitions under the metadata.annotations tag. They add essential information about your application, such as an identifier, dependencies, connectivity definitions, and more.
Examples in GitHub: Helm on AWS, Helm on GCP

On all Kubernetes resources
Specify a Velocity Service identifier
Example: backend
Specify service dependencies to enable extracting service parameters and service properties.
Example: mysql, postgres
Specify service boot dependencies to control provision order.
Example: mysql
Associate additional K8s resources to a Velocity service. For example, ServiceAccount resources.
Example: mysql<variable>
Define a variable that other services can import.
Export the value specified in the following path so that other services can import it: path="spec.template.spec.containers.(name=my-sql).env.[0].value"
Specify a resource to be ignored by Velocity. When a resource has this annotation, it won't appear in Velocity.

On Deployments, StatefulSets, Jobs, or others with an /id<port_id>-publicHostname
Specify the public hostname for the related k8 service port. For ingress objects - this is inferred automatically. Useful for special CRDs.
Example:<port_id>-publicHostname: service-{velocity.v1.domainSuffix}<port_id>-user
Specify the user name for the related k8 service port, which will be used when generating a URI.
Example:<port_id>-user: const="username"<port_id>-password
Specify the password for the related k8 service port which will be used when generating a URI.
Example:<port_id>-password: const="password"<port_id>-scheme
Specify the schema for the related k8 service port, which will be used when generating a URI.
Example:<port_id>-scheme: const="https"
Specify a custom timeout of waiting for the resource to become ready or finish executing.
The timeout must be between 1m (1 minute) and 1h (1 hour).
The default value varies between resource types. It is 15m for Jobs and 10m for other resources.
Example: 15m

On Jobs
Defines the run policy. By default, the job will run once on environment creation. Optional values:
  • always: Run on environment create and with any environment update.
  • destroy: Run on environment destruction.
Example: always