3.7. OpenShift Pipelines에서 Tekton Hub 사용

절차

1. 다음 예와 유사한 TektonHub CR을 생성합니다.

   apiVersion: operator.tekton.dev/v1alpha1
   kind: TektonHub
   metadata:
     name: hub
   spec:
     targetNamespace: openshift-pipelines 1
     db:                      # Optional: If you want to use custom database
       secret: tekton-hub-db  # Name of db secret should be `tekton-hub-db`
   
     categories:              # Optional: If you want to use custom categories
       - Automation
       - Build Tools
       - CLI
       - Cloud
       - Code Quality
       - ...
   
     catalogs:                # Optional: If you want to use custom catalogs
       - name: tekton
         org: tektoncd
         type: community
         provider: github
         url: https://github.com/tektoncd/catalog
         revision: main
   
     scopes:                   # Optional: If you want to add new users
       - name: agent:create
         users: [abc, qwe, pqr]
       - name: catalog:refresh
         users: [abc, qwe, pqr]
       - name: config:refresh
         users: [abc, qwe, pqr]
   
     default:                   # Optional: If you want to add custom default scopes
       scopes:
         - rating:read
         - rating:write
   
     api:
       catalogRefreshInterval: 30m 2

   1

   Tekton Hub를 설치해야 하는 네임스페이스입니다. 기본값은 openshift-pipelines 입니다.

   2

   카탈로그가 자동으로 새로 고침되는 시간 간격입니다. 지원되는 시간 단위는 초(s), 분(m), 시간(h), 일(d), 주(w)입니다. 기본 간격은 30분입니다.

   참고

   TektonHub CR에서 선택적 필드에 대한 사용자 정의 값을 제공하지 않으면 Tekton Hub API 구성 맵에 구성된 기본값이 사용됩니다.

2. TektonHub CR을 적용합니다.

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

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

   $ oc get tektonhub.operator.tekton.dev

   샘플 출력

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

절차

1. Git 리포지토리 호스팅 공급자를 사용하여 OAuth 애플리케이션을 생성하고 클라이언트 ID 및 클라이언트 보안을 기록해 둡니다. 지원되는 공급자는 GitHub, GitLab, BitBucket입니다.

   • GitHub OAuth 애플리케이션 의 경우 Homepage URL 및 Authorization 콜백 URL을 < auth-route>로 설정합니다.
   • GitLab OAuth 애플리케이션 의 경우 REDIRECT_URI 를 < auth-route>/auth/gitlab/callback 으로 설정합니다.
   • BitBucket OAuth 애플리케이션 의 경우 callback URL 을 < auth-route>로 설정합니다.

