3.3. Red Hat OpenShift Pipelines Control Plane 구성
TektonConfig
CR(사용자 정의 리소스)에서 구성 필드를 편집하여 OpenShift Pipelines 컨트롤 플레인을 사용자 지정할 수 있습니다. Red Hat OpenShift Pipelines Operator는 OpenShift Pipelines 컨트롤 플레인을 사용할 수 있도록 기본값을 사용하여 구성 필드를 자동으로 추가합니다.
프로세스
-
웹 콘솔의 관리자 화면에서 Administration
CustomResourceDefinitions 로 이동합니다. -
이름으로 검색 상자를 사용하여
tektonconfigs.operator.tekton.dev
CRD(사용자 정의 리소스 정의)를 검색합니다. TektonConfig 를 클릭하여 CRD 세부 정보 페이지를 확인합니다. - Instances 탭을 클릭합니다.
-
config 인스턴스를 클릭하여
TektonConfig
CR 세부 정보를 확인합니다. - YAML 탭을 클릭합니다.
요구 사항에 따라
TektonConfig
YAML 파일을 편집합니다.기본값이 있는
TektonConfig
CR의 예apiVersion: operator.tekton.dev/v1alpha1 kind: TektonConfig metadata: name: config spec: pipeline: running-in-environment-with-injected-sidecars: true metrics.taskrun.duration-type: histogram metrics.pipelinerun.duration-type: histogram await-sidecar-readiness: true params: - name: enableMetrics value: 'true' default-service-account: pipeline require-git-ssh-secret-known-hosts: false enable-tekton-oci-bundles: false metrics.taskrun.level: task metrics.pipelinerun.level: pipeline enable-api-fields: stable enable-provenance-in-status: false enable-custom-tasks: true disable-creds-init: false disable-affinity-assistant: true
3.3.1. 기본값을 사용하여 수정 가능한 필드
다음 목록에는 TektonConfig
CR에 기본값이 있는 모든 수정 가능한 필드가 포함되어 있습니다.
running-in-environment-with-injected-sidecars
(기본값:true
): Istio와 같은 삽입된 사이드카를 사용하지 않는 클러스터에서 파이프라인이 실행되는 경우 이 필드를false
로 설정합니다.false
로 설정하면 파이프라인이 작업 실행을 시작하는 데 걸리는 시간이 줄어듭니다.참고삽입된 사이드카를 사용하는 클러스터의 경우 이 필드를
false
로 설정하면 예기치 않은 동작이 발생할 수 있습니다.-
await-sidecar-readiness
(기본값:true
): OpenShift Pipelines가 작동을 시작하기 전에TaskRun
사이드카 컨테이너가 실행될 때까지 대기하지 못하도록 이 필드를false
로 설정합니다. 이를 통해DownwardAPI
볼륨 유형을 지원하지 않는 환경에서 작업을 실행할 수 있습니다. -
default-service-account
(기본값:pipeline
): 이 필드에는TaskRun
및PipelineRun
리소스에 사용할 기본 서비스 계정 이름이 포함되어 있습니다. require-git-ssh-secret-known-hosts
(기본값:false
): 이 필드를true
로 설정하려면 Git SSH 시크릿에known_hosts
필드를 포함해야 합니다.- Git SSH 시크릿 구성에 대한 자세한 내용은 추가 리소스 섹션에서 Git에 대한 SSH 인증 구성 을 참조하십시오.
-
enable-tekton-oci-bundles
(기본값:false
): Tekton OCI 번들이라는 실험적인 알파 기능을 사용할 수 있도록 이 필드를true
로 설정합니다. enable-api-fields
(기본값:stable
): 이 필드를 설정하면 활성화된 기능이 결정됩니다. 허용 가능한 값은stable
,beta
또는alpha
입니다.참고Red Hat OpenShift Pipelines는
알파
값을 지원하지 않습니다.-
enable-provenance-in-status
(기본값:false
):TaskRun
및PipelineRun
상태의 검증 필드를 채울 수 있도록 이 필드를true
로 설정합니다.provenance
필드에
는 원격 작업 또는 파이프라인 정의가 가져온 소스의 소스와 같이 작업 실행 및 파이프라인 실행에 사용되는 리소스에 대한 메타데이터가 포함되어 있습니다. -
enable-custom-tasks
(기본값:true
): 파이프라인에서 사용자 지정 작업 사용을 비활성화하려면 이 필드를false
로 설정합니다. -
disable-creds-init
(기본값:false
): OpenShift Pipelines에서 연결된 서비스 계정을 스캔하고 단계에 인증 정보를 삽입하지 못하도록 이 필드를true
로 설정합니다. -
disable-affinity-assistant
(기본값:true
): 영구 볼륨 클레임 작업 공간을 공유하는 각TaskRun
리소스의 선호도 도우미를 활성화하려면 이 필드를false
로 설정합니다.
메트릭 옵션
TektonConfig
CR에서 다음 메트릭 필드의 기본값을 수정할 수 있습니다.
-
metrics.taskrun.duration-type
및metrics.pipelinerun.duration-type
(기본값:히스토그램
): 이러한 필드를 설정하면 작업 또는 파이프라인 실행의 기간 유형이 결정됩니다. 허용 가능한 값은게이지
또는히스토그램입니다
. -
metrics.taskrun.level
(기본값:작업
): 이 필드는 작업 실행 메트릭의 수준을 결정합니다. 허용 가능한 값은taskrun
,task
또는namespace
입니다. -
metrics.pipelinerun.level
(기본값:pipeline
): 이 필드는 파이프라인 실행 메트릭의 수준을 결정합니다. 허용되는 값은pipelinerun
,pipeline
또는namespace
입니다.
3.3.2. 선택적 구성 필드
다음 필드에는 기본값이 없으며 구성하는 경우에만 간주됩니다. 기본적으로 Operator는 TektonConfig
CR(사용자 정의 리소스)에서 이러한 필드를 추가하고 구성하지 않습니다.
-
default-timeout-minutes
: 이 필드는 생성할 때 지정되지 않은 경우TaskRun
및PipelineRun
리소스에 대한 기본 시간 초과를 설정합니다. 작업 실행 또는 파이프라인 실행이 설정된 시간(분)보다 더 많은 시간이 걸리면 작업 실행 또는 파이프라인 실행이 시간 초과되고 취소됩니다. 예를 들어default-timeout-minutes: 60
은 60분을 기본값으로 설정합니다. -
default-managed-by-label-value
: 이 필드에는 모든TaskRun
Pod에 적용되는app.kubernetes.io/managed-by
라벨에 지정된 기본값이 포함되어 있습니다. 예:default-managed-by-label-value: tekton-pipelines
. -
default-pod-template
: 이 필드는 지정되지 않은 경우 기본TaskRun
및PipelineRun
Pod 템플릿을 설정합니다. -
default-cloud-events-sink
: 이 필드는 지정되지 않은 경우TaskRun
및PipelineRun
리소스에 사용되는 기본CloudEvents
싱크를 설정합니다. -
default-task-run-workspace-binding
: 이 필드에는Task
리소스에서 선언하는 작업 공간에 대한 기본 작업 공간 구성이 포함되어 있지만TaskRun
리소스는 명시적으로 선언하지 않습니다. -
default-affinity-assistant-pod-template
: 이 필드는 유사성 도우미 Pod에 사용되는 기본PipelineRun
Pod 템플릿을 설정합니다. -
default-max-matrix-combinations-count
: 이 필드에는 매트릭스에서 생성된 기본 최대 조합 수가 포함됩니다.