Pipeline API reference
Packages:
pipeline.kurator.dev/v1alpha1
Package v1alpha1 contains API Schema definitions for the fleet v1alpha1 API group
Resource Types:Pipeline
Pipeline is the top-level type for Kurator CI Pipeline.
Field | Description | ||||||
---|---|---|---|---|---|---|---|
apiVersion string |
pipeline.kurator.dev/v1alpha1
|
||||||
kind string |
Pipeline
|
||||||
metadata Kubernetes meta/v1.ObjectMeta |
Refer to the Kubernetes API documentation for the fields of the
metadata field.
|
||||||
spec PipelineSpec |
|
||||||
status PipelineStatus |
CustomTask
(Appears on: PipelineTask)
CustomTask defines the specification for a user-defined task.
Field | Description |
---|---|
image string |
(Optional)
Image specifies the Docker image name. More info: https://kubernetes.io/docs/concepts/containers/images |
command []string |
(Optional)
Command is the entrypoint array. It’s not executed in a shell. If not provided, the image’s ENTRYPOINT is used. Environment variables can be used in the format $(VAR_NAME). More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
args []string |
(Optional)
Args are the arguments for the entrypoint. If not provided, the image’s CMD is used. Supports environment variable expansion in the format $(VAR_NAME). More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell |
env []Kubernetes core/v1.EnvVar |
(Optional)
List of environment variables to set in the Step. Cannot be updated. |
resourceRequirements Kubernetes core/v1.ResourceRequirements |
(Optional)
ResourceRequirements required by this Step. Cannot be updated. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
script string |
(Optional)
Script is the contents of an executable file to execute. If Script is not empty, the CustomTask cannot have a Command and the Args will be passed to the Script. |
PipelinePhase
(string
alias)
(Appears on: PipelineStatus)
PipelineSpec
(Appears on: Pipeline)
PipelineSpec defines the desired state of a Pipeline.
Field | Description |
---|---|
description string |
(Optional)
Description allows an administrator to provide a description of the pipeline. |
tasks []PipelineTask |
Tasks is an ordered list of tasks in the pipeline, containing detailed information about each task. The tasks will be executed in the order they are listed. |
sharedWorkspace VolumeClaimTemplate |
(Optional)
SharedWorkspace is the config of the PVC where task using The PersistentVolumeClaim with this config will be created for each pipeline execution it allows the user to specify e.g. size and StorageClass for the volume. If not set, Kurator will create a PVC named Pipeline.name using default config |
PipelineStatus
(Appears on: Pipeline)
Field | Description |
---|---|
phase PipelinePhase |
(Optional)
Phase describes the overall state of the Pipeline. |
eventListenerServiceName string |
(Optional)
EventListenerServiceName specifies the name of the service created by Kurator for event listeners. This name is useful for users when setting up a gateway service and routing to this service. |
PipelineTask
(Appears on: PipelineSpec)
Field | Description |
---|---|
name string |
Name is the name of the task. |
predefinedTask PredefinedTask |
(Optional)
PredefinedTask allows users to select a predefined task. Users can choose a predefined task from a set list and fill in their own parameters. |
customTask CustomTask |
(Optional)
CustomTask enables defining a task directly within the CRD if TaskRef is not used. This should only be used when TaskRef is not provided. |
retries int |
(Optional)
Retries represents how many times this task should be retried in case of task failure. default values is zero. |
PredefinedTask
(Appears on: PipelineTask)
PredefinedTask provides a structure for defining a PredefinedTask.
Field | Description |
---|---|
name TaskTemplate |
Name specifies the predefined task template to be used. This field is required to select the appropriate PredefinedTask. |
params map[string]string |
(Optional)
Params contains key-value pairs for task-specific parameters. The required parameters vary depending on the TaskType chosen. |
TaskTemplate
(string
alias)
(Appears on: PredefinedTask)
VolumeClaimTemplate
(Appears on: PipelineSpec)
VolumeClaimTemplate is the configuration for the volume claim template in pipeline execution. For more details, see https://github.com/kubernetes/api/blob/master/core/v1/types.go
Field | Description |
---|---|
accessMode Kubernetes core/v1.PersistentVolumeAccessMode |
AccessMode determines the access modes for the volume, e.g., ReadWriteOnce. This affects how the volume can be mounted. “ReadWriteOnce” can be mounted in read/write mode to exactly 1 host “ReadOnlyMany” can be mounted in read-only mode to many hosts “ReadWriteMany” can be mounted in read/write mode to many hosts “ReadWriteOncePod” can be mounted in read/write mode to exactly 1 pod, cannot be used in combination with other access modes |
storageRequest string |
StorageRequest defines the storage size required for this PVC, e.g., 1Gi, 100Mi. It specifies the storage capacity needed as part of ResourceRequirements. |
storageClassName string |
StorageClassName specifies the StorageClass name to which this persistent volume belongs, e.g., manual. It allows the PVC to use the characteristics defined by the StorageClass. |
volumeMode Kubernetes core/v1.PersistentVolumeMode |
VolumeMode specifies whether the volume should be used with a formatted filesystem (Filesystem) or remain in raw block state (Block). The Filesystem value is implied when not included. “Block” means the volume will not be formatted with a filesystem and will remain a raw block device. “Filesystem” means the volume will be or is formatted with a filesystem. |
This page was automatically generated with gen-crd-api-reference-docs
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.