Built-in Components 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 2026-04-16T11:50:12+01:00.

Cron-Task

Description

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

Examples (cron-task)

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: cron-worker
spec:
  components:
    - name: mytask
      type: cron-task
      properties:
        image: perl
        count: 10
        cmd: ["perl",  "-Mbignum=bpi", "-wle", "print bpi(2000)"]
        schedule: "*/1 * * * *"

Specification (cron-task)

Name	Description	Type	Required	Default	Immutable
labels	Specify the labels in the workload.	map[string]string	false
annotations	Specify the annotations in the workload.	map[string]string	false
schedule	Specify the schedule in Cron format, see https://en.wikipedia.org/wiki/Cron.	string	true
startingDeadlineSeconds	Specify deadline in seconds for starting the job if it misses scheduled.	int	false
suspend	suspend subsequent executions.	bool	false	false
concurrencyPolicy	Specifies how to treat concurrent executions of a Job.	"Allow" or "Forbid" or "Replace"	false	Allow
successfulJobsHistoryLimit	The number of successful finished jobs to retain.	int	false	3
failedJobsHistoryLimit	The number of failed finished jobs to retain.	int	false	1
count	Specify number of tasks to run in parallel.	int	false	1
image	Which image would you like to use for your service.	string	true
imagePullPolicy	Specify image pull policy for your service.	"Always" or "Never" or "IfNotPresent"	false
imagePullSecrets	Specify image pull secrets for your service.	[]string	false
restart	Define the job restart policy, the value can only be Never or OnFailure. By default, it's Never.	string	false	Never
cmd	Commands to run in the container.	[]string	false
env	Define arguments by using environment variables.	[]env	false
cpu	Number of CPU units for the service, like 0.5 (0.5 CPU core), 1 (1 CPU core).	string	false
memory	Specifies the attributes of the memory resource required for the container.	string	false
volumeMounts		volumeMounts	false
volumes	Deprecated field, use volumeMounts instead.	[]volumes	false
hostAliases	An optional list of hosts and IPs that will be injected into the pod's hosts file.	[]hostAliases	false
ttlSecondsAfterFinished	Limits the lifetime of a Job that has finished.	int	false
activeDeadlineSeconds	The duration in seconds relative to the startTime that the job may be continuously active before the system tries to terminate it.	int	false
backoffLimit	The number of retries before marking this job failed.	int	false	6
livenessProbe	Instructions for assessing whether the container is alive.	livenessProbe	false
readinessProbe	Instructions for assessing whether the container is in a suitable state to serve traffic.	readinessProbe	false

env (cron-task)

Name	Description	Type	Required	Default	Immutable
name	Environment variable name.	string	true
value	The value of the environment variable.	string	false
valueFrom	Specifies a source the value of this var should come from.	valueFrom	false

valueFrom (cron-task)

Name	Description	Type	Required	Default	Immutable
secretKeyRef	Selects a key of a secret in the pod's namespace.	secretKeyRef	false
configMapKeyRef	Selects a key of a config map in the pod's namespace.	configMapKeyRef	false

secretKeyRef (cron-task)

Name	Description	Type	Required	Default	Immutable
name	The name of the secret in the pod's namespace to select from.	string	true
key	The key of the secret to select from. Must be a valid secret key.	string	true

configMapKeyRef (cron-task)

Name	Description	Type	Required	Default	Immutable
name	The name of the config map in the pod's namespace to select from.	string	true
key	The key of the config map to select from. Must be a valid secret key.	string	true

volumeMounts (cron-task)

Name	Description	Type	Required	Default	Immutable
pvc	Mount PVC type volume.	[]pvc	false
configMap	Mount ConfigMap type volume.	[]configMap	false
secret	Mount Secret type volume.	[]secret	false
emptyDir	Mount EmptyDir type volume.	[]emptyDir	false
hostPath	Mount HostPath type volume.	[]hostPath	false

pvc (cron-task)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
claimName	The name of the PVC.	string	true

configMap (cron-task)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
defaultMode		int	false	420
cmName		string	true
items		[]items	false

items (cron-task)

Name	Description	Type	Required	Default	Immutable
key		string	true
path		string	true
mode		int	false	511

secret (cron-task)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
defaultMode		int	false	420
secretName		string	true
items		[]items	false

items (cron-task)

Name	Description	Type	Required	Default	Immutable
key		string	true
path		string	true
mode		int	false	511

emptyDir (cron-task)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
medium		"" or "Memory"	false	empty

hostPath (cron-task)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
path		string	true

volumes (cron-task)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
type	Specify volume type, options: "pvc","configMap","secret","emptyDir", default to emptyDir.	"emptyDir" or "pvc" or "configMap" or "secret"	false	emptyDir
medium		"" or "Memory"	false	empty

