Git 저장소와 프로젝트 통합

프로젝트를 Git 저장소에 연결하여 해당 저장소에 구성을 저장합니다. 이렇게 하면 저장소와 선택한 CI 및 CD 도구를 사용하여 프로젝트의 구성에 대한 파이프라인을 자동화할 수 있습니다.

이는 평가 및 테스트 목적으로 사용 가능한 실험적 기능이므로 사전 통지 없이 변경될 수 있습니다.

파이프라인과 툴체인은 사용자 정의가 가능하므로 프로젝트 API 메서드나 CLI 명령을 사용하여 Git 저장소와 프로젝트 간의 많은 작업을 자동화할 수 있습니다. 예를 들어, 리포지토리의 메인 브랜치에 구성 변경 사항이 병합되면 프로젝트에 업데이트를 트리거하는 파이프라인을 만들 수 있습니다. 자세한 내용은 Git 저장소에서 프로젝트 작업 자동화를 참조하세요.

프로젝트에서 초안 구성은 저장소의 모든 브랜치에 저장할 수 있습니다. 그러나 CD 파이프라인을 관리하는 저장소의 브랜치에 병합된 후에만 초안 구성을 검증하고 배포할 수 있습니다. 구성을 검증하고 배포하기 전에 구성을 업데이트하여 저장소의 업데이트를 프로젝트에 동기화해야 합니다. project.config.update API 메서드나 ibmcloud project config-update CLI 명령을 사용하여 이 업데이트를 자동화할 수 있습니다.

시작하기 전에

  1. Git 저장소 통합을 관리하려면 IBM Cloud 프로젝트 서비스에서 편집자 역할이 있는지 확인하세요.

  2. Git 저장소에 연결하려면 액세스 토큰을 비밀로 저장하세요. 액세스 토큰에는 사용하려는 브랜치에 대한 쓰기 액세스 권한이 필요하고 저장소에 커밋을 생성할 수 있는 권한이 필요합니다. 액세스 토큰에는 브랜치를 나열하고 읽을 수 있는 기능도 필요합니다.

    1. IBM Cloud 계정에서 Secrets Manager 서비스 인스턴스를 만듭니다. 비밀글을 만들려면 Secrets Manager 서비스에서 작성자 이상의 역할이 있어야 합니다.

    2. 비밀 인스턴스를 생성한 후에는 다른 비밀 유형을 선택하여 임의의 비밀을 추가해야 합니다. 임의의 비밀을 생성하는 방법에 대한 자세한 내용은 UI에서 임의의 비밀 생성을 참조하세요. 임의의 비밀에는 Git 저장소에 대한 액세스 토큰이 포함되어 있어야 합니다.

프로젝트를 Git 리포지토리에 연결하기

프로젝트에 Git 저장소를 연결합니다. 이렇게 하면 구성 변경 사항이 프로젝트 JSON 파일이 아니라 저장소에 저장됩니다. 프로젝트에서 저장소에 구성을 저장해야 하므로 프로젝트에서 저장소에 인증하려면 액세스 토큰을 제공해야 합니다.

  1. IBM Cloud 콘솔에서 탐색 메뉴 아이콘 탐색 메뉴 아이콘 > 프로젝트 를 클릭하고 프로젝트를 선택합니다.
  2. 관리 탭에서 통합을 선택합니다.
  3. Git 저장소 통합 섹션에서 연결을 클릭합니다.
  4. 저장소 유형 메뉴에서 구성을 관리하는 데 사용할 저장소 유형을 선택합니다. 일반적으로 이 저장소는 파이프라인과 툴체인을 관리하는 데 사용됩니다. GitHub, GitLab 또는 GitHub Enterprise 선택할 수 있습니다.
  5. 리포지토리에 URL 을 입력합니다.
  6. 선택적으로 저장소 내의 폴더를 지정합니다. 여러 프로젝트와 저장소를 통합하려면 폴더를 지정하는 것이 좋습니다. 각 프로젝트는 개별 폴더를 가질 수 있습니다.
  7. 액세스 토큰 필드에 마우스를 올리거나 클릭한 다음, 비밀 아이콘 키 아이콘 클릭하여 액세스 토큰이 포함된 비밀을 선택합니다.
  8. 프로젝트에 이미 구성이 포함되어 있는 경우 '기존 구성 파일을 이 저장소에 복사' 를 선택하여 기존 구성을 저장소에 저장합니다.
  9. 저장 을 클릭하십시오.

다음 단계

이제 Git 저장소가 프로젝트에 연결되었으므로 파이프라인과 툴체인을 사용자 지정할 준비가 되었습니다. 변경 사항이 메인 브랜치에 병합될 때 프로젝트의 구성을 자동으로 업데이트하는 파이프라인을 만드는 방법을 알아보려면 Git 저장소에서 프로젝트 작업 자동화를 참조하세요.