설치 및 구성
OpenShift Pipelines 설치 및 구성
초록
1장. OpenShift Pipelines 설치 링크 복사링크가 클립보드에 복사되었습니다!
이 가이드에서는 클러스터 관리자에게 Red Hat OpenShift Pipelines Operator를 OpenShift Container Platform 클러스터에 설치하는 프로세스를 안내합니다.
사전 요구 사항
-
cluster-admin권한이 있는 계정을 사용하여 OpenShift Container Platform 클러스터에 액세스할 수 있습니다. -
ocCLI를 설치했습니다. -
로컬 시스템에
tkn(OpenShift Pipelines) CLI 를 설치했습니다. - 클러스터에 Marketplace 기능이 활성화되어 있거나 Red Hat Operator 카탈로그 소스가 수동으로 구성되어 있습니다.
Windows 및 Linux 노드가 모두 있는 클러스터에서 Red Hat OpenShift Pipelines는 Linux 노드에서만 실행할 수 있습니다.
1.1. 웹 콘솔에서 Red Hat OpenShift Pipelines Operator 설치 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Container Platform OperatorHub에 나열된 Operator를 사용하여 Red Hat OpenShift Pipelines를 설치할 수 있습니다. Red Hat OpenShift Pipelines Operator를 설치하면 파이프라인 구성에 필요한 CR(사용자 정의 리소스)이 Operator와 함께 자동으로 설치됩니다.
기본 Operator CRD(사용자 정의 리소스 정의) config.operator.tekton.dev가 tektonconfigs.operator.tekton.dev로 교체되었습니다. 또한 Operator에서 OpenShift Pipelines 구성 요소를 개별적으로 관리하기 위해 추가 CRD인 tektonpipelines.operator.tekton.dev, tektontriggers.operator.tekton.dev, tektonaddons.operator.tekton.dev를 제공합니다.
OpenShift Pipelines가 클러스터에 이미 설치되어 있는 경우 기존 설치가 원활하게 업그레이드됩니다. Operator는 필요에 따라 클러스터의 config.operator.tekton.dev 인스턴스를 tektonconfigs.operator.tekton.dev 인스턴스 및 기타 CRD의 추가 오브젝트로 교체합니다.
resource name - cluster 필드를 변경하여 config.operator.tekton.dev CRD 인스턴스의 타겟 네임스페이스를 변경하는 등 기존 설치를 수동으로 변경한 경우 업그레이드 경로가 제대로 작동하지 않습니다. 이러한 경우 권장되는 워크플로는 설치를 제거한 후 Red Hat OpenShift Pipelines Operator를 다시 설치하는 것입니다.
Red Hat OpenShift Pipelines Operator는 이제 TektonConfig CR(사용자 정의 리소스)의 일부로 프로필을 지정하여 설치할 구성 요소를 선택할 수 있는 옵션을 제공합니다. Operator가 설치되면 TektonConfig CR이 자동으로 설치됩니다. 지원되는 프로필은 다음과 같습니다.
- Lite: Tekton 파이프라인만 설치합니다.
- Basic: Tekton 파이프라인, Tekton 트리거 및 Tekton 체인을 설치합니다.
-
모두:
TektonConfigCR을 설치할 때 사용하는 기본 프로필입니다. 이 프로필은 Tekton Pipelines, Tekton Triggers, Tekton Chains, Pipelines as Code 및 Tekton Addons를 포함한 모든 Tekton 구성 요소를 설치합니다. Tekton Addons에는ClusterTasks,ClusterTriggerBindings,ConsoleCLIDownload,ConsoleQuickStart,ConsoleYAMLSample리소스와openshift-pipelines네임스페이스의 클러스터 확인기를 사용하여 사용할 수 있는 작업이 포함됩니다.
프로세스
- 웹 콘솔의 관리자 화면에서 Operator → OperatorHub로 이동합니다.
-
키워드로 필터링 박스를 사용하여 카탈로그에서
Red Hat OpenShift PipelinesOperator를 검색합니다. Red Hat OpenShift Pipelines Operator 타일을 클릭합니다. - Red Hat OpenShift Pipelines Operator 페이지에서 Operator에 대한 간략한 설명을 확인합니다. 설치를 클릭합니다.
Operator 설치 페이지에서 다음을 수행합니다.
-
Installation Mode로 All namespaces on the cluste(default)를 선택합니다. 이 모드에서는 기본
openshift-operators네임스페이스에 Operator가 설치되므로 Operator가 클러스터의 모든 네임스페이스를 감시하고 사용 가능하게 만들 수 있습니다. - Approval Strategy으로 Automatic을 선택합니다. 그러면 Operator에 향후 지원되는 업그레이드가 OLM(Operator Lifecycle Manager)에 의해 자동으로 처리됩니다. Manual 승인 전략을 선택하면 OLM에서 업데이트 요청을 생성합니다. 클러스터 관리자는 Operator를 새 버전으로 업데이트하려면 OLM 업데이트 요청을 수동으로 승인해야 합니다.
Update Channel을 선택합니다.
-
최신채널을 사용하면 Red Hat OpenShift Pipelines Operator의 최신 안정적인 버전을 설치할 수 있습니다. 현재 이 채널은 Red Hat OpenShift Pipelines Operator를 설치하는 기본 채널입니다. 특정 버전의 Red Hat OpenShift Pipelines Operator를 설치하기 위해 클러스터 관리자는 해당
pipelines-<version> 채널을 사용할 수 있습니다. 예를 들어 Red Hat OpenShift Pipelines Operator 버전1.8.x를 설치하려면pipelines-1.8채널을 사용할 수 있습니다.참고OpenShift Container Platform 4.11부터 Red Hat OpenShift Pipelines Operator를 설치하고 업그레이드하기 위한
프리뷰및안정적인채널을 사용할 수 없습니다. 그러나 OpenShift Container Platform 4.10 및 이전 버전에서는프리뷰및안정적인채널을 사용하여 Operator를 설치 및 업그레이드할 수 있습니다.
-
-
Installation Mode로 All namespaces on the cluste(default)를 선택합니다. 이 모드에서는 기본
설치를 클릭합니다. Installed Operators 페이지의 목록에 해당 Operator가 나타납니다.
참고Operator는
openshift-operators네임스페이스에 자동으로 설치됩니다.Red Hat OpenShift Pipelines Operator가 성공적으로 설치되었는지 확인하려면 상태가 최신 업데이트 완료로 설정되어 있는지 확인합니다.
주의다른 구성 요소의 설치에 진행 중인 경우에도 성공 상태가 최신 업데이트로 표시될 수 있습니다. 따라서 터미널에서 수동으로 설치를 확인하는 것이 중요합니다.
Red Hat OpenShift Pipelines Operator의 모든 구성 요소가 성공적으로 설치되었는지 확인합니다. 터미널에서 클러스터에 로그인하고 다음 명령을 실행합니다.
oc get tektonconfig config
$ oc get tektonconfig configCopy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME VERSION READY REASON config 1.15.0 True
NAME VERSION READY REASON config 1.15.0 TrueCopy to Clipboard Copied! Toggle word wrap Toggle overflow READY 조건이 True 이면 Operator 및 해당 구성 요소가 성공적으로 설치됩니다.
Additonally, 다음 명령을 실행하여 구성 요소의 버전을 확인합니다.
oc get tektonpipeline,tektontrigger,tektonchain,tektonaddon,pac
$ oc get tektonpipeline,tektontrigger,tektonchain,tektonaddon,pacCopy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
1.2. CLI를 사용하여 OpenShift Pipelines Operator 설치 링크 복사링크가 클립보드에 복사되었습니다!
CLI(명령줄 인터페이스)를 사용하여 OperatorHub에서 Red Hat OpenShift Pipelines Operator를 설치할 수 있습니다.
프로세스
Subscription오브젝트 YAML 파일을 생성하여 Red Hat OpenShift Pipelines Operator에 네임스페이스를 서브스크립션합니다(예:sub.yaml).SubscriptionYAML의 예Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- 서브스크립션할 채널의 이름입니다.
pipelines-<version> 채널은 기본 채널입니다. 예를 들어 Red Hat OpenShift Pipelines Operator 버전1.7의 기본 채널은pipelines-1.7입니다.최신채널을 사용하면 Red Hat OpenShift Pipelines Operator의 최신 안정적인 버전을 설치할 수 있습니다. - 2
- 등록할 Operator의 이름입니다.
- 3
- Operator를 제공하는
CatalogSource오브젝트의 이름입니다. - 4
CatalogSource오브젝트의 네임스페이스입니다. 기본 OperatorHub 카탈로그 소스에는openshift-marketplace를 사용합니다.
다음 명령을 실행하여
Subscription오브젝트를 생성합니다.oc apply -f sub.yaml
$ oc apply -f sub.yamlCopy to Clipboard Copied! Toggle word wrap Toggle overflow 서브스크립션은 Red Hat OpenShift Pipelines Operator를
openshift-operators네임스페이스에 설치합니다. Operator는 OpenShift Pipelines를 기본openshift-pipelines대상 네임스페이스에 자동으로 설치합니다.
1.3. 제한된 환경의 Red Hat OpenShift Pipelines Operator 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift Pipelines Operator는 제한된 네트워크 환경에서 파이프라인 설치를 지원합니다.
Operator는 cluster 프록시 오브젝트를 기반으로 tekton-controller에서 생성한 Pod의 컨테이너에 프록시 환경 변수를 설정하는 프록시 Webhook를 설치합니다. 또한 TektonPipelines, TektonTriggers, Controllers, Webhooks, Operator Proxy Webhook 리소스에서 프록시 환경 변수를 설정합니다.
기본적으로 프록시 Webhook는 openshift-pipelines 네임스페이스에 대해 비활성화되어 있습니다. 다른 네임스페이스에 대해 비활성화하려면 namespace 오브젝트에 operator.tekton.dev/disable-proxy: true 라벨을 추가하면 됩니다.
2장. OpenShift Pipelines 설치 제거 링크 복사링크가 클립보드에 복사되었습니다!
클러스터 관리자는 다음 단계를 수행하여 Red Hat OpenShift Pipelines Operator를 설치 제거할 수 있습니다.
선택적 구성 요소인
TektonHub및TektonResult의 CR(사용자 정의 리소스)을 삭제하고TektonConfigCR을 삭제합니다.Important선택적 구성 요소의 CR을 제거하지 않고 Operator를 설치 제거하는 경우 나중에 구성 요소를 제거할 수 없습니다.
- Red Hat OpenShift Pipelines Operator를 설치 제거합니다.
-
operator.tekton.dev그룹의 CRD(Custom Resource Definitions)를 삭제합니다.
Operator를 설치 제거하는 것만으로 설치 과정에서 기본적으로 생성된 Red Hat OpenShift Pipelines 구성 요소가 제거되지는 않습니다.
2.1. OpenShift Pipelines 사용자 정의 리소스 삭제 링크 복사링크가 클립보드에 복사되었습니다!
선택적 구성 요소의 CR(사용자 정의 리소스)인 TektonHub 및 TektonResult 가 있는 경우 이러한 CR을 삭제합니다. 그런 다음 TektonConfig CR을 삭제합니다.
프로세스
- 웹 콘솔의 관리자 화면에서 Administration → CustomResourceDefinitions 로 이동합니다.
-
Filter by name 필드에
TektonHub를 입력하여TektonHubCRD(Custom Resource Definition)를 검색합니다. -
TektonHubCRD의 이름을 클릭하여 CRD 세부 정보 페이지를 표시합니다. -
Instances탭을 클릭합니다. -
인스턴스가 표시되면 표시된 인스턴스의 옵션 메뉴
를 클릭합니다.
- TektonHub 삭제를 선택합니다.
- Delete 를 클릭하여 CR 삭제를 확인합니다.
-
이러한 단계를 반복하여
TektonResult를 검색한 다음 Filter by name 상자에서TektonConfig를 검색합니다. 이러한 CRD에 대한 인스턴스가 있는 경우 이러한 인스턴스를 삭제합니다.
CR을 삭제하면 클러스터의 Red Hat OpenShift Pipelines 구성 요소와 모든 작업 및 파이프라인도 삭제됩니다.
TektonHub 및 TektonResult CR을 제거하지 않고 Operator를 설치 제거하는 경우 나중에 Tekton Hub 및 Tekton Results 구성 요소를 제거할 수 없습니다.
2.2. Red Hat OpenShift Pipelines Operator 설치 제거 링크 복사링크가 클립보드에 복사되었습니다!
웹 콘솔의 관리자 화면을 사용하여 Red Hat OpenShift Pipelines Operator를 설치 제거할 수 있습니다.
프로세스
- Operators → OperatorHub 페이지에서 키워드로 필터링 박스를 사용하여 Red Hat OpenShift Pipelines Operator를 검색합니다.
- Red Hat OpenShift Pipelines Operator 타일을 클릭합니다. Operator 타일은 Operator가 설치되었음을 나타냅니다.
- Red Hat OpenShift Pipelines Operator 설명 페이지에서 설치 제거를 클릭합니다.
- Operator 설치 제거? 창에서 이 Operator의 모든 피연산자 인스턴스 삭제를 선택한 다음 제거를 클릭합니다.
OpenShift Pipelines Operator를 설치 제거할 때 구성한 시크릿을 포함하여 OpenShift Pipelines가 설치된 openshift-pipelines 대상 네임스페이스 내의 모든 리소스가 손실됩니다.
2.3. operator.tekton.dev 그룹의 사용자 정의 리소스 정의 삭제 링크 복사링크가 클립보드에 복사되었습니다!
operator.tekton.dev 그룹의 CRD(Custom Resource Definitions)를 삭제합니다. 이러한 CRD는 Red Hat OpenShift Pipelines Operator를 설치하는 동안 기본적으로 생성됩니다.
프로세스
- 웹 콘솔의 관리자 화면에서 Administration → CustomResourceDefinitions 로 이동합니다.
-
이름으로 필터링 상자에
operator.tekton.dev를 입력하여operator.tekton.dev그룹에서 CRD를 검색합니다. 표시된 각 CRD를 삭제하려면 다음 단계를 완료합니다.
-
옵션 메뉴
를 클릭합니다.
- Delete CustomResourceDefinition 을 선택합니다.
- Delete 를 클릭하여 CRD 삭제를 확인합니다.
-
옵션 메뉴
3장. TektonConfig 사용자 정의 리소스에서 구성 사용자 정의 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift Pipelines에서는 TektonConfig CR(사용자 정의 리소스)을 사용하여 다음 구성을 사용자 지정할 수 있습니다.
- OpenShift Pipelines 컨트롤러의 고가용성 모드를 포함한 OpenShift Pipelines 성능 최적화
- Red Hat OpenShift Pipelines Control Plane 구성
- 기본 서비스 계정 변경
- 서비스 모니터 비활성화
- 파이프라인 확인기 구성
- 클러스터 작업 및 파이프라인 템플릿 비활성화
- Tekton Hub 통합 비활성화
- RBAC 리소스의 자동 생성 비활성화
- 작업 실행 및 파이프라인 실행 정리
3.1. 사전 요구 사항 링크 복사링크가 클립보드에 복사되었습니다!
- Red Hat OpenShift Pipelines Operator를 설치했습니다.
3.2. TektonConfig CR을 사용한 성능 튜닝 링크 복사링크가 클립보드에 복사되었습니다!
TektonConfig CR(사용자 정의 리소스)의 .spec.pipeline.performance 매개변수 아래에 있는 필드를 수정하여 OpenShift Pipelines 컨트롤러의 HA(고가용성) 지원 및 성능 구성을 변경할 수 있습니다.
TektonConfig 성능 필드의 예
모든 필드는 선택 사항입니다. 이를 설정하면 Red Hat OpenShift Pipelines Operator에 대부분의 필드가 openshift-pipelines-controller 컨테이너의 openshift-pipelines-controller 배포에 인수로 포함됩니다. OpenShift Pipelines Operator는 openshift-pipelines 네임스페이스의 config-leader-election 구성 맵의 buckets 필드도 업데이트합니다.
값을 지정하지 않으면 OpenShift Pipelines Operator에서 해당 필드를 업데이트하지 않고 OpenShift Pipelines 컨트롤러의 기본값을 적용합니다.
성능 필드를 수정하거나 제거하는 경우 OpenShift Pipelines Operator는 openshift-pipelines-controller 배포 및 config-leader-election 구성 맵( buckets 필드가 변경된 경우) 구성 맵을 업데이트하고 openshift-pipelines-controller Pod를 다시 생성합니다.
HA(고가용성) 모드는 파이프라인 실행 및 작업 실행 정의를 기반으로 Pod를 생성하고 시작하는 OpenShift Pipelines 컨트롤러에 적용됩니다. HA 모드가 없으면 단일 Pod가 이러한 작업을 실행하여 로드가 길어지고 상당한 지연이 발생할 수 있습니다.
HA 모드에서 OpenShift Pipelines는 여러 Pod(복제본)를 사용하여 이러한 작업을 실행합니다. 처음에는 OpenShift Pipelines에서 모든 컨트롤러 작업을 버킷에 할당합니다. 각 복제본은 하나 이상의 버킷에서 작업을 선택합니다. 두 복제본이 동시에 동일한 작업을 선택할 수 있는 경우 컨트롤러는 내부적으로 이 작업을 실행하는 리더를 결정합니다.
HA 모드는 Pod를 생성한 후 작업 실행 실행에 영향을 미치지 않습니다.
| 이름 | 설명 | OpenShift Pipelines 컨트롤러의 기본값 |
|---|---|---|
|
| HA(고가용성) 모드를 활성화하거나 비활성화합니다. 기본적으로 HA 모드는 활성화됩니다. |
|
|
|
HA 모드에서 컨트롤러 작업을 처리하는 데 사용되는 버킷 수입니다. 최대값은 |
|
|
|
HA 모드에서 컨트롤러 작업을 처리하기 위해 생성된 Pod 수입니다. 이 값을 |
|
|
| OpenShift Pipelines 컨트롤러의 작업 대기열이 처리될 때 사용할 스레드(작업자) 수입니다. |
|
|
| REST 클라이언트에서 클러스터 마스터에 대한 초당 최대 쿼리(QPS)입니다. |
|
|
| 스로틀의 최대 버스트입니다. |
|
OpenShift Pipelines Operator는 OpenShift Pipelines 컨트롤러의 복제본 수를 제어하지 않습니다. 배포의 replicas 설정에 따라 복제본 수가 결정됩니다. 예를 들어 복제본 수를 3으로 변경하려면 다음 명령을 입력합니다.
oc --namespace openshift-pipelines scale deployment openshift-pipelines-controller --replicas=3
$ oc --namespace openshift-pipelines scale deployment openshift-pipelines-controller --replicas=3
OpenShift Pipelines 컨트롤러에서 kube-api-qps 및 kube-api-burst 필드에 2를 곱합니다. 예를 들어 kube-api-qps 및 kube-api-burst 값이 10 이면 실제 QPS 및 burst 값은 20 이 됩니다.
3.3. Red Hat OpenShift Pipelines Control Plane 구성 링크 복사링크가 클립보드에 복사되었습니다!
TektonConfig CR(사용자 정의 리소스)에서 구성 필드를 편집하여 OpenShift Pipelines 컨트롤 플레인을 사용자 지정할 수 있습니다. Red Hat OpenShift Pipelines Operator는 OpenShift Pipelines 컨트롤 플레인을 사용할 수 있도록 기본값을 사용하여 구성 필드를 자동으로 추가합니다.
프로세스
- 웹 콘솔의 관리자 화면에서 Administration → CustomResourceDefinitions 로 이동합니다.
-
이름으로 검색 상자를 사용하여
tektonconfigs.operator.tekton.devCRD(사용자 정의 리소스 정의)를 검색합니다. TektonConfig 를 클릭하여 CRD 세부 정보 페이지를 확인합니다. - Instances 탭을 클릭합니다.
-
config 인스턴스를 클릭하여
TektonConfigCR 세부 정보를 확인합니다. - YAML 탭을 클릭합니다.
요구 사항에 따라
TektonConfigYAML 파일을 편집합니다.기본값이 있는
TektonConfigCR의 예Copy to Clipboard Copied! Toggle word wrap Toggle overflow
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: 이 필드에는 모든TaskRunPod에 적용되는app.kubernetes.io/managed-by라벨에 지정된 기본값이 포함되어 있습니다. 예:default-managed-by-label-value: tekton-pipelines. -
default-pod-template: 이 필드는 지정되지 않은 경우 기본TaskRun및PipelineRunPod 템플릿을 설정합니다. -
default-cloud-events-sink: 이 필드는 지정되지 않은 경우TaskRun및PipelineRun리소스에 사용되는 기본CloudEvents싱크를 설정합니다. -
default-task-run-workspace-binding: 이 필드에는Task리소스에서 선언하는 작업 공간에 대한 기본 작업 공간 구성이 포함되어 있지만TaskRun리소스는 명시적으로 선언하지 않습니다. -
default-affinity-assistant-pod-template: 이 필드는 유사성 도우미 Pod에 사용되는 기본PipelineRunPod 템플릿을 설정합니다. -
default-max-matrix-combinations-count: 이 필드에는 매트릭스에서 생성된 기본 최대 조합 수가 포함됩니다.
3.4. OpenShift Pipelines의 기본 서비스 계정 변경 링크 복사링크가 클립보드에 복사되었습니다!
.spec.pipeline 및 .spec.trigger 사양에서 default-service-account 필드를 편집하여 OpenShift Pipelines의 기본 서비스 계정을 변경할 수 있습니다. 기본 서비스 계정 이름은 pipeline 입니다.
예
3.5. OpenShift Pipelines 설치 네임스페이스에 대한 라벨 및 주석 설정 링크 복사링크가 클립보드에 복사되었습니다!
Operator가 OpenShift Pipelines를 설치하는 openshift-pipelines 네임스페이스에 대한 레이블 및 주석을 설정할 수 있습니다.
openshift-pipelines 네임스페이스의 이름 변경은 지원되지 않습니다.
TektonConfig CR(사용자 정의 리소스)의 spec.targetNamespaceMetadata 사양에 추가하여 레이블 및 주석을 지정합니다.
openshift-pipelines 네임스페이스에 대한 레이블 및 주석 설정 예
3.6. 서비스 모니터 비활성화 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift Pipelines의 일부인 서비스 모니터를 비활성화하여 Telemetry 데이터를 노출할 수 있습니다. 서비스 모니터를 비활성화하려면 TektonConfig CR(사용자 정의 리소스)의 .spec.pipeline 사양에서 enableMetrics 매개변수를 false 로 설정합니다.
예
3.7. 파이프라인 확인기 구성 링크 복사링크가 클립보드에 복사되었습니다!
TektonConfig CR(사용자 정의 리소스)에서 파이프라인 해석기를 구성할 수 있습니다. 이러한 파이프라인 확인기를 활성화하거나 비활성화할 수 있습니다.
-
enable-bundles-resolver -
enable-cluster-resolver -
enable-git-resolver -
enable-hub-resolver
예
TektonConfig CR에 해결자 특정 구성을 제공할 수도 있습니다. 예를 들어 map[string]string 형식으로 다음 필드를 정의하여 각 파이프라인 확인자에 대한 구성을 설정합니다.
예
3.8. 클러스터 작업 및 파이프라인 템플릿 비활성화 링크 복사링크가 클립보드에 복사되었습니다!
기본적으로 TektonAddon CR(사용자 정의 리소스)은 클러스터의 OpenShift Pipelines와 함께 clusterTasks 및 pipelineTemplates 리소스를 설치합니다.
.spec.addon 사양에서 매개변수 값을 false 로 설정하여 clusterTasks 및 pipelineTemplates 리소스 설치를 비활성화할 수 있습니다. 또한 communityClusterTasks 매개변수를 비활성화할 수 있습니다.
예
Red Hat OpenShift Pipelines 1.10에서 ClusterTask 기능은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.
3.9. Tekton Hub 통합 비활성화 링크 복사링크가 클립보드에 복사되었습니다!
TektonConfig CR(사용자 정의 리소스)에서 enable-devconsole-integration 매개변수를 false 로 설정하여 웹 콘솔 개발자 화면에서 Tekton Hub의 통합을 비활성화할 수 있습니다.
Tekton Hub 비활성화 예
3.10. RBAC 리소스의 자동 생성 비활성화 링크 복사링크가 클립보드에 복사되었습니다!
Red Hat OpenShift Pipelines Operator의 기본 설치는 ^(openshift|kube)-* 정규식 패턴과 일치하는 네임스페이스를 제외하고 클러스터의 모든 네임스페이스에 대해 여러 개의 RBAC(역할 기반 액세스 제어) 리소스를 생성합니다. 이러한 RBAC 리소스 중에서 pipelines-scc-rolebinding SCC(보안 컨텍스트 제약 조건) 역할 바인딩 리소스는 연결된 pipelines-scc SCC에 RunAsAny 권한이 있으므로 잠재적인 보안 문제입니다.
Red Hat OpenShift Pipelines Operator가 설치된 후 클러스터 전체 RBAC 리소스의 자동 생성을 비활성화하려면 클러스터 관리자가 클러스터 수준 TektonConfig CR(사용자 정의 리소스)에서 createRbacResource 매개변수를 false 로 설정할 수 있습니다.
TektonConfig CR의 예
클러스터 관리자 또는 적절한 권한이 있는 사용자는 모든 네임스페이스에 대한 RBAC 리소스 자동 생성을 비활성화하면 기본 ClusterTask 리소스가 작동하지 않습니다. ClusterTask 리소스가 작동하려면 의도한 각 네임스페이스에 대해 RBAC 리소스를 수동으로 생성해야 합니다.
3.11. 파이프라인 및 작업의 인라인 사양 비활성화 링크 복사링크가 클립보드에 복사되었습니다!
기본적으로 OpenShift Pipelines는 다음과 같은 경우 파이프라인 및 작업의 인라인 사양을 지원합니다.
다음 예와 같이 하나 이상의 작업 사양을 포함하는
PipelineCR을 생성할 수 있습니다.PipelineCR의 인라인 사양의 예Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 예와 같이 파이프라인 사양을 포함하는
PipelineRunCR(사용자 정의 리소스)을 생성할 수 있습니다.PipelineRunCR의 인라인 사양의 예Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 예와 같이 작업 사양을 포함하는
TaskRunCR(사용자 정의 리소스)을 생성할 수 있습니다.TaskRunCR의 인라인 사양의 예Copy to Clipboard Copied! Toggle word wrap Toggle overflow
이러한 경우 일부 또는 전부에서 인라인 사양을 비활성화할 수 있습니다. 인라인 사양을 비활성화하려면 다음 예와 같이 TektonConfig CR의 .spec.pipeline 사양의 disable-inline-spec 필드를 설정합니다.
인라인 사양을 비활성화하는 구성 예
disable-inline-spec 매개변수를 단일 값 또는 여러 값의 쉼표로 구분된 목록으로 설정할 수 있습니다. 매개변수의 다음 값은 유효합니다.
| 현재의 | 설명 |
|---|---|
|
|
|
|
|
|
|
|
|
3.12. 작업 실행 및 파이프라인 실행 자동 정리 링크 복사링크가 클립보드에 복사되었습니다!
오래된 TaskRun 및 PipelineRun 오브젝트와 실행된 인스턴스는 활성 실행에 사용할 수 있는 물리적 리소스를 차지합니다. 이러한 리소스를 최적으로 사용하기 위해 Red Hat OpenShift Pipelines는 다양한 네임스페이스에서 사용하지 않는 오브젝트와 해당 인스턴스를 자동으로 제거하는 정리기 구성 요소를 제공합니다.
TektonConfig 사용자 정의 리소스를 사용하여 전체 설치에 대한 정리기를 구성하고 네임스페이스 주석을 사용하여 네임스페이스 구성을 수정할 수 있습니다. 그러나 네임스페이스에서 개별 작업 실행 또는 파이프라인 실행을 선택적으로 자동 실행할 수 없습니다.
3.12.1. pruner 구성 링크 복사링크가 클립보드에 복사되었습니다!
TektonConfig 사용자 지정 리소스를 사용하여 파이프라인 실행 및 작업 실행과 관련된 리소스의 주기적 정리를 구성할 수 있습니다.
다음 예제는 기본 구성에 해당합니다.
정리기 구성의 예
| 매개변수 | 설명 |
|---|---|
|
| 정리 프로세스 실행을 위한 Cron 스케줄입니다. 기본 일정은 매일 08:00에 프로세스를 실행합니다. Cron 일정 구문에 대한 자세한 내용은 Kubernetes 문서의 Cron schedule 구문을 참조하십시오. |
|
|
pruner가 적용되는 리소스 유형입니다. 사용 가능한 리소스 유형은 |
|
| 유지할 모든 유형의 최근 리소스 수입니다. |
|
|
|
|
|
리소스를 유지할 최대 시간(분)입니다. 예를 들어 5일 전에 생성된 리소스를 유지하려면 |
|
| 이 매개변수는 선택 사항입니다. 예약된 시간에 어떤 이유로든 정리기 작업이 시작되지 않는 경우 이 설정은 작업을 계속 시작할 수 있는 최대 시간(초)을 구성합니다. 지정된 시간 내에 작업이 시작되지 않으면 OpenShift Pipelines에서 이 작업이 실패했다고 간주하고 다음 예약된 시간에 정리기를 시작합니다. 이 매개변수를 지정하지 않고 예약된 시간에 pruner 작업이 시작되지 않으면 OpenShift Pipelines에서 작업을 나중에 시작할 수 있습니다. |
keep 및 keep-since 매개변수는 함께 사용할 수 없습니다. 구성에 해당 중 하나만 사용합니다.
3.12.2. 작업 실행 및 파이프라인 실행을 자동으로 정리하기 위한 주석 링크 복사링크가 클립보드에 복사되었습니다!
네임스페이스에서 작업 실행 및 파이프라인 실행 자동 정리 구성을 수정하려면 네임스페이스에 주석을 설정할 수 있습니다.
다음 namespace 주석은 TektonConfig 사용자 정의 리소스의 해당 키와 동일한 의미를 갖습니다.
-
operator.tekton.dev/prune.schedule -
operator.tekton.dev/prune.resources -
operator.tekton.dev/prune.keep -
operator.tekton.dev/prune.prune-per-resource -
operator.tekton.dev/prune.keep-since
operator.tekton.dev/prune.resources 주석은 쉼표로 구분된 목록을 허용합니다. 작업 실행 및 파이프라인 실행을 모두 정리하려면 이 주석을 "taskrun, pipelinerun" 으로 설정합니다.
다음과 같은 추가 네임스페이스 주석을 사용할 수 있습니다.
-
operator.tekton.dev/prune.skip:true로 설정하면 주석이 구성된 네임스페이스가 정리되지 않습니다. -
operator.tekton.dev/prune.strategy: 이 주석의 값을keep또는keep-since로 설정합니다.
예를 들어 다음 주석은 지난 5일 동안 생성된 모든 작업 실행 및 파이프라인 실행을 유지하고 이전 리소스를 삭제합니다.
자동 실행 주석의 예