hostAliases (cron-task)

Name	Description	Type	Required	Default	Immutable
ip		string	true
hostnames		[]string	true

livenessProbe (cron-task)

Name	Description	Type	Required	Default	Immutable
exec	Instructions 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.	exec	false
httpGet	Instructions 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.	httpGet	false
tcpSocket	Instructions 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.	tcpSocket	false
initialDelaySeconds	Number of seconds after the container is started before the first probe is initiated.	int	false	0
periodSeconds	How often, in seconds, to execute the probe.	int	false	10
timeoutSeconds	Number of seconds after which the probe times out.	int	false	1
successThreshold	Minimum consecutive successes for the probe to be considered successful after having failed.	int	false	1
failureThreshold	Number of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).	int	false	3

exec (cron-task)

Name	Description	Type	Required	Default	Immutable
command	A 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.	[]string	true

httpGet (cron-task)

Name	Description	Type	Required	Default	Immutable
path	The endpoint, relative to the port, to which the HTTP GET request should be directed.	string	true
port	The TCP socket within the container to which the HTTP GET request should be directed.	int	true
httpHeaders		[]httpHeaders	false

httpHeaders (cron-task)

Name	Description	Type	Required	Default	Immutable
name		string	true
value		string	true

tcpSocket (cron-task)

Name	Description	Type	Required	Default	Immutable
port	The TCP socket within the container that should be probed to assess container health.	int	true

readinessProbe (cron-task)

Name	Description	Type	Required	Default	Immutable
exec	Instructions 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.	exec	false
httpGet	Instructions 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.	httpGet	false
tcpSocket	Instructions 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.	tcpSocket	false
initialDelaySeconds	Number of seconds after the container is started before the first probe is initiated.	int	false	0
periodSeconds	How often, in seconds, to execute the probe.	int	false	10
timeoutSeconds	Number of seconds after which the probe times out.	int	false	1
successThreshold	Minimum consecutive successes for the probe to be considered successful after having failed.	int	false	1
failureThreshold	Number of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).	int	false	3

exec (cron-task)

Name	Description	Type	Required	Default	Immutable
command	A 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.	[]string	true

httpGet (cron-task)

Name	Description	Type	Required	Default	Immutable
path	The endpoint, relative to the port, to which the HTTP GET request should be directed.	string	true
port	The TCP socket within the container to which the HTTP GET request should be directed.	int	true
httpHeaders		[]httpHeaders	false

httpHeaders (cron-task)

Name	Description	Type	Required	Default	Immutable
name		string	true
value		string	true

tcpSocket (cron-task)

Name	Description	Type	Required	Default	Immutable
port	The TCP socket within the container that should be probed to assess container health.	int	true

Daemon

Description

Describes daemonset services in Kubernetes.

Underlying Kubernetes Resources (daemon)

• daemonsets.apps

Examples (daemon)

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: addon-node-exporter
  namespace: vela-system
spec:
  components:
  - name: node-exporter
    type: daemon    
    properties:
      image: prom/node-exporter
      imagePullPolicy: IfNotPresent
      volumeMounts:
        hostPath:
        - mountPath: /host/sys
          mountPropagation: HostToContainer
          name: sys
          path: /sys
          readOnly: true
        - mountPath: /host/root
          mountPropagation: HostToContainer
          name: root
          path: /
          readOnly: true
    traits:
    - properties:
        args:
        - --path.sysfs=/host/sys
        - --path.rootfs=/host/root
        - --no-collector.wifi
        - --no-collector.hwmon
        - --collector.filesystem.ignored-mount-points=^/(dev|proc|sys|var/lib/docker/.+|var/lib/kubelet/pods/.+)($|/)
        - --collector.netclass.ignored-devices=^(veth.*)$
      type: command
    - properties:
        annotations:
          prometheus.io/path: /metrics
          prometheus.io/port: "8080"
          prometheus.io/scrape: "true"
        port:
        - 9100
      type: expose
    - properties:
        cpu: 0.1
        memory: 250Mi
      type: resource

Specification (daemon)

Name	Description	Type	Required	Default	Immutable
labels	Specify the labels in the workload.	map[string]string	false
annotations	Specify the annotations in the workload.	map[string]string	false
image	Which image would you like to use for your service.	string	true
imagePullPolicy	Specify image pull policy for your service.	"Always" or "Never" or "IfNotPresent"	false
imagePullSecrets	Specify image pull secrets for your service.	[]string	false
ports	Which ports do you want customer traffic sent to, defaults to 80.	[]ports	false
cmd	Commands to run in the container.	[]string	false
env	Define arguments by using environment variables.	[]env	false
cpu	Number of CPU units for the service, like 0.5 (0.5 CPU core), 1 (1 CPU core).	string	false
memory	Specifies the attributes of the memory resource required for the container.	string	false
volumeMounts		volumeMounts	false
volumes	Deprecated field, use volumeMounts instead.	[]volumes	false
livenessProbe	Instructions for assessing whether the container is alive.	livenessProbe	false
readinessProbe	Instructions for assessing whether the container is in a suitable state to serve traffic.	readinessProbe	false
hostAliases	Specify the hostAliases to add.	[]hostAliases	false

