Built-in Policy Type

This documentation will walk through all the built-in policy types sorted alphabetically.

It was generated automatically by scripts, please don’t update manually, last updated at 2022-07-24T21:01:20+08:00.

Apply-Once

Description

Allow configuration drift for applied resources, delivery the resource without continuously reconciliation.

Examples (apply-once)

It’s generally used in one time delivery only without continuous management scenario.

  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4.   name: apply-once-app
  5. spec:
  6.   components:
  7.     - name: hello-world
  8.       type: webservice
  9.       properties:
  10.         image: oamdev/hello-world
  11.       traits:
  12.         - type: scaler
  13.           properties:
  14.             replicas: 1
  15.   policies:
  16.     - name: apply-once
  17.       type: apply-once
  18.       properties:
  19.         enable: true

Specification (apply-once)

NameDescriptionTypeRequiredDefault
enableWhether to enable apply-once for the whole application.boolfalsefalse
rulesSpecify the rules for configuring apply-once policy in resource level.[]rulesfalse

rules (apply-once)

NameDescriptionTypeRequiredDefault
selectorSpecify how to select the targets of the rule.selectorfalse
strategySpecify the strategy for configuring the resource level configuration drift behaviour.strategytrue
selector (apply-once)
NameDescriptionTypeRequiredDefault
componentNamesSelect resources by component names.[]stringfalse
componentTypesSelect resources by component types.[]stringfalse
oamTypesSelect resources by oamTypes (COMPONENT or TRAIT).[]stringfalse
traitTypesSelect resources by trait types.[]stringfalse
resourceTypesSelect resources by resource types (like Deployment).[]stringfalse
resourceNamesSelect resources by their names.[]stringfalse
strategy (apply-once)
NameDescriptionTypeRequiredDefault
pathSpecify the path of the resource that allow configuration drift.[]stringtrue

Garbage-Collect

Description

Configure the garbage collect behaviour for the application.

Examples (garbage-collect)

It’s used in garbage collection scenario. It can be used to configure the collection policy, e.g. don’t delete the legacy resources when updating.

  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4.   name: first-vela-app
  5. spec:
  6.   components:
  7.     - name: express-server
  8.       type: webservice
  9.       properties:
  10.         image: oamdev/hello-world
  11.         port: 8000
  12.       traits:
  13.         - type: ingress-1-20
  14.           properties:
  15.             domain: testsvc.example.com
  16.             http:
  17.               "/": 8000
  18.   policies:
  19.     - name: keep-legacy-resource
  20.       type: garbage-collect
  21.       properties:
  22.         keepLegacyResource: true
  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4.   name: garbage-collect-app
  5. spec:
  6.   components:
  7.     - name: hello-world-new
  8.       type: webservice
  9.       properties:
  10.         image: oamdev/hello-world
  11.       traits:
  12.         - type: expose
  13.           properties:
  14.             port: [8000]
  15.   policies:
  16.     - name: garbage-collect
  17.       type: garbage-collect
  18.       properties:
  19.         rules:
  20.           - selector:
  21.               traitTypes:
  22.                 - expose
  23.             strategy: onAppDelete

Specification (garbage-collect)

NameDescriptionTypeRequiredDefault
keepLegacyResourceIf is set, outdated versioned resourcetracker will not be recycled automatically, outdated resources will be kept until resourcetracker be deleted manually.boolfalsefalse
rulesSpecify the list of rules to control gc strategy at resource level, if one resource is controlled by multiple rules, first rule will be used.[]rulesfalse

rules (garbage-collect)

NameDescriptionTypeRequiredDefault
selectorSpecify how to select the targets of the rule.[]selectortrue
strategySpecify the strategy for target resource to recycle.stringfalseonAppUpdate
selector (garbage-collect)
NameDescriptionTypeRequiredDefault
componentNamesSelect resources by component names.[]stringfalse
componentTypesSelect resources by component types.[]stringfalse
oamTypesSelect resources by oamTypes (COMPONENT or TRAIT).[]stringfalse
traitTypesSelect resources by trait types.[]stringfalse
resourceTypesSelect resources by resource types (like Deployment).[]stringfalse
resourceNamesSelect resources by their names.[]stringfalse

Health

Description

Apply periodical health checking to the application.

Specification (health)

NameDescriptionTypeRequiredDefault
probeTimeoutSpecify health checking timeout(seconds), default 10s.intfalse10
probeIntervalSpecify health checking interval(seconds), default 30s.intfalse30

Override

Description

Describe the configuration to override when deploying resources, it only works with specified deploy step in workflow.

