소스 저장소에 수동으로 코드 빌드

이 페이지에서는 소스 저장소에서 코드를 빌드하기 위해 수동 트리거를 만드는 방법을 설명합니다. 수동 트리거를 사용하면 빌드를 실행하기 전에 호출 시 정의된 대체 변수 값을 재정의할 수 있는 기능을 통해 빌드를 수동으로 호출할 수 있습니다. 또한 수동 트리거가 특정 시간에 자동으로 실행되도록 예약할 수 있습니다.

gcloud CLI 또는 Cloud Build API를 사용하여 수동으로 빌드를 시작하는 방법은 수동으로 빌드 시작을 참조하세요.

시작하기 전에

  • Enable the Cloud Build API.

    Enable the API

  • 소스 코드를 준비하세요.

수동 트리거

수동 트리거를 사용하면 연결된 저장소에서 트리거를 호출할 때만 실행되는 빌드를 설정할 수 있습니다. 스테이징 또는 프로덕션 환경에 소스 코드를 배포하기 위한 파이프라인을 만든다고 가정해 보겠습니다. 워크플로를 자동화하려 할 수 있지만 수동으로만 빌드를 실행하려고 합니다. 이를 위해 수동 트리거를 정의할 수 있습니다.

수동 트리거를 사용하면 다음을 통해 빌드를 수동으로 호출할 수 있습니다.

  • 지정된 분기 또는 태그가 있는 호스팅된 저장소에서 소스 코드를 가져옵니다.
  • 빌드를 실행할 때마다 수동으로 전달할 필요가 없는 대체 변수로 빌드를 매개변수화합니다.
  • 빌드를 호출하기 전에 호출 시 정의된 대체 변수 값을 재정의합니다.

호스팅된 저장소 대신 로컬에서 작업 중인 디렉터리에서 빌드를 실행하거나 트리거를 만들지 않고 빌드를 제출하려는 경우 작업 디렉터리에서 다음 gcloud 명령어를 실행하면 됩니다.

gcloud builds submit --config BUILD_CONFIG SOURCE_CODE

각 항목의 의미는 다음과 같습니다.

  • BUILD_CONFIG는 빌드 구성 파일의 경로입니다.
  • SOURCE_CODE는 경로 또는 URL 소스 코드입니다.

로컬 디렉터리에서 gcloud 명령어를 사용하여 수동으로 빌드를 시작하는 방법에 대한 상세 정보는 수동으로 빌드 시작을 참조하세요.

수동 트리거 만들기

콘솔