ports (daemon)

Name	Description	Type	Required	Default	Immutable
port	Number of port to expose on the pod's IP address.	int	true
name	Name of the port.	string	false
protocol	Protocol for port. Must be UDP, TCP, or SCTP.	"TCP" or "UDP" or "SCTP"	false	TCP
expose	Specify if the port should be exposed.	bool	false	false

env (daemon)

Name	Description	Type	Required	Default	Immutable
name	Environment variable name.	string	true
value	The value of the environment variable.	string	false
valueFrom	Specifies a source the value of this var should come from.	valueFrom	false

valueFrom (daemon)

Name	Description	Type	Required	Default	Immutable
secretKeyRef	Selects a key of a secret in the pod's namespace.	secretKeyRef	false
configMapKeyRef	Selects a key of a config map in the pod's namespace.	configMapKeyRef	false

secretKeyRef (daemon)

Name	Description	Type	Required	Default	Immutable
name	The name of the secret in the pod's namespace to select from.	string	true
key	The key of the secret to select from. Must be a valid secret key.	string	true

configMapKeyRef (daemon)

Name	Description	Type	Required	Default	Immutable
name	The name of the config map in the pod's namespace to select from.	string	true
key	The key of the config map to select from. Must be a valid secret key.	string	true

volumeMounts (daemon)

Name	Description	Type	Required	Default	Immutable
pvc	Mount PVC type volume.	[]pvc	false
configMap	Mount ConfigMap type volume.	[]configMap	false
secret	Mount Secret type volume.	[]secret	false
emptyDir	Mount EmptyDir type volume.	[]emptyDir	false
hostPath	Mount HostPath type volume.	[]hostPath	false

pvc (daemon)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
claimName	The name of the PVC.	string	true

configMap (daemon)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
defaultMode		int	false	420
cmName		string	true
items		[]items	false

items (daemon)

Name	Description	Type	Required	Default	Immutable
key		string	true
path		string	true
mode		int	false	511

secret (daemon)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
defaultMode		int	false	420
secretName		string	true
items		[]items	false

items (daemon)

Name	Description	Type	Required	Default	Immutable
key		string	true
path		string	true
mode		int	false	511

emptyDir (daemon)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
medium		"" or "Memory"	false	empty

hostPath (daemon)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
mountPropagation		"None" or "HostToContainer" or "Bidirectional"	false
path		string	true
readOnly		bool	false

volumes (daemon)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
type	Specify volume type, options: "pvc","configMap","secret","emptyDir", default to emptyDir.	"emptyDir" or "pvc" or "configMap" or "secret"	false	emptyDir
medium		"" or "Memory"	false	empty

livenessProbe (daemon)

Name	Description	Type	Required	Default	Immutable
exec	Instructions 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.	exec	false
httpGet	Instructions 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.	httpGet	false
tcpSocket	Instructions 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.	tcpSocket	false
initialDelaySeconds	Number of seconds after the container is started before the first probe is initiated.	int	false	0
periodSeconds	How often, in seconds, to execute the probe.	int	false	10
timeoutSeconds	Number of seconds after which the probe times out.	int	false	1
successThreshold	Minimum consecutive successes for the probe to be considered successful after having failed.	int	false	1
failureThreshold	Number of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).	int	false	3

exec (daemon)

Name	Description	Type	Required	Default	Immutable
command	A 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.	[]string	true

httpGet (daemon)

Name	Description	Type	Required	Default	Immutable
path	The endpoint, relative to the port, to which the HTTP GET request should be directed.	string	true
port	The TCP socket within the container to which the HTTP GET request should be directed.	int	true
host		string	false
scheme		string	false	HTTP
httpHeaders		[]httpHeaders	false

httpHeaders (daemon)

Name	Description	Type	Required	Default	Immutable
name		string	true
value		string	true

tcpSocket (daemon)

Name	Description	Type	Required	Default	Immutable
port	The TCP socket within the container that should be probed to assess container health.	int	true

readinessProbe (daemon)

Name	Description	Type	Required	Default	Immutable
exec	Instructions 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.	exec	false
httpGet	Instructions 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.	httpGet	false
tcpSocket	Instructions 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.	tcpSocket	false
initialDelaySeconds	Number of seconds after the container is started before the first probe is initiated.	int	false	0
periodSeconds	How often, in seconds, to execute the probe.	int	false	10
timeoutSeconds	Number of seconds after which the probe times out.	int	false	1
successThreshold	Minimum consecutive successes for the probe to be considered successful after having failed.	int	false	1
failureThreshold	Number of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).	int	false	3