2. Tekton Hub API 시크릿을 포함하도록 < tekton_hub_root>/config/02-api/20-api-secret.yaml 파일을 편집합니다. 예를 들면 다음과 같습니다.

   apiVersion: v1
   kind: Secret
   metadata:
     name: tekton-hub-api
     namespace: openshift-pipelines
   type: Opaque
   stringData:
     GH_CLIENT_ID: 1
     GH_CLIENT_SECRET: 2
     GL_CLIENT_ID: 3
     GL_CLIENT_SECRET: 4
     BB_CLIENT_ID: 5
     BB_CLIENT_SECRET: 6
     JWT_SIGNING_KEY: 7
     ACCESS_JWT_EXPIRES_IN: 8
     REFRESH_JWT_EXPIRES_IN: 9
     AUTH_BASE_URL: 10
     GHE_URL: 11
     GLE_URL: 12

   1

   GitHub OAuth 애플리케이션의 클라이언트 ID입니다.

   2

   GitHub OAuth 애플리케이션의 클라이언트 시크릿.

   3

   GitLab OAuth 애플리케이션의 클라이언트 ID.

   4

   GitLab OAuth 애플리케이션의 클라이언트 시크릿.

   5

   BitBucket OAuth 애플리케이션의 클라이언트 ID입니다.

   6

   BitBucket OAuth 애플리케이션의 클라이언트 시크릿.

   7

   사용자가 생성한 JSON 웹 토큰(JWT)에 서명하는 데 사용되는 긴 임의 문자열입니다.

   8

   액세스 토큰이 만료된 후 시간 제한을 추가합니다. 예를 들어 1m. 여기서 m은 분을 나타냅니다. 지원되는 시간 단위는 초(s), 분(m), 시간(h), 일(d), 주(w)입니다.

   9

   새로 고침 토큰이 만료된 후 시간 제한을 추가합니다. 예를 들어 1m. 여기서 m 은 분을 나타냅니다. 지원되는 시간 단위는 초(s), 분(m), 시간(h), 일(d), 주(w)입니다. 토큰 새로 고침에 설정된 만료 시간이 토큰 액세스에 설정된 만료 시간보다 큰지 확인합니다.

   10

   OAuth 애플리케이션의 경로 URL입니다.

   11

   GitHub Enterprise URL: GitHub Enterprise를 사용하여 인증하는 경우. 카탈로그에 이 필드의 값으로 URL을 제공하지 마십시오.

   12

   GitLab Enterprise URL: GitLab Enterprise를 사용하여 인증하는 경우. 카탈로그에 이 필드의 값으로 URL을 제공하지 마십시오.

   참고

   배포에 관련이 없는 Git 리포지토리 호스팅 서비스 공급자에 대해 사용되지 않은 필드를 삭제할 수 있습니다.

3. 다음 예와 유사한 TektonHub CR을 생성합니다.

   apiVersion: operator.tekton.dev/v1alpha1
   kind: TektonHub
   metadata:
     name: hub
   spec:
     targetNamespace: openshift-pipelines 1
     db: 2
       secret: tekton-hub-db 3
   
     categories: 4
       - Automation
       - Build Tools
       - CLI
       - Cloud
       - Code Quality
         ...
   
     catalogs: 5
       - name: tekton
         org: tektoncd
         type: community
         provider: github
         url: https://github.com/tektoncd/catalog
         revision: main
   
     scopes: 6
       - name: agent:create
         users: [<username>]
       - name: catalog:refresh
         users: [<username>]
       - name: config:refresh
         users: [<username>]
   
     default: 7
       scopes:
         - rating:read
         - rating:write
   
     api:
       catalogRefreshInterval: 30m 8

   1

   Tekton Hub를 설치해야 하는 네임스페이스입니다. 기본값은 openshift-pipelines 입니다.

   2

   선택사항: Crunchy Postgres 데이터베이스와 같은 사용자 지정 데이터베이스입니다.

   3

   데이터베이스 시크릿의 이름은 tekton-hub-db 여야 합니다.

   4

   선택사항: Tekton Hub의 작업 및 파이프라인에 맞게 사용자 지정된 카테고리입니다.

   5

   선택사항: Tekton Hub용 카탈로그 사용자 지정.

   6

   선택사항: 추가 사용자입니다. [<username_1>, <username_2>, <username_3>] 과 같은 여러 사용자를 처리할 수 있습니다.

   7

   선택 사항: 사용자 지정된 기본 범위입니다.

   8

   카탈로그가 자동으로 새로 고침되는 시간 간격입니다. 지원되는 시간 단위는 초(s), 분(m), 시간(h), 일(d), 주(w)입니다. 기본 간격은 30분입니다.

   참고

   TektonHub CR에서 선택적 필드에 대한 사용자 정의 값을 제공하지 않으면 Tekton Hub API 구성 맵에 구성된 기본값이 사용됩니다.

4. TektonHub CR을 적용합니다.

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

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

   $ oc get tektonhub.operator.tekton.dev

   샘플 출력

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

절차

