Version: v1.8

Built-in Component Type

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

It was generated automatically by scripts, please don’t update manually, last updated at 2023-01-16T19:19:03+08:00.

Describes cron jobs that run code or a script to completion.

  • cronjobs.batch
  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4. name: cron-worker
  5. spec:
  6. components:
  7. - name: mytask
  8. type: cron-task
  9. properties:
  10. image: perl
  11. count: 10
  12. cmd: ["perl", "-Mbignum=bpi", "-wle", "print bpi(2000)"]
  13. schedule: "*/1 * * * *"
NameDescriptionTypeRequiredDefault
labelsSpecify the labels in the workload.map[string]stringfalse
annotationsSpecify the annotations in the workload.map[string]stringfalse
scheduleSpecify the schedule in Cron format, see https://en.wikipedia.org/wiki/Cron.stringtrue
startingDeadlineSecondsSpecify deadline in seconds for starting the job if it misses scheduled.intfalse
suspendSuspend subsequent executions.boolfalsefalse
concurrencyPolicySpecifies how to treat concurrent executions of a Job.“Allow” or “Forbid” or “Replace”falseAllow
successfulJobsHistoryLimitThe number of successful finished jobs to retain.intfalse3
failedJobsHistoryLimitThe number of failed finished jobs to retain.intfalse1
countSpecify number of tasks to run in parallel.intfalse1
imageWhich image would you like to use for your service.stringtrue
imagePullPolicySpecify image pull policy for your service.“Always” or “Never” or “IfNotPresent”false
imagePullSecretsSpecify image pull secrets for your service.[]stringfalse
restartDefine the job restart policy, the value can only be Never or OnFailure. By default, it’s Never.stringfalseNever
cmdCommands to run in the container.[]stringfalse
envDefine arguments by using environment variables.[]envfalse
cpuNumber of CPU units for the service, like 0.5 (0.5 CPU core), 1 (1 CPU core).stringfalse
memorySpecifies the attributes of the memory resource required for the container.stringfalse
volumesDeclare volumes and volumeMounts.[]volumesfalse
hostAliasesAn optional list of hosts and IPs that will be injected into the pod’s hosts file.[]hostAliasesfalse
ttlSecondsAfterFinishedLimits the lifetime of a Job that has finished.intfalse
activeDeadlineSecondsThe duration in seconds relative to the startTime that the job may be continuously active before the system tries to terminate it.intfalse
backoffLimitThe number of retries before marking this job failed.intfalse6
livenessProbeInstructions for assessing whether the container is alive.livenessProbefalse
readinessProbeInstructions for assessing whether the container is in a suitable state to serve traffic.readinessProbefalse
NameDescriptionTypeRequiredDefault
nameEnvironment variable name.stringtrue
valueThe value of the environment variable.stringfalse
valueFromSpecifies a source the value of this var should come from.valueFromfalse
NameDescriptionTypeRequiredDefault
secretKeyRefSelects a key of a secret in the pod’s namespace.secretKeyReffalse
configMapKeyRefSelects a key of a config map in the pod’s namespace.configMapKeyReffalse
NameDescriptionTypeRequiredDefault
nameThe name of the secret in the pod’s namespace to select from.stringtrue
keyThe key of the secret to select from. Must be a valid secret key.stringtrue
NameDescriptionTypeRequiredDefault
nameThe name of the config map in the pod’s namespace to select from.stringtrue
keyThe key of the config map to select from. Must be a valid secret key.stringtrue
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
medium“” or “Memory”falseempty
typeSpecify volume type, options: “pvc”,”configMap”,”secret”,”emptyDir”, default to emptyDir.“emptyDir” or “pvc” or “configMap” or “secret”falseemptyDir
NameDescriptionTypeRequiredDefault
ipstringtrue
hostnames[]stringtrue
NameDescriptionTypeRequiredDefault
execInstructions for assessing container health by executing a command. Either this attribute or the httpGet attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the httpGet attribute and the tcpSocket attribute.execfalse
httpGetInstructions for assessing container health by executing an HTTP GET request. Either this attribute or the exec attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the tcpSocket attribute.httpGetfalse
tcpSocketInstructions for assessing container health by probing a TCP socket. Either this attribute or the exec attribute or the httpGet attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the httpGet attribute.tcpSocketfalse
initialDelaySecondsNumber of seconds after the container is started before the first probe is initiated.intfalse0
periodSecondsHow often, in seconds, to execute the probe.intfalse10
timeoutSecondsNumber of seconds after which the probe times out.intfalse1
successThresholdMinimum consecutive successes for the probe to be considered successful after having failed.intfalse1
failureThresholdNumber of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).intfalse3
NameDescriptionTypeRequiredDefault
commandA command to be executed inside the container to assess its health. Each space delimited token of the command is a separate array element. Commands exiting 0 are considered to be successful probes, whilst all other exit codes are considered failures.[]stringtrue
NameDescriptionTypeRequiredDefault
pathThe endpoint, relative to the port, to which the HTTP GET request should be directed.stringtrue
portThe TCP socket within the container to which the HTTP GET request should be directed.inttrue
httpHeaders[]httpHeadersfalse
NameDescriptionTypeRequiredDefault
namestringtrue
valuestringtrue
NameDescriptionTypeRequiredDefault
portThe TCP socket within the container that should be probed to assess container health.inttrue
NameDescriptionTypeRequiredDefault
execInstructions for assessing container health by executing a command. Either this attribute or the httpGet attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the httpGet attribute and the tcpSocket attribute.execfalse
httpGetInstructions for assessing container health by executing an HTTP GET request. Either this attribute or the exec attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the tcpSocket attribute.httpGetfalse
tcpSocketInstructions for assessing container health by probing a TCP socket. Either this attribute or the exec attribute or the httpGet attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the httpGet attribute.tcpSocketfalse
initialDelaySecondsNumber of seconds after the container is started before the first probe is initiated.intfalse0
periodSecondsHow often, in seconds, to execute the probe.intfalse10
timeoutSecondsNumber of seconds after which the probe times out.intfalse1
successThresholdMinimum consecutive successes for the probe to be considered successful after having failed.intfalse1
failureThresholdNumber of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).intfalse3
NameDescriptionTypeRequiredDefault
commandA command to be executed inside the container to assess its health. Each space delimited token of the command is a separate array element. Commands exiting 0 are considered to be successful probes, whilst all other exit codes are considered failures.[]stringtrue
NameDescriptionTypeRequiredDefault
pathThe endpoint, relative to the port, to which the HTTP GET request should be directed.stringtrue
portThe TCP socket within the container to which the HTTP GET request should be directed.inttrue
httpHeaders[]httpHeadersfalse
NameDescriptionTypeRequiredDefault
namestringtrue
valuestringtrue
NameDescriptionTypeRequiredDefault
portThe TCP socket within the container that should be probed to assess container health.inttrue

