빌드 종속 항목 관리

이 페이지에서는 빌드 종속 항목을 지정하는 방법을 설명합니다. Cloud Build를 사용하면 빌드 프로세스와 별도로 소스 코드 종속 항목을 관리할 수 있습니다.

빌드 구성 파일에서 빌드를 위해 클론할 하나 이상의 Git 저장소와 가져올 순서를 나열할 수 있습니다. 이러한 방식으로 종속 항목을 지정하면 종속 항목 가져오기가 빌드 프로세스 자체에서 분리됩니다.

빌드 구성 파일에 종속 항목을 포함하지 않으면 Cloud Build는 빌드 구성 파일이 포함된 소스 코드 저장소 (트리거된 빌드의 경우) 또는 소스 코드가 포함된 저장소 (명령줄에서 호출하는 빌드의 경우)를 클론합니다. 빌드 구성 파일에 종속 항목을 포함하는 경우 Cloud Build는 dependencies 필드에 지정되지 않은 저장소를 클론하지 않습니다.

dependencies 필드에 지정하는 소스 코드 저장소는 Developer Connect를 사용하여 Cloud Build에 연결되어 있거나 공개 저장소여야 합니다.

종속 항목은 이 구성에 지정한 순서대로 클론됩니다. 또한 종속 항목 가져오기는 사용자 지정 로직이 실행되기 전에 발생합니다. 따라서 종속 항목 가져오기는 신뢰할 수 있습니다.

종속 항목은 빌드 세부정보 페이지의 빌드 종속 항목 탭에 표시됩니다.

시작하기 전에

이 페이지의 안내에서는 하나 이상의 Git 저장소가 공개 저장소이거나 Developer Connect를 사용하여 연결되어 있다고 가정합니다.

Developer Connect 저장소를 종속 항목으로 추가하는 데 필요한 권한을 얻으려면 관리자에게 서비스 계정에 대한 Developer Connect 읽기 토큰 액세스 권한 (developerconnect.readTokenAccessor) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

종속 항목 지정

빌드 구성 파일에 dependencies 스탠자를 추가하여 종속 항목을 지정합니다. dependencies는 빌드 구성의 최상위 속성이지만 파일의 어느 위치에나 배치할 수 있습니다.

다음은 dependencies 스탠자의 문법입니다.

YAML 

 dependencies:
 - gitSource:
     repository:
       url: 'URL'
       developerConnect: 'RESOURCE_PATH'
     revision: 'REVISION'
     recurseSubmodules: 'true|false'
     depth: DEPTH'
     destPath: 'DEST_PATH'

JSON 

 {
     "dependencies": {
         "gitSource": {
             "repository": {
                 "url": "URL"
                 "developerConnect": "RESOURCE_PATH"
             },
             "revision": "REVISION",
             "recurseSubmodules": true|false,
             "depth": "DEPTH",
             "destPath": "DEST_PATH",
         },
     },
 }

URL 또는 리소스 경로를 지정해야 합니다. 가져올 저장소가 개발자 연결을 사용하여 Cloud Build에 연결된 경우 리소스 경로를 지정합니다.

다음 값을 바꿉니다.

  • URL: 선택사항. 가져올 저장소의 HTTPS URL입니다.

  • RESOURCE_PATH: 선택사항. Developer Connect 저장소의 Google Cloud 리소스 경로입니다. 예를 들면 projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo입니다.

  • REVISION: (필수사항) 저장소에서 가져올 버전, 커밋 해시, 태그 또는 브랜치 이름입니다.

  • recurseSubmodules: 'true|false': 하위 모듈을 가져올지 여부입니다.

  • DEPTH: 선택사항, 저장소 기록에서 가져올 깊이입니다. 지정하지 않으면 최신 커밋이 가져옵니다.

    • 1: 최신 커밋
    • 2: 마지막 두 커밋
    • 3: 마지막 커밋 3개
    • -1: 모든 커밋

  • DEST_PATH: (필수사항) 저장소가 클론되는 디렉터리의 경로입니다. 예를 들면 my/repo입니다.

    dest_path을 설정하면 저장소가 /workspace/<dest_path>에서 가져옵니다. dest_path 값은 빌드의 작업 디렉터리를 기준으로 하는 경로여야 합니다.

Developer Connect 저장소를 종속 항목으로 지정

Developer Connect 저장소를 종속 항목으로 지정하려면 다음이 충족되어야 합니다.

다음 단계