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

1. GitHub 계정에 로그인합니다.
2. 설정 개발자 설정 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}')

     Copy to Clipboard Toggle word wrap

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

     $ openssl rand -hex 20

     Copy to Clipboard Toggle word wrap

4. 다음 리포지토리 권한을 선택합니다.

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

5. 다음 조직 권한을 선택합니다.

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

6. 다음 사용자 권한을 선택합니다.

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

프로세스

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

프로세스

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"

   Copy to Clipboard Toggle word wrap

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"

   Copy to Clipboard Toggle word wrap

   이 예제에서 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

   Copy to Clipboard Toggle word wrap