exec (daemon)

Name	Description	Type	Required	Default	Immutable
command	A 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.	[]string	true

httpGet (daemon)

Name	Description	Type	Required	Default	Immutable
path	The endpoint, relative to the port, to which the HTTP GET request should be directed.	string	true
port	The TCP socket within the container to which the HTTP GET request should be directed.	int	true
host		string	false
scheme		string	false	HTTP
httpHeaders		[]httpHeaders	false

httpHeaders (daemon)

Name	Description	Type	Required	Default	Immutable
name		string	true
value		string	true

tcpSocket (daemon)

Name	Description	Type	Required	Default	Immutable
port	The TCP socket within the container that should be probed to assess container health.	int	true

hostAliases (daemon)

Name	Description	Type	Required	Default	Immutable
ip		string	true
hostnames		[]string	true

Helmchart

Note: There is a known limitation with pre-delete and post-delete hook functionality that will be addressed in later releases. Currently, only public chart repositories are supported — authentication for private repositories is on the roadmap.

Description

Deploy Helm charts natively in KubeVela

Examples (helmchart)

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: sample-helmchart
spec:
  components:
    - name: my-chart
      type: helmchart
      properties:
        chart:
          source: oci://ghcr.io/org/charts/app
          version: "1.0.0"

Specification (helmchart)

Name	Description	Type	Required	Default
chart	Chart source configuration	chart	true
release	Release configuration (optional - uses context defaults)	release	false
values	Inline values (highest priority)	map[string]interface	false
options	Rendering options	options	false

chart (helmchart)

Name	Description	Type	Required	Default
source	Chart location - automatically detected based on format (OCI, Direct URL, Repo chart)	string	true
repoURL	Repository URL for repository-based charts	string	false
version	Version/tag for repository and OCI charts (ignored for direct URLs)	string	false	"latest"

release (helmchart)

Name	Description	Type	Required	Default
name	Release name (defaults to component name)	string	false
namespace	Target namespace (defaults to Application namespace)	string	false

options (helmchart)

Name	Description	Type	Required	Default
skipTests	Skip test resources	bool	false	true
skipHooks	Skip hook resources	bool	false	false
createNamespace	Create namespace if it doesn't exist	bool	false	true
timeout	Rendering timeout	string	false	"5m"
maxHistory	Revisions to keep	int	false	10
atomic	Rollback on failure	bool	false	false
wait	Wait for resources	bool	false	false
force	Force resource updates	bool	false	false
recreatePods	Recreate pods on upgrade	bool	false	false
cleanupOnFail	Cleanup on failure	bool	false	false

K8s-Objects

Description

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

Examples (k8s-objects)

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: app-raw
spec:
  components:
    - name: myjob
      type: k8s-objects
      properties:
        objects:
        - apiVersion: batch/v1
          kind: Job
          metadata:
            name: pi
          spec:
            template:
              spec:
                containers:
                - name: pi
                  image: perl
                  command: ["perl",  "-Mbignum=bpi", "-wle", "print bpi(2000)"]
                restartPolicy: Never
            backoffLimit: 4

Specification (k8s-objects)

NAME	DESCRIPTION	TYPE	REQUIRED	DEFAULT
objects	A slice of Kubernetes resource manifests	[]Kubernetes-Objects	true

Statefulset

Description

Describes long-running, scalable, containerized services used to manage stateful application, like database.

Underlying Kubernetes Resources (statefulset)

• statefulsets.apps

Examples (statefulset)

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: postgres
spec:
  components:
    - name: postgres
      type: statefulset
      properties:
        cpu: "1"
        exposeType: ClusterIP
        # see https://hub.docker.com/_/postgres
        image: docker.io/library/postgres:16.4
        memory: 2Gi
        ports:
          - expose: true
            port: 5432
            protocol: TCP
        env:
        - name: POSTGRES_DB
          value: mydb
        - name: POSTGRES_USER
          value: postgres
        - name: POSTGRES_PASSWORD
          value: kvsecretpwd123
      traits:
        - type: scaler
          properties:
            replicas: 1
        - type: storage
          properties:
            pvc:
              - name: "postgresdb-pvc"
                storageClassName: local-path
                resources:
                  requests:
                    storage: "2Gi"
                mountPath: "/var/lib/postgresql/data"

Specification (statefulset)

