설치 및 구성

프로세스

1. 웹 콘솔의 관리자 화면에서 Operator → OperatorHub로 이동합니다.
2. 키워드로 필터링 박스를 사용하여 카탈로그에서 Red Hat OpenShift Pipelines Operator를 검색합니다. Red Hat OpenShift Pipelines Operator 타일을 클릭합니다.
3. Red Hat OpenShift Pipelines Operator 페이지에서 Operator에 대한 간략한 설명을 확인합니다. 설치를 클릭합니다.

4. Operator 설치 페이지에서 다음을 수행합니다.

   1. Installation Mode로 All namespaces on the cluste(default)를 선택합니다. 이 모드에서는 기본 openshift-operators 네임스페이스에 Operator가 설치되므로 Operator가 클러스터의 모든 네임스페이스를 감시하고 사용 가능하게 만들 수 있습니다.
   2. Approval Strategy으로 Automatic을 선택합니다. 그러면 Operator에 향후 지원되는 업그레이드가 OLM(Operator Lifecycle Manager)에 의해 자동으로 처리됩니다. Manual 승인 전략을 선택하면 OLM에서 업데이트 요청을 생성합니다. 클러스터 관리자는 Operator를 새 버전으로 업데이트하려면 OLM 업데이트 요청을 수동으로 승인해야 합니다.

   3. 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를 설치 및 업그레이드할 수 있습니다.

5. 설치를 클릭합니다. Installed Operators 페이지의 목록에 해당 Operator가 나타납니다.

   참고

   Operator는 openshift-operators 네임스페이스에 자동으로 설치됩니다.

6. Red Hat OpenShift Pipelines Operator가 성공적으로 설치되었는지 확인하려면 상태가 최신 업데이트 완료로 설정되어 있는지 확인합니다.

   주의

   다른 구성 요소의 설치에 진행 중인 경우에도 성공 상태가 최신 업데이트로 표시될 수 있습니다. 따라서 터미널에서 수동으로 설치를 확인하는 것이 중요합니다.

7. Red Hat OpenShift Pipelines Operator의 모든 구성 요소가 성공적으로 설치되었는지 확인합니다. 터미널에서 클러스터에 로그인하고 다음 명령을 실행합니다.

   $ oc get tektonconfig config

   출력 예

   NAME     VERSION   READY   REASON
   config   1.15.0     True

   READY 조건이 True 이면 Operator 및 해당 구성 요소가 성공적으로 설치됩니다.

   Additonally, 다음 명령을 실행하여 구성 요소의 버전을 확인합니다.

   $ oc get tektonpipeline,tektontrigger,tektonchain,tektonaddon,pac

   출력 예

   NAME                                          VERSION   READY   REASON
   tektonpipeline.operator.tekton.dev/pipeline   v0.47.0   True
   
   NAME                                        VERSION   READY   REASON
   tektontrigger.operator.tekton.dev/trigger   v0.23.1   True
   
   NAME                                    VERSION   READY   REASON
   tektonchain.operator.tekton.dev/chain   v0.16.0   True
   
   NAME                                    VERSION   READY   REASON
   tektonaddon.operator.tekton.dev/addon   1.11.0     True
   
   NAME                                                             VERSION   READY   REASON
   openshiftpipelinesascode.operator.tekton.dev/pipelines-as-code   v0.19.0   True

프로세스

1. Subscription 오브젝트 YAML 파일을 생성하여 Red Hat OpenShift Pipelines Operator에 네임스페이스를 서브스크립션합니다(예: sub.yaml ).

   Subscription YAML의 예

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: openshift-pipelines-operator
     namespace: openshift-operators
   spec:
     channel:  <channel_name> 1
     name: openshift-pipelines-operator-rh 2
     source: redhat-operators 3
     sourceNamespace: openshift-marketplace 4

   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를 사용합니다.

2. 다음 명령을 실행하여 Subscription 오브젝트를 생성합니다.

   $ oc apply -f sub.yaml

   서브스크립션은 Red Hat OpenShift Pipelines Operator를 openshift-operators 네임스페이스에 설치합니다. Operator는 OpenShift Pipelines를 기본 openshift-pipelines 대상 네임스페이스에 자동으로 설치합니다.

프로세스

1. 웹 콘솔의 관리자 화면에서 Administration → CustomResourceDefinitions 로 이동합니다.
2. Filter by name 필드에 TektonHub 를 입력하여 TektonHub CRD(Custom Resource Definition)를 검색합니다.
3. TektonHub CRD의 이름을 클릭하여 CRD 세부 정보 페이지를 표시합니다.
4. Instances 탭을 클릭합니다.
5. 인스턴스가 표시되면 표시된 인스턴스의 옵션 메뉴 를 클릭합니다.
6. TektonHub 삭제를 선택합니다.
7. Delete 를 클릭하여 CR 삭제를 확인합니다.
8. 이러한 단계를 반복하여 TektonResult 를 검색한 다음 Filter by name 상자에서 TektonConfig 를 검색합니다. 이러한 CRD에 대한 인스턴스가 있는 경우 이러한 인스턴스를 삭제합니다.

프로세스

1. Operators → OperatorHub 페이지에서 키워드로 필터링 박스를 사용하여 Red Hat OpenShift Pipelines Operator를 검색합니다.
2. Red Hat OpenShift Pipelines Operator 타일을 클릭합니다. Operator 타일은 Operator가 설치되었음을 나타냅니다.
3. Red Hat OpenShift Pipelines Operator 설명 페이지에서 설치 제거를 클릭합니다.
4. Operator 설치 제거? 창에서 이 Operator의 모든 피연산자 인스턴스 삭제를 선택한 다음 제거를 클릭합니다.

프로세스

1. 웹 콘솔의 관리자 화면에서 Administration → CustomResourceDefinitions 로 이동합니다.
2. 이름으로 필터링 상자에 operator.tekton.dev 를 입력하여 operator.tekton.dev 그룹에서 CRD를 검색합니다.

3. 표시된 각 CRD를 삭제하려면 다음 단계를 완료합니다.

   1. 옵션 메뉴 를 클릭합니다.
   2. Delete CustomResourceDefinition 을 선택합니다.
   3. Delete 를 클릭하여 CRD 삭제를 확인합니다.

프로세스

1. 웹 콘솔의 관리자 화면에서 Administration → CustomResourceDefinitions 로 이동합니다.
2. 이름으로 검색 상자를 사용하여 tektonconfigs.operator.tekton.dev CRD(사용자 정의 리소스 정의)를 검색합니다. TektonConfig 를 클릭하여 CRD 세부 정보 페이지를 확인합니다.
3. Instances 탭을 클릭합니다.
4. config 인스턴스를 클릭하여 TektonConfig CR 세부 정보를 확인합니다.
5. YAML 탭을 클릭합니다.

6. 요구 사항에 따라 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