Pipeline API reference

Detailed documentation on the Pipeline API

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
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

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