Name	Description	Type	Required	Default	Immutable
labels	Specify the labels in the workload.	map[string]string	false
annotations	Specify the annotations in the workload.	map[string]string	false
image	Which image would you like to use for your service.	string	true
imagePullPolicy	Specify image pull policy for your service.	"Always" or "Never" or "IfNotPresent"	false
imagePullSecrets	Specify image pull secrets for your service.	[]string	false
ports	Which ports do you want customer traffic sent to, defaults to 80.	[]ports	false
cmd	Commands to run in the container.	[]string	false
args	Arguments to the entrypoint.	[]string	false
env	Define arguments by using environment variables.	[]env	false
cpu	Number of CPU units for the service, like 0.5 (0.5 CPU core), 1 (1 CPU core).	string	false
memory	Specifies the attributes of the memory resource required for the container.	string	false
volumeMounts		volumeMounts	false
volumes	Deprecated field, use volumeMounts instead.	[]volumes	false
livenessProbe	Instructions for assessing whether the container is alive.	livenessProbe	false
readinessProbe	Instructions for assessing whether the container is in a suitable state to serve traffic.	readinessProbe	false
hostAliases	Specify the hostAliases to add.	[]hostAliases	false

ports (statefulset)

Name	Description	Type	Required	Default	Immutable
port	Number of port to expose on the pod's IP address.	int	true
containerPort	Number of container port to connect to, defaults to port.	int	false
name	Name of the port.	string	false
protocol	Protocol for port. Must be UDP, TCP, or SCTP.	"TCP" or "UDP" or "SCTP"	false	TCP
expose	Specify if the port should be exposed.	bool	false	false
nodePort	exposed node port. Only Valid when exposeType is NodePort.	int	false

env (statefulset)

Name	Description	Type	Required	Default	Immutable
name	Environment variable name.	string	true
value	The value of the environment variable.	string	false
valueFrom	Specifies a source the value of this var should come from.	valueFrom	false

valueFrom (statefulset)

Name	Description	Type	Required	Default	Immutable
secretKeyRef	Selects a key of a secret in the pod's namespace.	secretKeyRef	false
configMapKeyRef	Selects a key of a config map in the pod's namespace.	configMapKeyRef	false

secretKeyRef (statefulset)

Name	Description	Type	Required	Default	Immutable
name	The name of the secret in the pod's namespace to select from.	string	true
key	The key of the secret to select from. Must be a valid secret key.	string	true

configMapKeyRef (statefulset)

Name	Description	Type	Required	Default	Immutable
name	The name of the config map in the pod's namespace to select from.	string	true
key	The key of the config map to select from. Must be a valid secret key.	string	true

volumeMounts (statefulset)

Name	Description	Type	Required	Default	Immutable
pvc	Mount PVC type volume.	[]pvc	false
configMap	Mount ConfigMap type volume.	[]configMap	false
secret	Mount Secret type volume.	[]secret	false
emptyDir	Mount EmptyDir type volume.	[]emptyDir	false
hostPath	Mount HostPath type volume.	[]hostPath	false

pvc (statefulset)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
claimName	The name of the PVC.	string	true

configMap (statefulset)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
defaultMode		int	false	420
cmName		string	true
items		[]items	false

items (statefulset)

Name	Description	Type	Required	Default	Immutable
key		string	true
path		string	true
mode		int	false	511

secret (statefulset)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
defaultMode		int	false	420
secretName		string	true
items		[]items	false

items (statefulset)

Name	Description	Type	Required	Default	Immutable
key		string	true
path		string	true
mode		int	false	511

emptyDir (statefulset)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
medium		"" or "Memory"	false	empty

hostPath (statefulset)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
path		string	true

volumes (statefulset)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
type	Specify volume type, options: "pvc","configMap","secret","emptyDir", default to emptyDir.	"emptyDir" or "pvc" or "configMap" or "secret"	false	emptyDir
medium		"" or "Memory"	false	empty

livenessProbe (statefulset)

Name	Description	Type	Required	Default	Immutable
exec	Instructions 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.	exec	false
httpGet	Instructions 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.	httpGet	false
tcpSocket	Instructions 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.	tcpSocket	false
initialDelaySeconds	Number of seconds after the container is started before the first probe is initiated.	int	false	0
periodSeconds	How often, in seconds, to execute the probe.	int	false	10
timeoutSeconds	Number of seconds after which the probe times out.	int	false	1
successThreshold	Minimum consecutive successes for the probe to be considered successful after having failed.	int	false	1
failureThreshold	Number of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).	int	false	3

exec (statefulset)

Name	Description	Type	Required	Default	Immutable
command	A 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.	[]string	true

httpGet (statefulset)

Name	Description	Type	Required	Default	Immutable
path	The endpoint, relative to the port, to which the HTTP GET request should be directed.	string	true
port	The TCP socket within the container to which the HTTP GET request should be directed.	int	true
host		string	false
scheme		string	false	HTTP
httpHeaders		[]httpHeaders	false

httpHeaders (statefulset)