1. Crunchy Postgres Pod로 이동합니다.

   예: test-instance1-m7h-0 Pod 로 이동

   $ oc exec -it -n openshift-operators test-instance1-m7hh-0 -- /bin/sh
   
   Defaulting container name to database.
   Use 'oc describe pod/test-instance1-m7hh-0 -n openshift-operators' to see all of the containers in this pod.
   sh-4.4$ psql -U postgres
   psql (14.4)
   Type "help" for help.

2. pg_hba.conf 파일을 찾습니다.

   postgres=# SHOW hba_file;
            hba_file
   --------------------------
    /pgdata/pg14/pg_hba.conf
   (1 row)
   
   postgres=#

3. 데이터베이스를 종료합니다.

4. pg_hba.conf 파일에 모든 0.0.0.0/0 md5 , 들어오는 모든 연결에 액세스하는 데 필요한 항목 호스트가 있는지 확인합니다. 또한 pg_hba.conf 파일의 끝에 항목을 추가합니다.

   예: pg_hba.conf 파일

   sh-4.4$ cat /pgdata/pg14/pg_hba.conf
   
   # Do not edit this file manually!
   # It will be overwritten by Patroni!
   local all "postgres" peer
   hostssl replication "_crunchyrepl" all cert
   hostssl "postgres" "_crunchyrepl" all cert
   host all "_crunchyrepl" all reject
   hostssl all all all md5
   host  all  all 0.0.0.0/0 md5

5. pg_hba.conf 파일을 저장하고 데이터베이스를 다시 로드합니다.

   sh-4.4$ psql -U postgres
   psql (14.4)
   Type "help" for help.
   
   postgres=# SHOW hba_file;
            hba_file
   --------------------------
    /pgdata/pg14/pg_hba.conf
   (1 row)
   
   postgres=# SELECT pg_reload_conf();
    pg_reload_conf
   ----------------
    t
   (1 row)

6. 데이터베이스를 종료합니다.

7. Crunchy Postgres 호스트의 시크릿 값을 디코딩합니다.

   예: Crunchy Postgres 호스트의 시크릿 값 디코딩

   $ echo 'aGlwcG8tcHJpbWFyeS5vcGVuc2hpZnQtb3BlcmF0b3JzLnN2YyA=' | base64 --decode
   test-primary.openshift-operators.svc

8. 다음 키를 사용하여 대상 네임스페이스에 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: test-primary.openshift-operators.svc
       POSTGRES_DB: test
       POSTGRES_USER: <username>
       POSTGRES_PASSWORD: <password>
       POSTGRES_PORT: '5432'
     ...

   참고

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

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

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

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

11. 설치 상태를 확인합니다. TektonHub CR은 정상 상태를 늘리는 데 약간의 시간이 걸릴 수 있습니다.

    $ oc get tektonhub.operator.tekton.dev

    샘플 출력

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

절차

1. 내부 또는 기본 데이터베이스의 기존 데이터를 포드의 파일로 덤프합니다.

   예: 덤프 데이터

   $ pg_dump -Ft -h localhost -U postgres hub -f /tmp/hub.dump

2. 데이터가 포함된 파일을 로컬 시스템에 복사합니다.

   명령 형식

   $ oc cp -n <namespace> <podName>:<path-to-hub.dump> <path-to-local-system>

   예제

   $ oc cp -n openshift-pipelines tekton-hub-db-7d6d888c67-p7mdr:/tmp/hub.dump /home/test_user/Downloads/hub.dump

3. 로컬 시스템의 데이터 덤프가 포함된 파일을 외부 Crunchy Postgres 데이터베이스를 실행하는 pod로 복사합니다.

   명령 형식

   $ oc cp -n <namespace> <path-to-local-system> <podName>:<path-to-hub.dump>

   예제

   $ oc cp -n openshift-operators /home/test_user/Downloads/hub.dump test-instance1-spnz-0:/tmp/hub.dump

