사용자 정의 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과 인증 콜백 URL을 < auth-route>로 설정합니다.
   • GitLab OAuth 애플리케이션 의 경우 REDIRECT_URI 를 < auth-route>/auth/gitlab/callback 으로 설정합니다.
   • Bitbucket OAuth 애플리케이션 의 경우 콜백 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를 사용하여 인증하는 경우 GitLab Enterprise URL입니다. 이 필드의 값으로 카탈로그에 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-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.

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에서 데이터베이스 시크릿 속성 값을 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 데이터베이스를 실행하는 포드로 복사합니다.

   명령 형식

   $ 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로 이동합니다. 예: 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.

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가 항목 호스트가 있는지 확인합니다. 필요한 경우 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/