Describes daemonset services in Kubernetes.

  • daemonsets.apps
  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4. name: addon-node-exporter
  5. namespace: vela-system
  6. spec:
  7. components:
  8. - name: node-exporter
  9. type: daemon
  10. properties:
  11. image: prom/node-exporter
  12. imagePullPolicy: IfNotPresent
  13. volumeMounts:
  14. hostPath:
  15. - mountPath: /host/sys
  16. mountPropagation: HostToContainer
  17. name: sys
  18. path: /sys
  19. readOnly: true
  20. - mountPath: /host/root
  21. mountPropagation: HostToContainer
  22. name: root
  23. path: /
  24. readOnly: true
  25. traits:
  26. - properties:
  27. args:
  28. - --path.sysfs=/host/sys
  29. - --path.rootfs=/host/root
  30. - --no-collector.wifi
  31. - --no-collector.hwmon
  32. - --collector.filesystem.ignored-mount-points=^/(dev|proc|sys|var/lib/docker/.+|var/lib/kubelet/pods/.+)($|/)
  33. - --collector.netclass.ignored-devices=^(veth.*)$
  34. type: command
  35. - properties:
  36. annotations:
  37. prometheus.io/path: /metrics
  38. prometheus.io/port: "8080"
  39. prometheus.io/scrape: "true"
  40. port:
  41. - 9100
  42. type: expose
  43. - properties:
  44. cpu: 0.1
  45. memory: 250Mi
  46. type: resource