Name	Description	Type	Required	Default	Immutable
name		string	true
value		string	true

tcpSocket (statefulset)

Name	Description	Type	Required	Default	Immutable
port	The TCP socket within the container that should be probed to assess container health.	int	true

readinessProbe (statefulset)

Name	Description	Type	Required	Default	Immutable
exec	Instructions 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.	exec	false
httpGet	Instructions 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.	httpGet	false
tcpSocket	Instructions 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.	tcpSocket	false
initialDelaySeconds	Number of seconds after the container is started before the first probe is initiated.	int	false	0
periodSeconds	How often, in seconds, to execute the probe.	int	false	10
timeoutSeconds	Number of seconds after which the probe times out.	int	false	1
successThreshold	Minimum consecutive successes for the probe to be considered successful after having failed.	int	false	1
failureThreshold	Number of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).	int	false	3

exec (statefulset)

Name	Description	Type	Required	Default	Immutable
command	A 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.	[]string	true

httpGet (statefulset)

Name	Description	Type	Required	Default	Immutable
path	The endpoint, relative to the port, to which the HTTP GET request should be directed.	string	true
port	The TCP socket within the container to which the HTTP GET request should be directed.	int	true
host		string	false
scheme		string	false	HTTP
httpHeaders		[]httpHeaders	false

httpHeaders (statefulset)

Name	Description	Type	Required	Default	Immutable
name		string	true
value		string	true

tcpSocket (statefulset)

Name	Description	Type	Required	Default	Immutable
port	The TCP socket within the container that should be probed to assess container health.	int	true

hostAliases (statefulset)

Name	Description	Type	Required	Default	Immutable
ip		string	true
hostnames		[]string	true

Task

Description

Describes jobs that run code or a script to completion.

Underlying Kubernetes Resources (task)

• jobs.batch

Examples (task)

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: app-worker
spec:
  components:
    - name: mytask
      type: task
      properties:
        image: perl
	    count: 10
	    cmd: ["perl",  "-Mbignum=bpi", "-wle", "print bpi(2000)"]

Specification (task)

Name	Description	Type	Required	Default	Immutable
labels	Specify the labels in the workload.	map[string]string	false
annotations	Specify the annotations in the workload.	map[string]string	false
count	Specify number of tasks to run in parallel.	int	false	1
image	Which image would you like to use for your service.	string	true
imagePullPolicy	Specify image pull policy for your service.	"Always" or "Never" or "IfNotPresent"	false
imagePullSecrets	Specify image pull secrets for your service.	[]string	false
restart	Define the job restart policy, the value can only be Never or OnFailure. By default, it's Never.	string	false	Never
cmd	Commands to run in the container.	[]string	false
env	Define arguments by using environment variables.	[]env	false
cpu	Number of CPU units for the service, like 0.5 (0.5 CPU core), 1 (1 CPU core).	string	false
memory	Specifies the attributes of the memory resource required for the container.	string	false
volumes	Declare volumes and volumeMounts.	[]volumes	false
livenessProbe	Instructions for assessing whether the container is alive.	livenessProbe	false
readinessProbe	Instructions for assessing whether the container is in a suitable state to serve traffic.	readinessProbe	false

env (task)

Name	Description	Type	Required	Default	Immutable
name	Environment variable name.	string	true
value	The value of the environment variable.	string	false
valueFrom	Specifies a source the value of this var should come from.	valueFrom	false

valueFrom (task)

Name	Description	Type	Required	Default	Immutable
secretKeyRef	Selects a key of a secret in the pod's namespace.	secretKeyRef	false
configMapKeyRef	Selects a key of a config map in the pod's namespace.	configMapKeyRef	false

secretKeyRef (task)

Name	Description	Type	Required	Default	Immutable
name	The name of the secret in the pod's namespace to select from.	string	true
key	The key of the secret to select from. Must be a valid secret key.	string	true

configMapKeyRef (task)

Name	Description	Type	Required	Default	Immutable
name	The name of the config map in the pod's namespace to select from.	string	true
key	The key of the config map to select from. Must be a valid secret key.	string	true

volumes (task)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
type	Specify volume type, options: "pvc","configMap","secret","emptyDir", default to emptyDir.	"emptyDir" or "pvc" or "configMap" or "secret"	false	emptyDir
medium		"" or "Memory"	false	empty

livenessProbe (task)

Name	Description	Type	Required	Default	Immutable
exec	Instructions 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.	exec	false
httpGet	Instructions 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.	httpGet	false
tcpSocket	Instructions 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.	tcpSocket	false
initialDelaySeconds	Number of seconds after the container is started before the first probe is initiated.	int	false	0
periodSeconds	How often, in seconds, to execute the probe.	int	false	10
timeoutSeconds	Number of seconds after which the probe times out.	int	false	1
successThreshold	Minimum consecutive successes for the probe to be considered successful after having failed.	int	false	1
failureThreshold	Number of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).	int	false	3

