3장. Git 리포지토리 호스팅 서비스 공급자와 함께 Pipeline을 코드로 사용

프로세스

1. 관리자 화면에서 탐색 창을 사용하여 파이프라인 으로 이동합니다.
2. 파이프라인 페이지에서 GitHub 앱 설정을 클릭합니다.
3. GitHub 앱 이름을 입력합니다. 예를 들면 pipelines-ci-clustername-testui 입니다.
4. 설정을 클릭합니다.
5. 브라우저에 메시지가 표시되면 Git 암호를 입력합니다.
6. Create GitHub App for <username >을 클릭합니다. 여기서 < username >은 GitHub 사용자 이름입니다.

프로세스

1. GitHub 계정에 로그인합니다.
2. GitHub 메뉴에서 설정 개발자 설정 GitHub 앱을 선택한 다음 새 GitHub 앱 을 클릭합니다.

3. GitHub 앱 양식에 다음 정보를 제공합니다.

   • GitHub 애플리케이션 이름:OpenShift Pipelines
   • 홈페이지 URL: OpenShift 콘솔 URL

   • Webhook URL: 코드 경로 또는 인그레스 URL로 파이프라인입니다. 다음 명령을 실행하여 찾을 수 있습니다.

     $ echo https://$(oc get route -n openshift-pipelines pipelines-as-code-controller -o jsonpath='{.spec.host}')

     또는 추가 Pipeline에 대한 GitHub 앱을 코드 컨트롤러로 구성하려면 다음 예와 같이 pipelines-as-code-controller 를 구성한 컨트롤러 이름으로 교체합니다.

     명령 예

     $ echo https://$(oc get route -n openshift-pipelines pac_controller_2 -o jsonpath='{.spec.host}')

   • Webhook 보안: 임의의 시크릿입니다. 다음 명령을 실행하여 보안을 생성할 수 있습니다.

     $ openssl rand -hex 20

4. 리포지토리 권한 섹션에서 다음 항목을 선택합니다.

   • 검사:읽기 및 쓰기
   • 내용:읽기 & 쓰기
   • 문제:읽기 & 쓰기
   • metadata:읽기 전용
   • pull request:Read & Write

5. 조직 권한 섹션에서 다음 항목을 선택합니다.

   • 멤버:읽기 전용
   • 계획:읽기 전용

6. 다음 이벤트를 구독합니다.

   • 실행 확인
   • 도구 모음 확인
   • 커밋 주석
   • 문제 주석
   • 가져오기 요청
   • push
7. GitHub 앱 생성을 클릭합니다.
8. 새로 생성된 GitHub 앱의 세부 정보 페이지에서 맨 위에 표시된 앱 ID 를 확인합니다.
9. 개인 키 섹션에서 개인 키 생성 을 클릭하여 GitHub 앱의 개인 키를 자동으로 생성하고 다운로드합니다. 나중에 참조 및 사용을 위해 개인 키를 안전하게 저장합니다.
10. Pipeline과 함께 사용할 리포지토리에 생성된 앱을 코드로 설치합니다.

11. 다음 명령을 입력하여 새로 생성된 GitHub 앱에 액세스하도록 Pipeline을 코드로 구성합니다.

    $ oc -n openshift-pipelines create secret generic pipelines-as-code-secret \ 1
            --from-literal github-private-key="$(cat <PATH_PRIVATE_KEY>)" \ 2
            --from-literal github-application-id="<APP_ID>" \ 3
            --from-literal webhook.secret="<WEBHOOK_SECRET>" 4

    1

    추가 GitHub 앱을 지원하기 위해 코드 컨트롤러로 추가 Pipeline을 생성하고 추가 컨트롤러의 앱을 구성하는 경우 pipelines-as-code-secret 을 컨트롤러의 secretName 매개변수에 구성한 이름으로 교체합니다.

    2

    GitHub 앱을 구성하는 동안 다운로드한 개인 키의 경로입니다.

    3

    GitHub 앱의 앱 ID 입니다.

    4

    GitHub 앱을 생성할 때 제공되는 Webhook 시크릿입니다.

프로세스

1. TektonConfig CR(사용자 정의 리소스)에서 pipelinesAsCode.settings 사양의 secret-github-app-token-scoped 매개변수를 false 로 설정합니다. 이 설정을 사용하면 GitHub 토큰의 범위를 글로벌 및 리포지토리 수준 구성에 나열된 프라이빗 및 공용 리포지토리로 지정할 수 있습니다.

2. GitHub 토큰 범위를 지정하는 글로벌 구성을 설정하려면 pipelinesAsCode.settings 사양의 TektonConfig CR에서 다음 예와 같이 secret-github-app-scope-extra-repos 매개변수에 추가 리포지토리를 지정합니다.

   apiVersion: operator.tekton.dev/v1alpha1
   kind: TektonConfig
   metadata:
     name: config
   spec:
     platforms:
       openshift:
         pipelinesAsCode:
           enable: true
           settings:
             secret-github-app-token-scoped: false
             secret-github-app-scope-extra-repos: "owner2/project2, owner3/project3"

3. GitHub 토큰 범위를 지정하는 리포지토리 수준 구성을 설정하려면 다음 예와 같이 Repository CR의 github_app_token_scope_repos 매개변수에 추가 리포지토리를 지정합니다.

   apiVersion: "pipelinesascode.tekton.dev/v1alpha1"
   kind: Repository
   metadata:
     name: test
     namespace: test-repo
   spec:
     url: "https://github.com/linda/project"
     settings:
       github_app_token_scope_repos:
       - "owner/project"
       - "owner1/project1"

   이 예제에서 Repository 사용자 지정 리소스는 test-repo 네임스페이스의 linda/project 리포지토리와 연결됩니다. 생성된 GitHub 토큰의 범위는 owner/project 및 owner1/project1 리포지토리와 linda/project 리포지토리로 확장됩니다. 이러한 리포지토리는 test-repo 네임스페이스에 있어야 합니다.

   참고

   추가 리포지토리는 공용 또는 개인 리포지토리일 수 있지만 리포지토리 리소스가 연결된 리포지토리와 동일한 네임스페이스에 있어야 합니다.

   네임스페이스에 리포지토리가 없는 경우 GitHub 토큰의 범위가 오류 메시지와 함께 실패합니다.

   failed to scope GitHub token as repo owner1/project1 does not exist in namespace test-repo