NameDescriptionTypeRequiredDefault
labelsSpecify the labels in the workload.map[string]stringfalse
annotationsSpecify the annotations in the workload.map[string]stringfalse
imageWhich image would you like to use for your service.stringtrue
imagePullPolicySpecify image pull policy for your service.“Always” or “Never” or “IfNotPresent”false
imagePullSecretsSpecify image pull secrets for your service.[]stringfalse
portsWhich ports do you want customer traffic sent to, defaults to 80.[]portsfalse
cmdCommands to run in the container.[]stringfalse
envDefine arguments by using environment variables.[]envfalse
cpuNumber of CPU units for the service, like 0.5 (0.5 CPU core), 1 (1 CPU core).stringfalse
memorySpecifies the attributes of the memory resource required for the container.stringfalse
volumeMountsvolumeMountsfalse
volumesDeprecated field, use volumeMounts instead.[]volumesfalse
livenessProbeInstructions for assessing whether the container is alive.livenessProbefalse
readinessProbeInstructions for assessing whether the container is in a suitable state to serve traffic.readinessProbefalse
hostAliasesSpecify the hostAliases to add.[]hostAliasesfalse
NameDescriptionTypeRequiredDefault
portNumber of port to expose on the pod’s IP address.inttrue
nameName of the port.stringfalse
protocolProtocol for port. Must be UDP, TCP, or SCTP.“TCP” or “UDP” or “SCTP”falseTCP
exposeSpecify if the port should be exposed.boolfalsefalse
NameDescriptionTypeRequiredDefault
nameEnvironment variable name.stringtrue
valueThe value of the environment variable.stringfalse
valueFromSpecifies a source the value of this var should come from.valueFromfalse
NameDescriptionTypeRequiredDefault
secretKeyRefSelects a key of a secret in the pod’s namespace.secretKeyReffalse
configMapKeyRefSelects a key of a config map in the pod’s namespace.configMapKeyReffalse
NameDescriptionTypeRequiredDefault
nameThe name of the secret in the pod’s namespace to select from.stringtrue
keyThe key of the secret to select from. Must be a valid secret key.stringtrue
NameDescriptionTypeRequiredDefault
nameThe name of the config map in the pod’s namespace to select from.stringtrue
keyThe key of the config map to select from. Must be a valid secret key.stringtrue
NameDescriptionTypeRequiredDefault
pvcMount PVC type volume.[]pvcfalse
configMapMount ConfigMap type volume.[]configMapfalse
secretMount Secret type volume.[]secretfalse
emptyDirMount EmptyDir type volume.[]emptyDirfalse
hostPathMount HostPath type volume.[]hostPathfalse
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
claimNameThe name of the PVC.stringtrue
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
defaultModeintfalse420
cmNamestringtrue
items[]itemsfalse
NameDescriptionTypeRequiredDefault
keystringtrue
pathstringtrue
modeintfalse511
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
defaultModeintfalse420
secretNamestringtrue
items[]itemsfalse
NameDescriptionTypeRequiredDefault
keystringtrue
pathstringtrue
modeintfalse511
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
medium“” or “Memory”falseempty
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
mountPropagation“None” or “HostToContainer” or “Bidirectional”false
pathstringtrue
readOnlyboolfalse
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
medium“” or “Memory”falseempty
typeSpecify volume type, options: “pvc”,”configMap”,”secret”,”emptyDir”, default to emptyDir.“emptyDir” or “pvc” or “configMap” or “secret”falseemptyDir
NameDescriptionTypeRequiredDefault
execInstructions for assessing container health by executing a command. Either this attribute or the httpGet attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the httpGet attribute and the tcpSocket attribute.execfalse
httpGetInstructions for assessing container health by executing an HTTP GET request. Either this attribute or the exec attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the tcpSocket attribute.httpGetfalse
tcpSocketInstructions for assessing container health by probing a TCP socket. Either this attribute or the exec attribute or the httpGet attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the httpGet attribute.tcpSocketfalse
initialDelaySecondsNumber of seconds after the container is started before the first probe is initiated.intfalse0
periodSecondsHow often, in seconds, to execute the probe.intfalse10
timeoutSecondsNumber of seconds after which the probe times out.intfalse1
successThresholdMinimum consecutive successes for the probe to be considered successful after having failed.intfalse1
failureThresholdNumber of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).intfalse3
NameDescriptionTypeRequiredDefault
commandA command to be executed inside the container to assess its health. Each space delimited token of the command is a separate array element. Commands exiting 0 are considered to be successful probes, whilst all other exit codes are considered failures.[]stringtrue
NameDescriptionTypeRequiredDefault
pathThe endpoint, relative to the port, to which the HTTP GET request should be directed.stringtrue
portThe TCP socket within the container to which the HTTP GET request should be directed.inttrue
hoststringfalse
schemestringfalseHTTP
httpHeaders[]httpHeadersfalse
NameDescriptionTypeRequiredDefault
namestringtrue
valuestringtrue
NameDescriptionTypeRequiredDefault
portThe TCP socket within the container that should be probed to assess container health.inttrue
NameDescriptionTypeRequiredDefault
execInstructions for assessing container health by executing a command. Either this attribute or the httpGet attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the httpGet attribute and the tcpSocket attribute.execfalse
httpGetInstructions for assessing container health by executing an HTTP GET request. Either this attribute or the exec attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the tcpSocket attribute.httpGetfalse
tcpSocketInstructions for assessing container health by probing a TCP socket. Either this attribute or the exec attribute or the httpGet attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the httpGet attribute.tcpSocketfalse
initialDelaySecondsNumber of seconds after the container is started before the first probe is initiated.intfalse0
periodSecondsHow often, in seconds, to execute the probe.intfalse10
timeoutSecondsNumber of seconds after which the probe times out.intfalse1
successThresholdMinimum consecutive successes for the probe to be considered successful after having failed.intfalse1
failureThresholdNumber of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).intfalse3
NameDescriptionTypeRequiredDefault
commandA command to be executed inside the container to assess its health. Each space delimited token of the command is a separate array element. Commands exiting 0 are considered to be successful probes, whilst all other exit codes are considered failures.[]stringtrue
NameDescriptionTypeRequiredDefault
pathThe endpoint, relative to the port, to which the HTTP GET request should be directed.stringtrue
portThe TCP socket within the container to which the HTTP GET request should be directed.inttrue
hoststringfalse
schemestringfalseHTTP
httpHeaders[]httpHeadersfalse
NameDescriptionTypeRequiredDefault
namestringtrue
valuestringtrue
NameDescriptionTypeRequiredDefault
portThe TCP socket within the container that should be probed to assess container health.inttrue
NameDescriptionTypeRequiredDefault
ipstringtrue
hostnames[]stringtrue