exec (task)

Name	Description	Type	Required	Default	Immutable
command	A 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.	[]string	true

httpGet (task)

Name	Description	Type	Required	Default	Immutable
path	The endpoint, relative to the port, to which the HTTP GET request should be directed.	string	true
port	The TCP socket within the container to which the HTTP GET request should be directed.	int	true
httpHeaders		[]httpHeaders	false

httpHeaders (task)

Name	Description	Type	Required	Default	Immutable
name		string	true
value		string	true

tcpSocket (task)

Name	Description	Type	Required	Default	Immutable
port	The TCP socket within the container that should be probed to assess container health.	int	true

readinessProbe (task)

Name	Description	Type	Required	Default	Immutable
exec	Instructions 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.	exec	false
httpGet	Instructions 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.	httpGet	false
tcpSocket	Instructions 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.	tcpSocket	false
initialDelaySeconds	Number of seconds after the container is started before the first probe is initiated.	int	false	0
periodSeconds	How often, in seconds, to execute the probe.	int	false	10
timeoutSeconds	Number of seconds after which the probe times out.	int	false	1
successThreshold	Minimum consecutive successes for the probe to be considered successful after having failed.	int	false	1
failureThreshold	Number of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).	int	false	3

exec (task)

Name	Description	Type	Required	Default	Immutable
command	A 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.	[]string	true

httpGet (task)

Name	Description	Type	Required	Default	Immutable
path	The endpoint, relative to the port, to which the HTTP GET request should be directed.	string	true
port	The TCP socket within the container to which the HTTP GET request should be directed.	int	true
httpHeaders		[]httpHeaders	false

httpHeaders (task)

Name	Description	Type	Required	Default	Immutable
name		string	true
value		string	true

tcpSocket (task)

Name	Description	Type	Required	Default	Immutable
port	The TCP socket within the container that should be probed to assess container health.	int	true

Webservice

Description

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

Underlying Kubernetes Resources (webservice)

• deployments.apps

Examples (webservice)

apiVersion: core.oam.dev/v1beta1
kind: Application
metadata:
  name: website
spec:
  components:
    - name: frontend
      type: webservice
      properties:
        image: oamdev/testapp:v1
        cmd: ["node", "server.js"]
        ports:
          - port: 8080
            expose: true
        cpu: "0.1"
        env:
          - name: FOO
            value: bar
          - name: FOO
            valueFrom:
              secretKeyRef:
                name: bar
                key: bar

Specification (webservice)

Name	Description	Type	Required	Default	Immutable
labels	Specify the labels in the workload.	map[string]string	false
annotations	Specify the annotations in the workload.	map[string]string	false
image	Which image would you like to use for your service.	string	true
imagePullPolicy	Specify image pull policy for your service.	"Always" or "Never" or "IfNotPresent"	false
imagePullSecrets	Specify image pull secrets for your service.	[]string	false
ports	Which ports do you want customer traffic sent to, defaults to 80.	[]ports	false
cmd	Commands to run in the container.	[]string	false
args	Arguments to the entrypoint.	[]string	false
env	Define arguments by using environment variables.	[]env	false
cpu	Number of CPU units for the service, like 0.5 (0.5 CPU core), 1 (1 CPU core).	string	false
memory	Specifies the attributes of the memory resource required for the container.	string	false
limit		limit	false
volumeMounts		volumeMounts	false
volumes	Deprecated field, use volumeMounts instead.	[]volumes	false
livenessProbe	Instructions for assessing whether the container is alive.	livenessProbe	false
readinessProbe	Instructions for assessing whether the container is in a suitable state to serve traffic.	readinessProbe	false
hostAliases	Specify the hostAliases to add.	[]hostAliases	false

ports (webservice)

Name	Description	Type	Required	Default	Immutable
port	Number of port to expose on the pod's IP address.	int	true
containerPort	Number of container port to connect to, defaults to port.	int	false
name	Name of the port.	string	false
protocol	Protocol for port. Must be UDP, TCP, or SCTP.	"TCP" or "UDP" or "SCTP"	false	TCP
expose	Specify if the port should be exposed.	bool	false	false
nodePort	exposed node port. Only Valid when exposeType is NodePort.	int	false

env (webservice)

Name	Description	Type	Required	Default	Immutable
name	Environment variable name.	string	true
value	The value of the environment variable.	string	false
valueFrom	Specifies a source the value of this var should come from.	valueFrom	false

valueFrom (webservice)

Name	Description	Type	Required	Default	Immutable
secretKeyRef	Selects a key of a secret in the pod's namespace.	secretKeyRef	false
configMapKeyRef	Selects a key of a config map in the pod's namespace.	configMapKeyRef	false

