运行 [tekton.dev/v1]
- 描述
- Run represents a single execution of a Custom Task.
- 类型
object
规格
.spec
- 描述
- RunSpec defines the desired state of Run
- 类型
object
.spec.params
- 描述
- Params is a list of Param
- 类型
array
.spec.params[]
- 描述
- Param declares an ParamValues to use for the parameter called name.
- 类型
object- 必填
namevalue
.spec.podTemplate
- 描述
- PodTemplate holds pod specific configuration
- 类型
object
.spec.podTemplate.dnsConfig
- 描述
- Specifies the DNS parameters of a pod. Parameters specified here will be merged to the generated DNS configuration based on DNSPolicy.
- 类型
object
.spec.podTemplate.dnsConfig.nameservers
- 描述
- A list of DNS name server IP addresses. This will be appended to the base nameservers generated from DNSPolicy. Duplicated nameservers will be removed.
- 类型
array
.spec.podTemplate.dnsConfig.nameservers[]
- 类型
string
.spec.podTemplate.dnsConfig.options
- 描述
- A list of DNS resolver options. This will be merged with the base options generated from DNSPolicy. Duplicated entries will be removed. Resolution options given in Options will override those that appear in the base DNSPolicy.
- 类型
array
.spec.podTemplate.dnsConfig.options[]
- 描述
- PodDNSConfigOption defines DNS resolver options of a pod.
- 类型
object
.spec.podTemplate.dnsConfig.searches
- 描述
- A list of DNS search domains for host-name lookup. This will be appended to the base search paths generated from DNSPolicy. Duplicated search paths will be removed.
- 类型
array
.spec.podTemplate.dnsConfig.searches[]
- 类型
string
.spec.podTemplate.env
- 描述
- List of environment variables that can be provided to the containers belonging to the pod.
- 类型
array
.spec.podTemplate.env[]
- 描述
- EnvVar represents an environment variable present in a Container.
- 类型
object- 必填
name
.spec.podTemplate.env[].valueFrom
- 描述
- Source for the environment variable's value. Cannot be used if value is not empty.
- 类型
object
.spec.podTemplate.env[].valueFrom.configMapKeyRef
- 描述
- Selects a key of a ConfigMap.
- 类型
object- 必填
key
.spec.podTemplate.env[].valueFrom.fieldRef
- 描述
- Selects a field of the pod: supports metadata.name, metadata.namespace, `metadata.labels['<KEY>']`, `metadata.annotations['<KEY>']`, spec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs.
- 类型
object- 必填
fieldPath
.spec.podTemplate.env[].valueFrom.resourceFieldRef
- 描述
- Selects a resource of the container: only resources limits and requests (limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory and requests.ephemeral-storage) are currently supported.
- 类型
object- 必填
resource
.spec.podTemplate.env[].valueFrom.secretKeyRef
- 描述
- Selects a key of a secret in the pod's namespace
- 类型
object- 必填
key
.spec.podTemplate.hostAliases
- 描述
- HostAliases is an optional list of hosts and IPs that will be injected into the pod's hosts file if specified. This is only valid for non-hostNetwork pods.
- 类型
array
.spec.podTemplate.hostAliases[]
- 描述
- HostAlias holds the mapping between IP and hostnames that will be injected as an entry in the pod's hosts file.
- 类型
object- 必填
ip
.spec.podTemplate.hostAliases[].hostnames
- 描述
- Hostnames for the above IP address.
- 类型
array
.spec.podTemplate.hostAliases[].hostnames[]
- 类型
string
.spec.podTemplate.imagePullSecrets
- 描述
- ImagePullSecrets gives the name of the secret used by the pod to pull the image if specified
- 类型
array
.spec.podTemplate.imagePullSecrets[]
- 描述
- LocalObjectReference contains enough information to let you locate the referenced object inside the same namespace.
- 类型
object
.spec.podTemplate.nodeSelector
- 描述
- NodeSelector is a selector which must be true for the pod to fit on a node. Selector which must match a node's labels for the pod to be scheduled on that node. More info: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
- 类型
object
.spec.podTemplate.tolerations
- 描述
- If specified, the pod's tolerations.
- 类型
array
.spec.podTemplate.tolerations[]
- 描述
- The pod this Toleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator <operator>.
- 类型
object
.spec.podTemplate.topologySpreadConstraints
- 描述
- TopologySpreadConstraints controls how Pods are spread across your cluster among failure-domains such as regions, zones, nodes, and other user-defined topology domains.
- 类型
array
.spec.podTemplate.topologySpreadConstraints[]
- 描述
- TopologySpreadConstraint specifies how to spread matching pods among the given topology.
- 类型
object- 必填
maxSkewtopologyKeywhenUnsatisfiable
.spec.podTemplate.topologySpreadConstraints[].labelSelector
- 描述
- LabelSelector is used to find matching pods. Pods that match this label selector are counted to determine the number of pods in their corresponding topology domain.
- 类型
object
.spec.podTemplate.topologySpreadConstraints[].labelSelector.matchExpressions
- 描述
- matchExpressions is a list of label selector requirements. The requirements are ANDed.
- 类型
array
.spec.podTemplate.topologySpreadConstraints[].labelSelector.matchExpressions[]
- 描述
- A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
- 类型
object- 必填
keyoperator
.spec.podTemplate.topologySpreadConstraints[].labelSelector.matchExpressions[].values
- 描述
- values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
- 类型
array
.spec.podTemplate.topologySpreadConstraints[].labelSelector.matchExpressions[].values[]
- 类型
string
.spec.podTemplate.topologySpreadConstraints[].labelSelector.matchLabels
- 描述
- matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
- 类型
object
.spec.podTemplate.topologySpreadConstraints[].matchLabelKeys
- 描述
- MatchLabelKeys is a set of pod label keys to select the pods over which spreading will be calculated. The keys are used to lookup values from the incoming pod labels, those key-value labels are ANDed with labelSelector to select the group of existing pods over which spreading will be calculated for the incoming pod. The same key is forbidden to exist in both MatchLabelKeys and LabelSelector. MatchLabelKeys cannot be set when LabelSelector isn't set. Keys that don't exist in the incoming pod labels will be ignored. A null or empty list means only match against labelSelector. This is a beta field and requires the MatchLabelKeysInPodTopologySpread feature gate to be enabled (enabled by default).
- 类型
array
.spec.podTemplate.topologySpreadConstraints[].matchLabelKeys[]
- 类型
string
.spec.ref
- 描述
- TaskRef can be used to refer to a specific instance of a task.
- 类型
object
.spec.ref.params
- 描述
- Params contains the parameters used to identify the referenced Tekton resource. Example entries might include "repo" or "path" but the set of params ultimately depends on the chosen resolver.
- 类型
array
.spec.ref.params[]
- 描述
- Param declares an ParamValues to use for the parameter called name.
- 类型
object- 必填
namevalue
.spec.spec
- 描述
- Spec is a specification of a custom task
- 类型
object
.spec.spec.spec
- 描述
- Spec is a specification of a custom task
- 类型
object
.spec.workspaces
- 描述
- Workspaces is a list of WorkspaceBindings from volumes to workspaces.
- 类型
array
.spec.workspaces[]
- 描述
- WorkspaceBinding maps a Task's declared workspace to a Volume.
- 类型
object- 必填
name
.spec.workspaces[].configMap
- 描述
- ConfigMap represents a configMap that should populate this workspace.
- 类型
object
.spec.workspaces[].configMap.items
- 描述
- items if unspecified, each key-value pair in the Data field of the referenced ConfigMap will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified which is not present in the ConfigMap, the volume setup will error unless it is marked optional. Paths must be relative and may not contain the '..' path or start with '..'.
- 类型
array
.spec.workspaces[].configMap.items[]
- 描述
- Maps a string key to a path within a volume.
- 类型
object- 必填
keypath
.spec.workspaces[].csi
- 描述
- CSI (Container Storage Interface) represents ephemeral storage that is handled by certain external CSI drivers.
- 类型
object- 必填
driver
.spec.workspaces[].csi.nodePublishSecretRef
- 描述
- nodePublishSecretRef is a reference to the secret object containing sensitive information to pass to the CSI driver to complete the CSI NodePublishVolume and NodeUnpublishVolume calls. This field is optional, and may be empty if no secret is required. If the secret object contains more than one secret, all secret references are passed.
- 类型
object
.spec.workspaces[].csi.volumeAttributes
- 描述
- volumeAttributes stores driver-specific properties that are passed to the CSI driver. Consult your driver's documentation for supported values.
- 类型
object
.spec.workspaces[].emptyDir
- 描述
- EmptyDir represents a temporary directory that shares a Task's lifetime. More info: https://kubernetes.io/docs/concepts/storage/volumes#emptydir Either this OR PersistentVolumeClaim can be used.
- 类型
object
.spec.workspaces[].persistentVolumeClaim
- 描述
- PersistentVolumeClaimVolumeSource represents a reference to a PersistentVolumeClaim in the same namespace. Either this OR EmptyDir can be used.
- 类型
object- 必填
claimName
.spec.workspaces[].projected
- 描述
- Projected represents a projected volume that should populate this workspace.
- 类型
object
.spec.workspaces[].projected.sources
- 描述
- sources is the list of volume projections. Each entry in this list handles one source.
- 类型
array
.spec.workspaces[].projected.sources[]
- 描述
- Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.
- 类型
object
.spec.workspaces[].projected.sources[].clusterTrustBundle
- 描述
- ClusterTrustBundle allows a pod to access the `.spec.trustBundle` field of ClusterTrustBundle objects in an auto-updating file. Alpha, gated by the ClusterTrustBundleProjection feature gate. ClusterTrustBundle objects can either be selected by name, or by the combination of signer name and a label selector. Kubelet performs aggressive normalization of the PEM contents written into the pod filesystem. Esoteric PEM features such as inter-block comments and block headers are stripped. Certificates are deduplicated. The ordering of certificates within the file is arbitrary, and Kubelet may change the order over time.
- 类型
object- 必填
path
.spec.workspaces[].projected.sources[].clusterTrustBundle.labelSelector
- 描述
- Select all ClusterTrustBundles that match this label selector. Only has effect if signerName is set. Mutually-exclusive with name. If unset, interpreted as "match nothing". If set but empty, interpreted as "match everything".
- 类型
object
.spec.workspaces[].projected.sources[].clusterTrustBundle.labelSelector.matchExpressions
- 描述
- matchExpressions is a list of label selector requirements. The requirements are ANDed.
- 类型
array
.spec.workspaces[].projected.sources[].clusterTrustBundle.labelSelector.matchExpressions[]
- 描述
- A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
- 类型
object- 必填
keyoperator
.spec.workspaces[].projected.sources[].clusterTrustBundle.labelSelector.matchExpressions[].values
- 描述
- values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
- 类型
array
.spec.workspaces[].projected.sources[].clusterTrustBundle.labelSelector.matchExpressions[].values[]
- 类型
string
.spec.workspaces[].projected.sources[].clusterTrustBundle.labelSelector.matchLabels
- 描述
- matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
- 类型
object
.spec.workspaces[].projected.sources[].configMap
- 描述
- configMap information about the configMap data to project
- 类型
object
.spec.workspaces[].projected.sources[].configMap.items
- 描述
- items if unspecified, each key-value pair in the Data field of the referenced ConfigMap will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified which is not present in the ConfigMap, the volume setup will error unless it is marked optional. Paths must be relative and may not contain the '..' path or start with '..'.
- 类型
array
.spec.workspaces[].projected.sources[].configMap.items[]
- 描述
- Maps a string key to a path within a volume.
- 类型
object- 必填
keypath
.spec.workspaces[].projected.sources[].downwardAPI
- 描述
- downwardAPI information about the downwardAPI data to project
- 类型
object
.spec.workspaces[].projected.sources[].downwardAPI.items
- 描述
- Items is a list of DownwardAPIVolume file
- 类型
array
.spec.workspaces[].projected.sources[].downwardAPI.items[]
- 描述
- DownwardAPIVolumeFile represents information to create the file containing the pod field
- 类型
object- 必填
path
.spec.workspaces[].projected.sources[].downwardAPI.items[].fieldRef
- 描述
- Required: Selects a field of the pod: only annotations, labels, name, namespace and uid are supported.
- 类型
object- 必填
fieldPath
.spec.workspaces[].projected.sources[].downwardAPI.items[].resourceFieldRef
- 描述
- Selects a resource of the container: only resources limits and requests (limits.cpu, limits.memory, requests.cpu and requests.memory) are currently supported.
- 类型
object- 必填
resource
.spec.workspaces[].projected.sources[].secret
- 描述
- secret information about the secret data to project
- 类型
object
.spec.workspaces[].projected.sources[].secret.items
- 描述
- items if unspecified, each key-value pair in the Data field of the referenced Secret will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified which is not present in the Secret, the volume setup will error unless it is marked optional. Paths must be relative and may not contain the '..' path or start with '..'.
- 类型
array
.spec.workspaces[].projected.sources[].secret.items[]
- 描述
- Maps a string key to a path within a volume.
- 类型
object- 必填
keypath
.spec.workspaces[].projected.sources[].serviceAccountToken
- 描述
- serviceAccountToken is information about the serviceAccountToken data to project
- 类型
object- 必填
path
.spec.workspaces[].secret
- 描述
- Secret represents a secret that should populate this workspace.
- 类型
object
.spec.workspaces[].secret.items
- 描述
- items If unspecified, each key-value pair in the Data field of the referenced Secret will be projected into the volume as a file whose name is the key and content is the value. If specified, the listed keys will be projected into the specified paths, and unlisted keys will not be present. If a key is specified which is not present in the Secret, the volume setup will error unless it is marked optional. Paths must be relative and may not contain the '..' path or start with '..'.
- 类型
array
.spec.workspaces[].secret.items[]
- 描述
- Maps a string key to a path within a volume.
- 类型
object- 必填
keypath
.status
- 描述
- RunStatus defines the observed state of Run
- 类型
object
.status.annotations
- 描述
- Annotations is additional Status fields for the Resource to save some additional State as well as convey more information to the user. This is roughly akin to Annotations on any k8s resource, just the reconciler conveying richer information outwards.
- 类型
object
.status.conditions
- 描述
- Conditions the latest available observations of a resource's current state.
- 类型
array
.status.conditions[]
- 描述
- Condition defines a readiness condition for a Knative resource. See: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#typical-status-properties
- 类型
object- 必填
statustype
.status.extraFields
- 描述
- ExtraFields holds arbitrary fields provided by the custom task controller.
- 类型
object
.status.results
- 描述
- Results reports any output result values to be consumed by later tasks in a pipeline.
- 类型
array
.status.results[]
- 描述
- RunResult used to describe the results of a task
- 类型
object- 必填
namevalue
.status.retriesStatus
- 描述
- RetriesStatus contains the history of RunStatus, in case of a retry.
- 类型
array
.status.retriesStatus[]
- 类型
API 端点
可用的 API 端点如下:
/apis/tekton.dev/v1alpha1/namespaces/{namespace}/runsDELETE: delete collection of RunGET: list objects of kind RunPOST: create a new Run
/apis/tekton.dev/v1alpha1/namespaces/{namespace}/runs/{name}DELETE: delete the specified RunGET: read the specified RunPATCH: partially update the specified RunPUT: replace the specified Run
/apis/tekton.dev/v1alpha1/namespaces/{namespace}/runs
- HTTP 方法
DELETE- 描述
- delete collection of Run
- HTTP 响应
- HTTP 方法
GET- 描述
- list objects of kind Run
- HTTP 响应
- HTTP 方法
POST- 描述
- create a new Run
- 查询参数
- 请求体参数
- HTTP 响应
/apis/tekton.dev/v1alpha1/namespaces/{namespace}/runs/{name}
- HTTP 方法
DELETE- 描述
- delete the specified Run
- 查询参数
- HTTP 响应
- HTTP 方法
GET- 描述
- read the specified Run
- HTTP 响应
- HTTP 方法
PATCH- 描述
- partially update the specified Run
- 查询参数
- HTTP 响应
- HTTP 方法
PUT- 描述
- replace the specified Run
- 查询参数
- 请求体参数
- HTTP 响应