4. Crunchy Postgres 데이터베이스에서 데이터를 복원합니다.

   명령 형식

   $ pg_restore -d <database-name> -h localhost -U postgres <path-where-file-is-copied>

   예제

   $ pg_restore -d test -h localhost -U postgres /tmp/hub.dump

5. Crunchy Postgres Pod로 들어갑니다. .Example: test-instance1-m7hh-0 Pod로 가져오기

   $ oc exec -it -n openshift-operators test-instance1-m7hh-0 -- /bin/sh
   
   Defaulting container name to database.
   Use 'oc describe pod/test-instance1-m7hh-0 -n openshift-operators' to see all of the containers in this pod.
   sh-4.4$ psql -U postgres
   psql (14.4)
   Type "help" for help.

6. pg_hba.conf 파일을 찾습니다.

   postgres=# SHOW hba_file;
            hba_file
   --------------------------
    /pgdata/pg14/pg_hba.conf
   (1 row)
   
   postgres=#

7. 데이터베이스를 종료합니다.

8. pg_hba.conf 파일에 모든 0.0.0.0/0 md5 .d5 항목이 있는지 확인합니다. 이 항목은 들어오는 모든 연결에 액세스하는 데 필요합니다. 필요한 경우 pg_hba.conf 파일의 끝에 항목을 추가합니다.

   예: pg_hba.conf 파일

   sh-4.4$ cat /pgdata/pg14/pg_hba.conf
   
   # Do not edit this file manually!
   # It will be overwritten by Patroni!
   local all "postgres" peer
   hostssl replication "_crunchyrepl" all cert
   hostssl "postgres" "_crunchyrepl" all cert
   host all "_crunchyrepl" all reject
   hostssl all all all md5
   host  all  all 0.0.0.0/0 md5

9. pg_hba.conf 파일을 저장하고 데이터베이스를 다시 로드합니다.

   sh-4.4$ psql -U postgres
   psql (14.4)
   Type "help" for help.
   
   postgres=# SHOW hba_file;
            hba_file
   --------------------------
    /pgdata/pg14/pg_hba.conf
   (1 row)
   
   postgres=# SELECT pg_reload_conf();
    pg_reload_conf
   ----------------
    t
   (1 row)

10. 데이터베이스를 종료합니다.

11. 대상 네임스페이스의 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: test-primary.openshift-operators.svc
        POSTGRES_DB: test
        POSTGRES_USER: test
        POSTGRES_PASSWORD: woXOisU5>ocJiTF7y{{;1[Q(
        POSTGRES_PORT: '5432'
      ...

      참고

      POSTGRES_HOST 필드의 값은 시크릿으로 인코딩됩니다. 다음 예제를 사용하여 Crunchy Postgres 호스트의 값을 디코딩할 수 있습니다.

      예: Crunchy Postgres 호스트의 시크릿 값 디코딩

      $ echo 'aGlwcG8tcHJpbWFyeS5vcGVuc2hpZnQtb3BlcmF0b3JzLnN2YyA=' | base64 --decode
      test-primary.openshift-operators.svc

12. TektonHub CR에서 데이터베이스 시크릿 속성 값이 tekton-hub-db 인지 확인합니다.

    예: 데이터베이스 시크릿 이름이 있는 TektonHub CR

    apiVersion: operator.tekton.dev/v1alpha1
    kind: TektonHub
    metadata:
      name: hub
    spec:
      targetNamespace: openshift-pipelines
      db:
        secret: tekton-hub-db
    ...

13. 외부 Crunchy Postgres 데이터베이스를 Tekton Hub와 연결하려면 기존 TektonHub CR을 업데이트된 TektonHub CR로 교체합니다.

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

14. Tekton Hub의 상태를 확인합니다. 업데이트된 TektonHub CR은 정상 상태를 늘리는 데 약간의 시간이 걸릴 수 있습니다.

    $ oc get tektonhub.operator.tekton.dev

    샘플 출력

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