K8s-objects allow users to specify raw K8s objects in properties.

  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4. name: app-raw
  5. spec:
  6. components:
  7. - name: myjob
  8. type: k8s-objects
  9. properties:
  10. objects:
  11. - apiVersion: batch/v1
  12. kind: Job
  13. metadata:
  14. name: pi
  15. spec:
  16. template:
  17. spec:
  18. containers:
  19. - name: pi
  20. image: perl
  21. command: ["perl", "-Mbignum=bpi", "-wle", "print bpi(2000)"]
  22. restartPolicy: Never
  23. backoffLimit: 4
NAMEDESCRIPTIONTYPEREQUIREDDEFAULT
objectsA slice of Kubernetes resource manifests[]Kubernetes-Objectstrue

Describes jobs that run code or a script to completion.

  • jobs.batch
  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4. name: app-worker
  5. spec:
  6. components:
  7. - name: mytask
  8. type: task
  9. properties:
  10. image: perl
  11. count: 10
  12. cmd: ["perl", "-Mbignum=bpi", "-wle", "print bpi(2000)"]
NameDescriptionTypeRequiredDefault
labelsSpecify the labels in the workload.map[string]stringfalse
annotationsSpecify the annotations in the workload.map[string]stringfalse
countSpecify number of tasks to run in parallel.intfalse1
imageWhich image would you like to use for your service.stringtrue
imagePullPolicySpecify image pull policy for your service.“Always” or “Never” or “IfNotPresent”false
imagePullSecretsSpecify image pull secrets for your service.[]stringfalse
restartDefine the job restart policy, the value can only be Never or OnFailure. By default, it’s Never.stringfalseNever
cmdCommands to run in the container.[]stringfalse
envDefine arguments by using environment variables.[]envfalse
cpuNumber of CPU units for the service, like 0.5 (0.5 CPU core), 1 (1 CPU core).stringfalse
memorySpecifies the attributes of the memory resource required for the container.stringfalse
volumesDeclare volumes and volumeMounts.[]volumesfalse
livenessProbeInstructions for assessing whether the container is alive.livenessProbefalse
readinessProbeInstructions for assessing whether the container is in a suitable state to serve traffic.readinessProbefalse
NameDescriptionTypeRequiredDefault
nameEnvironment variable name.stringtrue
valueThe value of the environment variable.stringfalse
valueFromSpecifies a source the value of this var should come from.valueFromfalse
NameDescriptionTypeRequiredDefault
secretKeyRefSelects a key of a secret in the pod’s namespace.secretKeyReffalse
configMapKeyRefSelects a key of a config map in the pod’s namespace.configMapKeyReffalse
NameDescriptionTypeRequiredDefault
nameThe name of the secret in the pod’s namespace to select from.stringtrue
keyThe key of the secret to select from. Must be a valid secret key.stringtrue
NameDescriptionTypeRequiredDefault
nameThe name of the config map in the pod’s namespace to select from.stringtrue
keyThe key of the config map to select from. Must be a valid secret key.stringtrue
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
medium“” or “Memory”falseempty
typeSpecify volume type, options: “pvc”,”configMap”,”secret”,”emptyDir”, default to emptyDir.“emptyDir” or “pvc” or “configMap” or “secret”falseemptyDir
NameDescriptionTypeRequiredDefault
execInstructions for assessing container health by executing a command. Either this attribute or the httpGet attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the httpGet attribute and the tcpSocket attribute.execfalse
httpGetInstructions for assessing container health by executing an HTTP GET request. Either this attribute or the exec attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the tcpSocket attribute.httpGetfalse
tcpSocketInstructions for assessing container health by probing a TCP socket. Either this attribute or the exec attribute or the httpGet attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the httpGet attribute.tcpSocketfalse
initialDelaySecondsNumber of seconds after the container is started before the first probe is initiated.intfalse0
periodSecondsHow often, in seconds, to execute the probe.intfalse10
timeoutSecondsNumber of seconds after which the probe times out.intfalse1
successThresholdMinimum consecutive successes for the probe to be considered successful after having failed.intfalse1
failureThresholdNumber of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).intfalse3
NameDescriptionTypeRequiredDefault
commandA command to be executed inside the container to assess its health. Each space delimited token of the command is a separate array element. Commands exiting 0 are considered to be successful probes, whilst all other exit codes are considered failures.[]stringtrue
NameDescriptionTypeRequiredDefault
pathThe endpoint, relative to the port, to which the HTTP GET request should be directed.stringtrue
portThe TCP socket within the container to which the HTTP GET request should be directed.inttrue
httpHeaders[]httpHeadersfalse
NameDescriptionTypeRequiredDefault
namestringtrue
valuestringtrue
NameDescriptionTypeRequiredDefault
portThe TCP socket within the container that should be probed to assess container health.inttrue
NameDescriptionTypeRequiredDefault
execInstructions for assessing container health by executing a command. Either this attribute or the httpGet attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the httpGet attribute and the tcpSocket attribute.execfalse
httpGetInstructions for assessing container health by executing an HTTP GET request. Either this attribute or the exec attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the tcpSocket attribute.httpGetfalse
tcpSocketInstructions for assessing container health by probing a TCP socket. Either this attribute or the exec attribute or the httpGet attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the httpGet attribute.tcpSocketfalse
initialDelaySecondsNumber of seconds after the container is started before the first probe is initiated.intfalse0
periodSecondsHow often, in seconds, to execute the probe.intfalse10
timeoutSecondsNumber of seconds after which the probe times out.intfalse1
successThresholdMinimum consecutive successes for the probe to be considered successful after having failed.intfalse1
failureThresholdNumber of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).intfalse3
NameDescriptionTypeRequiredDefault
commandA command to be executed inside the container to assess its health. Each space delimited token of the command is a separate array element. Commands exiting 0 are considered to be successful probes, whilst all other exit codes are considered failures.[]stringtrue
NameDescriptionTypeRequiredDefault
pathThe endpoint, relative to the port, to which the HTTP GET request should be directed.stringtrue
portThe TCP socket within the container to which the HTTP GET request should be directed.inttrue
httpHeaders[]httpHeadersfalse
NameDescriptionTypeRequiredDefault
namestringtrue
valuestringtrue
NameDescriptionTypeRequiredDefault
portThe TCP socket within the container that should be probed to assess container health.inttrue

