Git와 Code Stream을 통합하는 방법

Code Stream에서는 GitHub, GitLab 또는 Bitbucket 저장소에서 코드 변경이 이루어질 경우 파이프라인을 트리거하는 방법을 제공합니다. Git 트리거에서 모니터링하려는 저장소의 분기에 Git 끝점을 사용해야 합니다. Code Stream은 Webhook를 통해 Git 끝점에 연결됩니다.

Code Stream에서 Git 끝점을 정의하려면 프로젝트를 선택하고 끝점이 위치할 Git 저장소의 분기를 입력합니다. 프로젝트를 통해 파이프라인에 끝점 및 다른 관련 개체가 함께 연결됩니다. Webhook 정의에서 프로젝트를 선택하면 트리거할 끝점 및 파이프라인이 선택됩니다.

참고: 끝점을 사용하여 Webhook을 정의하고 나중에 끝점을 편집하는 경우에는 Webhook에서 끝점 세부 정보를 변경할 수 없습니다. 끝점 세부 정보를 변경하려면 끝점을 사용하여 Webhook을 삭제하고 재정의해야 합니다. Code Stream에서 Git 트리거를 사용하여 파이프라인을 실행하는 방법의 내용을 참조하십시오.

동일한 Git 끝점을 사용하고 Webhook 구성 페이지에서 분기 이름에 서로 다른 값을 제공하여 여러 분기에 대해 다수의 Webhook을 생성하고 할 수 있습니다. 동일한 Git 저장소의 다른 분기에 대해 또 다른 Webhook을 생성하기 위해, 여러 분기에 대해 Git 끝점을 여러 번 복제할 필요가 없습니다. 대신, Webhook에 분기 이름을 제공하면 Git 끝점을 재사용할 수 있습니다. Git Webhook의 분기가 끝점의 분기와 동일한 경우 Git Webhook 페이지에서 분기 이름을 제공하지 않아도 됩니다.

사전 요구 사항

연결하려는 GitHub, GitLab 또는 Bitbucket 저장소에 액세스할 수 있어야 합니다.
Code Stream에서 프로젝트의 멤버인지 확인합니다. 그렇지 않으면 프로젝트 멤버로 추가해 달라고 Code Stream 관리자에게 요청합니다. Code Stream에서 프로젝트를 추가하는 방법의 내용을 참조하십시오.

프로시저

Git 끝점을 정의합니다.
1. 끝점 > 새 끝점을 클릭합니다.
2. 프로젝트를 선택하고 끝점 유형으로 Git를 선택합니다. 그런 다음 이름과 설명을 입력합니다.
3. 이 끝점이 인프라에서 비즈니스에 중요한 구성 요소인 경우 제한된 리소스로 표시를 사용하도록 설정합니다.
  파이프라인에서 제한된 끝점을 사용하는 경우 관리자는 파이프라인을 실행할 수 있으며 파이프라인 실행을 승인해야 합니다. 끝점 또는 변수가 제한된 것으로 표시되고 관리자가 아닌 사용자가 파이프라인을 트리거하면 해당 작업에서 파이프라인이 일시 중지되고 관리자가 재개할 때까지 기다립니다.
  
  프로젝트 관리자는 사용자가 프로젝트 관리자인 프로젝트에 리소스가 있는 경우 제한된 끝점 또는 변수가 포함된 파이프라인을 시작할 수 있습니다.
  
  관리자가 아닌 사용자가 제한된 리소스를 포함하는 파이프라인을 실행하려고 하면 제한된 리소스를 사용하는 작업에서 파이프라인이 중지됩니다. 그러면 관리자가 파이프라인을 재개해야 합니다.
  
  제한된 리소스에 대한 자세한 내용 및 제한된 파이프라인 관리라는 사용 권한이 포함된 사용자 지정 역할에 대한 자세한 내용은 다음을 참조하십시오.
  - Code Stream에서 사용자 액세스 및 승인을 관리하는 방법
  - Code Stream을 설정하여 릴리스 프로세스 모델링
4. 지원되는 Git 서버 유형 중 하나를 선택합니다.
5. 경로에 서버의 API 게이트웨이가 있는 저장소의 URL을 입력합니다. 예를 들면 다음과 같습니다.
  GitHub의 경우 https://api.github.com/vmware-example/repo-example을 입력합니다.
  
  BitBucket의 경우 https://api.bitbucket.org/{user}/{repo name} 또는 http(s)://{bitbucket-enterprise-server}/rest/api/1.0/users/{username}/repos/{repo name}을 입력합니다.
6. 끝점이 위치한 저장소의 분기를 입력합니다.
7. 인증 유형을 선택하고 GitHub, GitLab 또는 BitBucket에 대한 사용자 이름을 입력합니다. 그런 다음 사용자 이름과 함께 사용되는 전용 토큰을 입력합니다.
  - 암호. 나중에 Webhook을 생성하려면 암호에 대한 전용 토큰을 입력해야 합니다. Git에 대한 Webhook은 기본 인증을 사용하여 생성된 끝점을 지원하지 않습니다.
    비밀 변수를 사용하여 중요한 정보를 숨기고 암호화합니다. 제한된 변수는 숨기고 암호화되어야 하는 문자열, 암호 및 URL에 사용하고, 실행에서 사용을 제한하기 위해 사용합니다. 예를 들어 암호 또는 URL에 대해 비밀 변수를 사용합니다. 파이프라인의 모든 작업 유형에서 비밀 변수와 제한된 변수를 사용할 수 있습니다.
  - 전용 토큰. Git에만 해당되는 이 토큰을 사용하면 특정 작업에 액세스할 수 있습니다. https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html 항목을 참조하십시오. 전용 토큰에 대한 변수를 생성할 수도 있습니다.
검증을 클릭하고 끝점이 Code Stream에 연결되는지 확인합니다.
연결되지 않을 경우 오류를 해결한 다음 생성을 클릭합니다.

다음에 수행할 작업

자세한 내용을 보려면 다른 섹션을 검토합니다. Code Stream에서 Git 트리거를 사용하여 파이프라인을 실행하는 방법 항목을 참조하십시오.