이 페이지에서는 소스 저장소에서 코드를 빌드하기 위해 수동 트리거를 만드는 방법을 설명합니다. 수동 트리거를 사용하면 빌드를 실행하기 전에 호출 시 정의된 대체 변수 값을 재정의할 수 있는 기능을 통해 빌드를 수동으로 호출할 수 있습니다. 또한 수동 트리거가 특정 시간에 자동으로 실행되도록 예약할 수 있습니다.
gcloud CLI 또는 Cloud Build API를 사용하여 수동으로 빌드를 시작하는 방법은 수동으로 빌드 시작을 참조하세요.
시작하기 전에
Cloud Build API를 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면
serviceusage.services.enable권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한을 이미 보유하고 있을 가능성이 높습니다. 그렇지 않은 경우 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할을 부여하는 방법을 알아보세요.
- 소스 코드를 준비하세요.
수동 트리거
수동 트리거를 사용하면 연결된 저장소에서 트리거를 호출할 때만 실행되는 빌드를 설정할 수 있습니다. 예를 들어 스테이징 또는 프로덕션 환경에 소스 코드를 배포하기 위한 파이프라인을 만듭니다. 워크플로를 자동화하려 할 수 있지만 수동으로만 빌드를 실행하려고 합니다. 이를 위해 수동 트리거를 정의할 수 있습니다.
수동 트리거를 사용하면 다음을 통해 빌드를 수동으로 호출할 수 있습니다.
- 지정된 브랜치 또는 태그가 있는 호스팅된 저장소에서 소스 코드를 가져옵니다.
- 빌드를 실행할 때마다 수동으로 전달할 필요가 없는 대체 변수로 빌드를 매개변수화합니다.
- 빌드를 호출하기 전에 호출 시 정의된 대체 변수 값을 재정의합니다.
호스팅된 저장소 대신 로컬에서 작업 중인 디렉터리에서 빌드를 실행하거나 트리거를 만들지 않고 빌드를 제출하려는 경우 작업 디렉터리에서 다음 gcloud 명령어를 실행하면 됩니다.
gcloud builds submit --config BUILD_CONFIG SOURCE_CODE
각 항목의 의미는 다음과 같습니다.
- BUILD_CONFIG는 빌드 구성 파일의 경로입니다.
- SOURCE_CODE는 경로 또는 URL 소스 코드입니다.
로컬 디렉터리에서 gcloud 명령어를 사용하여 수동으로 빌드를 시작하는 방법에 대한 상세 정보는 수동으로 빌드 시작을 참조하세요.
수동 트리거 만들기
콘솔
수동 트리거를 만들려면 다음 안내를 따르세요.