3.7. OpenShift Pipelines에서 Tekton Hub 사용

절차

1. 클러스터 관리자는 원하는 범위에 따라 config.yaml 파일에 새 사용자를 추가할 수 있습니다.

   ...
   scopes:
     - name: agent:create
       users: [<username_1>, <username_2>] 1
     - name: catalog:refresh
       users: [<username_3>, <username_4>]
     - name: config:refresh
       users: [<username_5>, <username_6>]
   
   default:
     scopes:
       - rating:read
       - rating:write
   ...

   1

   Git 리포지토리 호스팅 서비스 공급자에 등록된 사용자 이름.

   참고

   사용자가 처음 로그인하면 config.yaml 에 추가되는 경우에도 기본 범위만 있습니다. 추가 범위를 활성화하려면 사용자가 한 번 이상 로그인했는지 확인합니다.

2. config.yaml 파일에서 config-refresh 범위가 있는지 확인합니다.

3. 구성을 새로 고칩니다.

   $ curl -X POST -H "Authorization: <access-token>" \ 1
       --header "Content-Type: application/json" \
       --data '{"force": true} \
       <api-route>/system/config/refresh

   1

   JWT 토큰입니다.

절차

1. 다음 키를 사용하여 대상 네임스페이스에 tekton-hub-db 라는 시크릿을 생성합니다.

   • POSTGRES_HOST
   • POSTGRES_DB
   • POSTGRES_USER
   • POSTGRES_PASSWORD

   • POSTGRES_PORT

     예: 사용자 정의 데이터베이스 보안

     apiVersion: v1
     kind: Secret
     metadata:
       name: tekton-hub-db
       labels:
         app: tekton-hub-db
     type: Opaque
     stringData:
       POSTGRES_HOST: <The name of the host of the database>
       POSTGRES_DB: <Name of the database>
       POSTGRES_USER: <The name of user account>
       POSTGRES_PASSWORD: <The password of user account>
       POSTGRES_PORT: <The port that the database is listening on>
     ...

     참고

     기본 대상 네임스페이스는 openshift-pipelines 입니다.

2. TektonHub CR에서 데이터베이스 secret 특성 값을 tekton-hub-db 로 설정합니다.

   예: 사용자 정의 데이터베이스 시크릿 추가

   apiVersion: operator.tekton.dev/v1alpha1
   kind: TektonHub
   metadata:
     name: hub
   spec:
     targetNamespace: openshift-pipelines
     db:
       secret: tekton-hub-db
     api:
       hubConfigUrl: https://raw.githubusercontent.com/tektoncd/hub/main/config.yaml
       catalogRefreshInterval: 30m
   ...

3. 업데이트된 TektonHub CR을 사용하여 사용자 지정 데이터베이스를 Tekton Hub와 연결합니다.

   1. 클러스터에 Tekton Hub를 설치할 때 사용자 지정 데이터베이스를 연결하는 경우 업데이트된 TektonHub CR을 적용합니다.

      $ oc apply -f <tekton-hub-cr>.yaml

   2. 또는 Tekton Hub 설치 완료 후 사용자 지정 데이터베이스를 연결하는 경우 기존 TektonHub CR을 업데이트된 TektonHub CR로 교체합니다.

      $ oc replace -f <tekton-hub-cr>.yaml

4. 설치 상태를 확인합니다. TektonHub CR은 안정적인 상태를 유지하는 데 시간이 걸릴 수 있습니다.

   $ oc get tektonhub.operator.tekton.dev

   샘플 출력

   NAME   VERSION   READY   REASON   APIURL                    UIURL
   hub    v1.8.0    True             https://api.route.url/    https://ui.route.url/

절차

1. Operator 1.7용 Tekton Hub를 수동으로 설치하는 동안 생성한 기존 Tekton Hub API 시크릿을 삭제합니다.

   $ oc delete secret tekton-hub-api -n <targetNamespace> 1

   1

   Tekton Hub API 시크릿 및 Tekton Hub CR의 공통 네임스페이스입니다. 기본적으로 대상 네임스페이스는 openshift-pipelines 입니다.

2. Tekton Hub API의 TektonInstallerSet 오브젝트를 삭제합니다.

   $ oc get tektoninstallerset -o name | grep tekton-hub-api | xargs oc delete

   참고

   삭제 후 Operator는 새 Tekton Hub API 설치 프로그램이 자동으로 설정됩니다.

   기다린 후 Tekton Hub의 상태를 확인합니다. READY 열에 True 가 표시되면 다음 단계를 진행합니다.

   $ oc get tektonhub hub

   샘플 출력

   NAME   VERSION        READY   REASON   APIURL                                                                                                  UIURL
   hub    1.8.0          True             https://tekton-hub-api-openshift-pipelines.apps.example.com   https://tekton-hub-ui-openshift-pipelines.apps.example.com

3. Tekton Hub UI의 ConfigMap 오브젝트를 삭제합니다.

   $ oc delete configmap tekton-hub-ui -n <targetNamespace> 1

   1

   Tekton Hub UI 및 Tekton Hub CR의 공통 네임스페이스입니다. 기본적으로 대상 네임스페이스는 openshift-pipelines 입니다.

4. Tekton Hub UI의 TektonInstallerSet 오브젝트를 삭제합니다.

   $ oc get tektoninstallerset -o name | grep tekton-hub-ui | xargs oc delete

   참고

   삭제 후 Operator는 새 Tekton Hub UI 설치 프로그램이 설정된 새 Tekton Hub UI 설치 프로그램을 자동으로 생성합니다.

   기다린 후 Tekton Hub의 상태를 확인합니다. READY 열에 True 가 표시되면 다음 단계를 진행합니다.

   $ oc get tektonhub hub

   샘플 출력

   NAME   VERSION        READY   REASON   APIURL                                                                                                  UIURL
   hub    1.8.0          True             https://tekton-hub-api-openshift-pipelines.apps.example.com   https://tekton-hub-ui-openshift-pipelines.apps.example.com