빌드 예약

이 페이지에서는 Google Cloud 콘솔을 사용하여 사전 정의된 일정으로 빌드를 실행하는 방법을 설명합니다. 빌드를 예약하려면 수동 트리거를 만든 다음 Cloud Scheduler를 사용하여 트리거를 호출해야 합니다.

시작하기 전에

  • Cloud Build API 사용 설정

    API 사용 설정

  • 소스 코드를 준비하세요.
  • 아직 트리거하지 않았다면 수동 트리거를 만듭니다. 트리거가 수동 트리거인 경우에만 빌드를 예약할 수 있습니다.

빌드 예약

수동 트리거 만든 후 빌드를 예약할 준비가 되었습니다.

빌드를 예약하려면 다음 안내를 따르세요.

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

    트리거 페이지 열기

  2. 실행하려는 수동 트리거의 이름이 포함된 행을 일정에서 찾습니다.

  3. 트리거가 포함된 행의 오른쪽 끝에 있는 메뉴(세로 타원)를 클릭합니다.

  4. 빌드를 예약하려면 일정에 따라 실행을 클릭합니다.

    오른쪽에 일정에 따라 트리거 실행 패널이 표시됩니다.

  5. Cloud Scheduler API를 사용 설정합니다.

    빌드를 처음 예약할 때만 Cloud Scheduler API를 사용 설정하라는 메시지가 표시됩니다.

  6. 트리거를 호출할 때 Cloud Scheduler에서 사용할 서비스 계정을 선택합니다.

    다음 형식의 기본 예약 서비스 계정을 선택하는 것이 좋습니다. 여기서 PROJECT_ID는 프로젝트의 프로젝트 ID입니다.

     cloud-build-trigger-scheduler@PROJECT_ID.iam.gserviceaccount.com

    기본 예약 서비스 계정을 선택하면 Cloud Build 편집자 IAM 역할이 부여된 계정이 자동으로 생성됩니다. 이 서비스 계정은 Cloud Scheduler에서 빌드 예약에 사용되므로 삭제하지 않는 것이 좋습니다. 실수로 이 서비스 계정을 삭제하거나 IAM 권한을 취소한 경우 IAM 페이지로 이동하여 수동으로 서비스 계정을 추가하고 Cloud Build 편집자 역할을 부여해야 합니다. 서비스 계정이 다시 생성되면 기존 Cloud Scheduler 작업이 다시 시작될 때까지 최대 1시간이 소요될 수 있습니다.

  7. 계속을 클릭합니다.

    선택한 리전이 없으면 다음 단계를 진행하기 전에 Cloud Scheduler 작업의 리전을 선택하라는 메시지가 표시될 수 있습니다. 리전을 선택하면 App Engine 애플리케이션이 프로젝트에 자동으로 생성됩니다. 나중에 프로젝트의 리전을 변경할 수 없습니다. 자세한 내용은 지원되는 리전을 참조하세요.

  8. 다음 Cloud Scheduler 작업 설정을 입력합니다.

    • 이름: Cloud Scheduler 작업의 이름입니다.
    • 설명(선택사항): Cloud Scheduler 작업에 대한 설명입니다.
    • 빈도: 트리거를 실행할 빈도를 선택합니다. 드롭다운 메뉴에서 빈도를 선택하거나 크론 구문을 사용하여 커스텀 값을 입력할 수 있습니다. 예를 들어 수동 트리거가 매일 오전 6시에 실행되도록 하려면 크론 구문의 빈도를 0 6 * * *로 지정합니다. 크론 구문에 대한 자세한 내용은 크론 작업 일정 구성을 참조하세요.
    • 시간대: 시간대를 선택합니다.

  9. 만들기를 클릭하여 Cloud Scheduler 작업을 만듭니다.

    각 수동 트리거마다 스케줄러 작업을 여러 개 만들 수 있습니다.

  10. Cloud Scheduler 작업을 보려면 보기를 클릭합니다. 그렇지 않으면 완료를 클릭하여 패널을 닫습니다.

Cloud Scheduler 작업 업데이트

수동 트리거의 버전 필드를 업데이트하면 트리거와 연결된 Cloud Scheduler 작업을 수동으로 업데이트해야 합니다. 예를 들어 수동 트리거의 분기 이름을 업데이트하는 경우 작업의 분기 이름을 수동으로 업데이트해야 합니다.

Cloud Scheduler 작업을 업데이트하려면 다음 안내를 따르세요.

  1. Cloud Scheduler를 엽니다.

    Cloud Scheduler 페이지 열기

    Cloud Scheduler 작업 목록이 표시됩니다.

  2. [선택사항] 트리거와 연결된 Cloud Scheduler 작업을 파악합니다.

    1. 다음 명령어를 실행하여 트리거 ID를 가져옵니다. 여기서 TRIGGER_NAME은 트리거 이름입니다.

      gcloud builds triggers describe TRIGGER_NAME

    2. 트리거 ID를 기록해 둡니다.

    3. 테이블 상단의 필터 막대에 트리거 ID를 입력합니다.

    트리거와 연결된 Cloud Scheduler 작업 목록이 표시됩니다.

  3. 업데이트할 작업의 이름이 포함된 행을 클릭합니다.

  4. 페이지 상단의 수정을 클릭합니다.

    Cloud Scheduler 작업을 업데이트하는 양식이 표시될 것입니다.

  5. 본문 필드에서 버전을 업데이트하세요.

  6. 업데이트를 클릭합니다.

이제 Cloud Scheduler 작업의 트리거와 연결된 버전이 업데이트되었습니다.

Cloud Scheduler 작업 삭제

트리거를 삭제 또는 사용 중지해도 트리거 일정을 예약할 때 자동으로 생성된 모든 Cloud Scheduler 작업을 자동으로 삭제하거나 사용 중지하지는 않습니다. 작업은 계속 존재하며 빌드는 계속 호출될 것입니다.

지정된 시간에 트리거가 더 이상 실행되지 않도록 하려면 Cloud Scheduler 작업을 삭제하세요.

다음 단계