Describes long-running, scalable, containerized services that have a stable network endpoint to receive external network traffic from customers.

  • deployments.apps
  1. apiVersion: core.oam.dev/v1beta1
  2. kind: Application
  3. metadata:
  4. name: website
  5. spec:
  6. components:
  7. - name: frontend
  8. type: webservice
  9. properties:
  10. image: oamdev/testapp:v1
  11. cmd: ["node", "server.js"]
  12. ports:
  13. - port: 8080
  14. expose: true
  15. cpu: "0.1"
  16. env:
  17. - name: FOO
  18. value: bar
  19. - name: FOO
  20. valueFrom:
  21. secretKeyRef:
  22. name: bar
  23. key: bar
NameDescriptionTypeRequiredDefault
labelsSpecify the labels in the workload.map[string]stringfalse
annotationsSpecify the annotations in the workload.map[string]stringfalse
imageWhich image would you like to use for your service.stringtrue
imagePullPolicySpecify image pull policy for your service.“Always” or “Never” or “IfNotPresent”false
imagePullSecretsSpecify image pull secrets for your service.[]stringfalse
portsWhich ports do you want customer traffic sent to, defaults to 80.[]portsfalse
cmdCommands to run in the container.[]stringfalse
argsArguments to the entrypoint.[]stringfalse
envDefine arguments by using environment variables.[]envfalse
cpuNumber of CPU units for the service, like 0.5 (0.5 CPU core), 1 (1 CPU core).stringfalse
memorySpecifies the attributes of the memory resource required for the container.stringfalse
volumeMountsvolumeMountsfalse
volumesDeprecated field, use volumeMounts instead.[]volumesfalse
livenessProbeInstructions for assessing whether the container is alive.livenessProbefalse
readinessProbeInstructions for assessing whether the container is in a suitable state to serve traffic.readinessProbefalse
hostAliasesSpecify the hostAliases to add.[]hostAliasesfalse
NameDescriptionTypeRequiredDefault
portNumber of port to expose on the pod’s IP address.inttrue
nameName of the port.stringfalse
protocolProtocol for port. Must be UDP, TCP, or SCTP.“TCP” or “UDP” or “SCTP”falseTCP
exposeSpecify if the port should be exposed.boolfalsefalse
nodePortexposed node port. Only Valid when exposeType is NodePort.intfalse
NameDescriptionTypeRequiredDefault
nameEnvironment variable name.stringtrue
valueThe value of the environment variable.stringfalse
valueFromSpecifies a source the value of this var should come from.valueFromfalse
NameDescriptionTypeRequiredDefault
secretKeyRefSelects a key of a secret in the pod’s namespace.secretKeyReffalse
configMapKeyRefSelects a key of a config map in the pod’s namespace.configMapKeyReffalse
NameDescriptionTypeRequiredDefault
nameThe name of the secret in the pod’s namespace to select from.stringtrue
keyThe key of the secret to select from. Must be a valid secret key.stringtrue
NameDescriptionTypeRequiredDefault
nameThe name of the config map in the pod’s namespace to select from.stringtrue
keyThe key of the config map to select from. Must be a valid secret key.stringtrue
NameDescriptionTypeRequiredDefault
pvcMount PVC type volume.[]pvcfalse
configMapMount ConfigMap type volume.[]configMapfalse
secretMount Secret type volume.[]secretfalse
emptyDirMount EmptyDir type volume.[]emptyDirfalse
hostPathMount HostPath type volume.[]hostPathfalse
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
subPathstringfalse
claimNameThe name of the PVC.stringtrue
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
subPathstringfalse
defaultModeintfalse420
cmNamestringtrue
items[]itemsfalse
NameDescriptionTypeRequiredDefault
keystringtrue
pathstringtrue
modeintfalse511
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
subPathstringfalse
defaultModeintfalse420
secretNamestringtrue
items[]itemsfalse
NameDescriptionTypeRequiredDefault
keystringtrue
pathstringtrue
modeintfalse511
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
subPathstringfalse
medium“” or “Memory”falseempty
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
subPathstringfalse
pathstringtrue
NameDescriptionTypeRequiredDefault
namestringtrue
mountPathstringtrue
medium“” or “Memory”falseempty
typeSpecify volume type, options: “pvc”,”configMap”,”secret”,”emptyDir”, default to emptyDir.“emptyDir” or “pvc” or “configMap” or “secret”falseemptyDir
NameDescriptionTypeRequiredDefault
execInstructions for assessing container health by executing a command. Either this attribute or the httpGet attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the httpGet attribute and the tcpSocket attribute.execfalse
httpGetInstructions for assessing container health by executing an HTTP GET request. Either this attribute or the exec attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the tcpSocket attribute.httpGetfalse
tcpSocketInstructions for assessing container health by probing a TCP socket. Either this attribute or the exec attribute or the httpGet attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the httpGet attribute.tcpSocketfalse
initialDelaySecondsNumber of seconds after the container is started before the first probe is initiated.intfalse0
periodSecondsHow often, in seconds, to execute the probe.intfalse10
timeoutSecondsNumber of seconds after which the probe times out.intfalse1
successThresholdMinimum consecutive successes for the probe to be considered successful after having failed.intfalse1
failureThresholdNumber of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).intfalse3
NameDescriptionTypeRequiredDefault
commandA command to be executed inside the container to assess its health. Each space delimited token of the command is a separate array element. Commands exiting 0 are considered to be successful probes, whilst all other exit codes are considered failures.[]stringtrue
NameDescriptionTypeRequiredDefault
pathThe endpoint, relative to the port, to which the HTTP GET request should be directed.stringtrue
portThe TCP socket within the container to which the HTTP GET request should be directed.inttrue
hoststringfalse
schemestringfalseHTTP
httpHeaders[]httpHeadersfalse
NameDescriptionTypeRequiredDefault
namestringtrue
valuestringtrue
NameDescriptionTypeRequiredDefault
portThe TCP socket within the container that should be probed to assess container health.inttrue
NameDescriptionTypeRequiredDefault
execInstructions for assessing container health by executing a command. Either this attribute or the httpGet attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the httpGet attribute and the tcpSocket attribute.execfalse
httpGetInstructions for assessing container health by executing an HTTP GET request. Either this attribute or the exec attribute or the tcpSocket attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the tcpSocket attribute.httpGetfalse
tcpSocketInstructions for assessing container health by probing a TCP socket. Either this attribute or the exec attribute or the httpGet attribute MUST be specified. This attribute is mutually exclusive with both the exec attribute and the httpGet attribute.tcpSocketfalse
initialDelaySecondsNumber of seconds after the container is started before the first probe is initiated.intfalse0
periodSecondsHow often, in seconds, to execute the probe.intfalse10
timeoutSecondsNumber of seconds after which the probe times out.intfalse1
successThresholdMinimum consecutive successes for the probe to be considered successful after having failed.intfalse1
failureThresholdNumber of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).intfalse3
NameDescriptionTypeRequiredDefault
commandA command to be executed inside the container to assess its health. Each space delimited token of the command is a separate array element. Commands exiting 0 are considered to be successful probes, whilst all other exit codes are considered failures.[]stringtrue
NameDescriptionTypeRequiredDefault
pathThe endpoint, relative to the port, to which the HTTP GET request should be directed.stringtrue
portThe TCP socket within the container to which the HTTP GET request should be directed.inttrue
hoststringfalse
schemestringfalseHTTP
httpHeaders[]httpHeadersfalse
NameDescriptionTypeRequiredDefault
namestringtrue
valuestringtrue
NameDescriptionTypeRequiredDefault
portThe TCP socket within the container that should be probed to assess container health.inttrue
NameDescriptionTypeRequiredDefault
ipstringtrue
hostnames[]stringtrue

Last updated on May 6, 2023 by Tianxin Dong