Examples (override)

  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4.   name: deploy-with-override
  5.   namespace: examples
  6. spec:
  7.   components:
  8.     - name: nginx-with-override
  9.       type: webservice
  10.       properties:
  11.         image: nginx
  12.   policies:
  13.     - name: topology-hangzhou-clusters
  14.       type: topology
  15.       properties:
  16.         clusterLabelSelector:
  17.           region: hangzhou
  18.     - name: topology-local
  19.       type: topology
  20.       properties:
  21.         clusters: ["local"]
  22.         namespace: examples-alternative
  23.     - name: override-nginx-legacy-image
  24.       type: override
  25.       properties:
  26.         components:
  27.           - name: nginx-with-override
  28.             properties:
  29.               image: nginx:1.20
  30.     - name: override-high-availability
  31.       type: override
  32.       properties:
  33.         components:
  34.           - type: webservice
  35.             traits:
  36.               - type: scaler
  37.                 properties:
  38.                   replicas: 3
  39.   workflow:
  40.     steps:
  41.       - type: deploy
  42.         name: deploy-local
  43.         properties:
  44.           policies: ["topology-local"]
  45.       - type: deploy
  46.         name: deploy-hangzhou
  47.         properties:
  48.           policies: ["topology-hangzhou-clusters", "override-nginx-legacy-image", "override-high-availability"]
  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4.   name: advance-override
  5.   namespace: examples
  6. spec:
  7.   components:
  8.     - name: nginx-advance-override-legacy
  9.       type: webservice
  10.       properties:
  11.         image: nginx:1.20
  12.     - name: nginx-advance-override-latest
  13.       type: webservice
  14.       properties:
  15.         image: nginx
  16.   policies:
  17.     - name: topology-hangzhou-clusters
  18.       type: topology
  19.       properties:
  20.         clusterLabelSelector:
  21.           region: hangzhou
  22.     - name: topology-local
  23.       type: topology
  24.       properties:
  25.         clusters: ["local"]
  26.         namespace: examples-alternative
  27.     - name: override-nginx-legacy
  28.       type: override
  29.       properties:
  30.         selector: ["nginx-advance-override-legacy"]
  31.     - name: override-nginx-latest
  32.       type: override
  33.       properties:
  34.         selector: ["nginx-advance-override-latest", "nginx-advance-override-stable"]
  35.         components:
  36.           - name: nginx-advance-override-stable
  37.             type: webservice
  38.             properties:
  39.               image: nginx:stable
  40.   workflow:
  41.     steps:
  42.       - type: deploy
  43.         name: deploy-local
  44.         properties:
  45.           policies: ["topology-local", "override-nginx-legacy"]
  46.       - type: deploy
  47.         name: deploy-hangzhou
  48.         properties:
  49.           policies: ["topology-hangzhou-clusters", "override-nginx-latest"]

Specification (override)

NameDescriptionTypeRequiredDefault
componentsSpecify the overridden component configuration.[]componentstrue
selectorSpecify a list of component names to use, if empty, all components will be selected.[]stringfalse

components (override)

NameDescriptionTypeRequiredDefault
nameSpecify the name of the patch component, if empty, all components will be merged.stringfalse
typeSpecify the type of the patch component.stringfalse
propertiesSpecify the properties to override.map[string]:(null|bool|string|bytes|{…}|[…]|number)false
traitsSpecify the traits to override.[]traitsfalse
traits (override)
NameDescriptionTypeRequiredDefault
typeSpecify the type of the trait to be patched.stringtrue
propertiesSpecify the properties to override.map[string]:(null|bool|string|bytes|{…}|[…]|number)false
disableSpecify if the trait should be remove, default false.boolfalsefalse

Topology

Description

Describe the destination where components should be deployed to.

Examples (topology)

  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4.   name: basic-topology
  5.   namespace: examples
  6. spec:
  7.   components:
  8.     - name: nginx-basic
  9.       type: webservice
  10.       properties:
  11.         image: nginx
  12.   policies:
  13.     - name: topology-hangzhou-clusters
  14.       type: topology
  15.       properties:
  16.         clusters: ["hangzhou-1", "hangzhou-2"]
  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4.   name: label-selector-topology
  5.   namespace: examples
  6. spec:
  7.   components:
  8.     - name: nginx-label-selector
  9.       type: webservice
  10.       properties:
  11.         image: nginx
  12.   policies:
  13.     - name: topology-hangzhou-clusters
  14.       type: topology
  15.       properties:
  16.         clusterLabelSelector:
  17.           region: hangzhou
  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4.   name: local-ns-topology
  5.   namespace: examples
  6. spec:
  7.   components:
  8.     - name: nginx-local-ns
  9.       type: webservice
  10.       properties:
  11.         image: nginx
  12.   policies:
  13.     - name: topology-local
  14.       type: topology
  15.       properties:
  16.         clusters: ["local"]
  17.         namespace: examples-alternative

Specification (topology)

NameDescriptionTypeRequiredDefault
clusterSpecify the names of the clusters to select.[]stringfalse
clusterLabelSelectorSpecify the label selector for clusters.map[string]:stringfalse
clusterSelectorDeprecated: Use clusterLabelSelector instead.map[string]:stringfalse
namespaceSpecify the target namespace to deploy in the selected clusters, default inherit the original namespace.stringfalse