secretKeyRef (webservice)

Name	Description	Type	Required	Default	Immutable
name	The name of the secret in the pod's namespace to select from.	string	true
key	The key of the secret to select from. Must be a valid secret key.	string	true

configMapKeyRef (webservice)

Name	Description	Type	Required	Default	Immutable
name	The name of the config map in the pod's namespace to select from.	string	true
key	The key of the config map to select from. Must be a valid secret key.	string	true

limit (webservice)

Name	Description	Type	Required	Default	Immutable
cpu		string	false
memory		string	false

volumeMounts (webservice)

Name	Description	Type	Required	Default	Immutable
pvc	Mount PVC type volume.	[]pvc	false
configMap	Mount ConfigMap type volume.	[]configMap	false
secret	Mount Secret type volume.	[]secret	false
emptyDir	Mount EmptyDir type volume.	[]emptyDir	false
hostPath	Mount HostPath type volume.	[]hostPath	false

pvc (webservice)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
claimName	The name of the PVC.	string	true

configMap (webservice)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
defaultMode		int	false	420
cmName		string	true
items		[]items	false

items (webservice)

Name	Description	Type	Required	Default	Immutable
key		string	true
path		string	true
mode		int	false	511

secret (webservice)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
defaultMode		int	false	420
secretName		string	true
items		[]items	false

items (webservice)

Name	Description	Type	Required	Default	Immutable
key		string	true
path		string	true
mode		int	false	511

emptyDir (webservice)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
medium		"" or "Memory"	false	empty

hostPath (webservice)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
subPath		string	false
path		string	true

volumes (webservice)

Name	Description	Type	Required	Default	Immutable
name		string	true
mountPath		string	true
type	Specify volume type, options: "pvc","configMap","secret","emptyDir", default to emptyDir.	"emptyDir" or "pvc" or "configMap" or "secret"	false	emptyDir
medium		"" or "Memory"	false	empty

livenessProbe (webservice)

Name	Description	Type	Required	Default	Immutable
exec	Instructions 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.	exec	false
httpGet	Instructions 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.	httpGet	false
tcpSocket	Instructions 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.	tcpSocket	false
initialDelaySeconds	Number of seconds after the container is started before the first probe is initiated.	int	false	0
periodSeconds	How often, in seconds, to execute the probe.	int	false	10
timeoutSeconds	Number of seconds after which the probe times out.	int	false	1
successThreshold	Minimum consecutive successes for the probe to be considered successful after having failed.	int	false	1
failureThreshold	Number of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).	int	false	3

exec (webservice)

Name	Description	Type	Required	Default	Immutable
command	A 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.	[]string	true

httpGet (webservice)

Name	Description	Type	Required	Default	Immutable
path	The endpoint, relative to the port, to which the HTTP GET request should be directed.	string	true
port	The TCP socket within the container to which the HTTP GET request should be directed.	int	true
host		string	false
scheme		string	false	HTTP
httpHeaders		[]httpHeaders	false

httpHeaders (webservice)

Name	Description	Type	Required	Default	Immutable
name		string	true
value		string	true

tcpSocket (webservice)

Name	Description	Type	Required	Default	Immutable
port	The TCP socket within the container that should be probed to assess container health.	int	true

readinessProbe (webservice)

Name	Description	Type	Required	Default	Immutable
exec	Instructions 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.	exec	false
httpGet	Instructions 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.	httpGet	false
tcpSocket	Instructions 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.	tcpSocket	false
initialDelaySeconds	Number of seconds after the container is started before the first probe is initiated.	int	false	0
periodSeconds	How often, in seconds, to execute the probe.	int	false	10
timeoutSeconds	Number of seconds after which the probe times out.	int	false	1
successThreshold	Minimum consecutive successes for the probe to be considered successful after having failed.	int	false	1
failureThreshold	Number of consecutive failures required to determine the container is not alive (liveness probe) or not ready (readiness probe).	int	false	3

exec (webservice)

Name	Description	Type	Required	Default	Immutable
command	A 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.	[]string	true

httpGet (webservice)

Name	Description	Type	Required	Default	Immutable
path	The endpoint, relative to the port, to which the HTTP GET request should be directed.	string	true
port	The TCP socket within the container to which the HTTP GET request should be directed.	int	true
host		string	false
scheme		string	false	HTTP
httpHeaders		[]httpHeaders	false

httpHeaders (webservice)

Name	Description	Type	Required	Default	Immutable
name		string	true
value		string	true

tcpSocket (webservice)

Name	Description	Type	Required	Default	Immutable
port	The TCP socket within the container that should be probed to assess container health.	int	true

hostAliases (webservice)

Name	Description	Type	Required	Default	Immutable
ip		string	true
hostnames		[]string	true