수동 트리거를 만들려면 다음 안내를 따르세요.

  1. 트리거 페이지를 엽니다.

    트리거 페이지 열기

  2. 페이지 상단에서 프로젝트를 선택하고 열기를 클릭합니다.

  3. 트리거 만들기를 클릭합니다.

  4. 다음 트리거 설정을 입력합니다.

    • 이름: 트리거의 이름입니다.

    • 리전: 트리거의 리전을 선택합니다.

      • 리전으로 전역을 선택하면 Cloud Build에서 기본 풀을 사용하여 빌드를 실행합니다.
      • 전역이 아닌 리전을 선택하고 트리거와 연결된 빌드 구성 파일에서 비공개 풀을 지정하면 Cloud Build가 비공개 풀을 사용하여 빌드를 실행합니다. 이 경우 트리거에 지정하는 리전은 비공개 풀을 만든 리전과 일치해야 합니다.
      • 전역이 아닌 리전을 선택하고 트리거와 연결된 빌드 구성 파일에서 비공개 풀을 지정하지 않으면 Cloud Build가 기본 풀을 사용하여 트리거와 동일한 리전에서 빌드를 실행합니다.

    • 설명(선택사항): 트리거에 대한 설명입니다.

    • 이벤트: 수동 호출을 선택하여 트리거를 수동으로 호출할 때만 빌드가 실행하도록 설정합니다.

    • 소스: 수동 트리거가 실행될 때 빌드할 저장소를 선택합니다. 1세대 또는 2세대를 소스로 지정할 수 있습니다.

    • 버전: 수동 트리거가 실행될 때 빌드할 브랜치 또는 태그를 선택합니다.

    • 분기: 이 분기에서 빌드할 트리거를 설정합니다. 리터럴 값을 지정해야 합니다. 정규 표현식은 현재 지원되지 않습니다.

    • 태그: 이 태그에 빌드할 트리거를 설정합니다. 리터럴 값을 지정해야 합니다. 정규 표현식은 현재 지원되지 않습니다.

    • 구성: 원격 저장소에 있는 빌드 구성 파일을 선택하거나 빌드에 사용할 인라인 빌드 구성 파일을 만듭니다.

      • 유형: 빌드에 사용할 구성의 유형을 선택합니다.
        • Cloud Build 구성 파일(yaml 또는 json): 구성에 대해 빌드 구성 파일을 사용합니다.
        • Dockerfile: 해당 구성에 Dockerfile을 사용합니다.

      • 위치: 구성의 위치를 지정합니다.

        • 저장소: 구성 파일이 원격 저장소에 있으면 빌드 구성 파일의 위치, Dockerfile 디렉터리 또는 빌드팩 디렉터리를 제공합니다. 빌드 구성 유형이 Dockerfile 또는 빌드팩이면 결과 이미지의 이름을 제공하고, 선택적으로 빌드의 제한 시간을 제공해야 합니다. Dockerfile 또는 빌드팩 이미지 이름을 제공한 경우 빌드가 실행할 docker build 또는 pack 명령어의 미리보기가 표시됩니다.
        • 인라인: Cloud Build 구성 파일(yaml 또는 json)을 구성 옵션으로 선택한 경우 빌드 구성을 인라인으로 지정할 수 있습니다. YAML 또는 JSON 구문을 사용하여 Google Cloud 콘솔에서 빌드 구성 파일을 작성하려면 편집기 열기를 클릭합니다. 빌드 구성을 저장하려면 완료를 클릭합니다.

  5. 만들기를 클릭하여 수동 트리거를 만듭니다.

gcloud

플래그 전체 목록은 수동 트리거를 만드는 방법에 대한 gcloud 참조를 확인하세요.

수동 트리거 실행

콘솔

Google Cloud Console을 사용하여 수동 트리거를 실행하려면 다음 안내를 따르세요.

  1. Google Cloud Console에서 트리거 페이지를 엽니다.

    트리거 페이지 열기

  2. 목록에서 트리거를 찾습니다.

  3. 트리거 실행을 클릭합니다.

    트리거 실행을 클릭하면 오른쪽에 트리거 실행 창이 표시됩니다. 분기 이름, 태그 이름 또는 대체 변수와 같은 필드를 지정한 경우 호출 시 이러한 필드를 재정의할 수 있습니다.

    대체할 새 변수 값을 지정한 경우 트리거 실행을 클릭하여 빌드를 실행하세요.

    일정에 따라 수동 트리거를 실행하려면 빌드 예약을 참조하세요.

gcloud

gcloud 명령줄 도구를 사용하여 수동 트리거를 실행하려면 다음 명령어를 실행합니다.

      gcloud builds triggers run TRIGGER_NAME \
         --region=REGION \
         --branch=BRANCH_NAME \
         --substitutions=SUBSTITUTION_VAR=SUBSTITUTION_VALUE

각 항목의 의미는 다음과 같습니다.

  • TRIGGER_NAME은 트리거의 이름입니다.
  • REGION: 트리거의 리전입니다.
  • BRANCH_NAME은 브랜치 이름입니다. --tag를 사용하여 태그를 지정하거나 --sha를 사용하여 커밋 ID를 지정할 수도 있습니다.
  • [선택사항]SUBSTITUTION_VAR은 대체 값의 변수 이름입니다.
  • [선택사항] SUBSTITUTION_VALUE는 대체 변수와 연결된 값입니다.

일정에 따라 수동 트리거를 실행하려면 빌드 예약을 참조하세요.

다음 단계