빌드 종속 항목 관리

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

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

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

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

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

시작하기 전에

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

필요한 역할

종속 항목으로 추가하는 저장소가 Developer Connect 저장소인 경우 서비스 계정에 Developer Connect 읽기 토큰 접근자 역할이 필요합니다.

이는 필요한 다른 Cloud Build 역할 외에도 적용됩니다.

종속 항목 지정

빌드 구성 파일에 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: 선택사항. 가져올 저장소의 HTTPS URL입니다. URL 또는 Developer Connect 리소스 경로를 지정해야 합니다.

  • RESOURCE_PATH: 선택사항. 해당 Developer Connect 저장소의 Google Cloud 리소스 경로입니다. 예를 들면 projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo입니다. URL 또는 Developer Connect 리소스 경로를 지정해야 합니다. 가져올 저장소가 Developer Connect를 사용하여 Cloud Build에 연결된 경우 이 필드를 지정합니다.

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

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

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

    • 1: 최신 커밋입니다.
    • 2: 마지막 두 커밋
    • 3: 마지막 세 번의 커밋
    • -1: 모든 커밋

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

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

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

다음 단계