Cloud Scheduler 트리거

Cloud Scheduler 트리거를 사용하면 정의된 기간 또는 여러 리전 간에 일정한 간격으로 통합 실행을 예약할 수 있습니다.

Cloud Scheduler 트리거는 Cloud Scheduler 서비스를 활용하여 Apigee Integration 내에서 완전 관리형 엔터프라이즈급 크론 작업 스케줄러를 제공합니다. 이제 이 트리거를 사용하여 Apigee Integration UI와 Cloud Scheduler 대시보드에서 통합 내에 생성된 모든 크론 작업을 관리할 수 있습니다. 또한 Cloud Scheduler 트리거를 사용하면 리전 간 크론 작업을 배포하여 통합 실행을 예약할 수 있습니다.

예를 들어 통합을 us-central1에 프로비저닝한 경우 Cloud Scheduler 트리거를 사용하여 크론 작업을 asia-east1(또는 Cloud 스케줄러에 지원되는 모든 Google Cloud 리전)에 배포하여 us-central1에 있는 통합의 엔드포인트를 호출할 수 있습니다.

시작하기 전에

Cloud Scheduler 트리거를 구성하기 전에 Google Cloud 프로젝트에서 다음 태스크를 수행해야 합니다.

  1. Cloud Scheduler API(cloudscheduler.googleapis.com) 사용 설정

    Cloud Scheduler API 사용 설정

  2. Apigee Integration 호출자 역할이 할당된 Google 서비스 계정이 있는지 확인합니다. 서비스 계정이 없으면 새 서비스 계정을 만들고 Apigee Integration 호출자 역할을 할당해야 합니다.

    서비스 계정 만들기 및 관리에 대한 자세한 내용은 서비스 계정 만들기 및 관리를 참조하세요.

    사전 정의된 Apigee Integration 역할에 대한 자세한 내용은 사전 정의된 IAM 역할을 참조하세요.

Cloud Scheduler 트리거 추가

Cloud Scheduler 트리거를 통합에 추가하려면 다음 단계를 수행합니다.

  1. Apigee UI에서 Apigee 조직을 선택합니다.
  2. 개발 > 통합을 클릭합니다.
  3. 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.

    새 통합을 만드는 경우:

    1. 통합 만들기 대화상자에 이름과 설명을 입력합니다.
    2. 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
    3. 만들기를 클릭합니다.

    통합 디자이너 페이지에서 통합이 열립니다.

  4. 통합 디자이너 탐색 메뉴에서 +태스크/트리거 추가 > 트리거를 클릭하여 사용 가능한 트리거 목록을 봅니다.
  5. 통합 편집기에서 Cloud Scheduler 트리거 요소를 클릭하여 배치합니다.

Cloud Scheduler 트리거 구성

Cloud Scheduler 트리거를 구성하려면 다음 단계를 수행하세요.

  1. 통합 편집기에서 Cloud Scheduler 트리거 요소를 클릭하여 트리거 구성 창을 엽니다.

    다음 옵션 중 하나를 사용하여 Cloud Scheduler 트리거의 일정을 지정합니다.

    • 기본: 사용자 인터페이스를 사용하여 크론 작업 일정을 구성합니다.
    • 고급: unix-cron 표현식을 사용하여 크론 작업 일정을 구성합니다.
  2. (기본 옵션의 경우) 기본 탭을 선택하고 표시된 필드에서 다음을 수행합니다.
    1. 시간: 통합을 실행해야 하는 시간 간격을 선택합니다.
      • 특정 시간에 실행: 특정 시간에 통합을 실행하려면 이 옵션을 선택합니다.
      • 매시간 반복: 매시간 통합을 반복적으로 실행하려면 이 옵션을 선택합니다.
      • 매분 반복: 지정된 시간(분)에 따라 통합을 반복적으로 실행하려면 이 옵션을 선택합니다.
    2. 일: 통합이 실행되어야 하는 날짜를 선택합니다. 매일, 특정 요일, 특정 날짜 등에 통합을 실행할 수 있습니다.
    3. 월: 통합이 실행되어야 하는 월을 선택합니다. 매달 또는 특정 달에 통합을 실행할 수 있습니다.
  3. (고급 옵션의 경우) 고급 탭을 선택하고 크론 표현식을 사용하여 크론 작업의 일정을 지정합니다.

    크론 표현식에는 다음 순서로 지정되어야 하는 5개 값이 포함됩니다.

    1. 분(0-59)
    2. 시간(0-23)
    3. 일자(1-31)
    4. 월입니다. 다음 값 중 하나입니다.
      • 1-12 사이의 숫자
      • 세 글자 월 약어(예: Jan, Feb, Mar)
    5. 요일입니다. 다음 값 중 하나입니다.
      • 0~6 사이의 숫자, 일요일은 0부터 시작
      • 세 글자 요일 약어(예: Mon, Tue, Wed)

    예를 들어 매월 1일에 통합을 실행하려면 * * 1 * * 크론 표현식을 사용합니다.

    자세한 내용은 크론 작업 일정 구성을 참조하세요.

  4. 리전: Cloud Scheduler 작업을 배포할 리전을 선택합니다.
  5. 서비스 계정 이메일: 생성된 Google 서비스 계정 이메일 주소를 입력합니다.

트리거 출력

통합 버전에서 구성되고 게시된 각 Cloud Scheduler 트리거에 대해 Apigee 통합은 Google Cloud 프로젝트에 새 Cloud Scheduler 작업을 만듭니다.

작업 중복 오류가 방지되도록 다음 이름 지정 규칙에 따라 Cloud Scheduler 작업이 생성되었습니다. 

    INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER

예시: DemoIntegration__V1__1

트리거 로그

Cloud Scheduler 트리거는 각 통합 실행의 시작과 끝에서 로그를 생성합니다. Cloud Logging 로그 탐색기 페이지에서 Cloud Scheduler 트리거 로그를 볼 수 있습니다.

  1. Google Cloud Console에서 Cloud Scheduler 페이지로 이동합니다.

    Cloud Scheduler로 이동

  2. Cloud Scheduler 작업을 찾고 로그 열에서 보기를 클릭합니다.

    Cloud Logging 로그 탐색기 페이지가 나타나고 Cloud Scheduler 트리거에 의해 생성된 로그가 표시됩니다.

Cloud Scheduler 트리거 수정

Apigee Integration

Apigee Integration에서 Cloud Scheduler 트리거를 수정하려면 다음 단계를 수행합니다.

  1. Apigee UI에서 Apigee 조직을 선택합니다.
  2. 개발 > 통합을 클릭합니다.
  3. 수정하려는 통합을 선택합니다.
  4. 통합 편집기에서 버전 드롭다운을 클릭하고 수정할 Cloud Scheduler 트리거가 포함된 통합 버전을 선택합니다.
  5. 선택한 통합 버전이 게시된 경우(활성 상태) 게시 취소하고 수정을 사용 설정합니다.
  6. 통합 편집기에서 Cloud Scheduler 트리거 요소를 클릭하여 트리거 구성 창을 엽니다.
  7. Cloud Scheduler 작업 구성을 원하는 대로 수정합니다.

Cloud Scheduler

Cloud Scheduler에서 Cloud Scheduler 작업의 구성을 수정하여 Cloud Scheduler 트리거를 수정할 수 있습니다.

  1. Google Cloud 콘솔에서 Cloud Scheduler로 이동합니다.

    Cloud Scheduler로 이동

  2. 수정할 Cloud Scheduler 작업을 선택합니다.
  3. 수정을 클릭합니다.
  4. Cloud Scheduler 작업 구성을 원하는 대로 수정합니다.

Cloud Scheduler 작업 일시중지, 재개, 복사

Apigee Integration은 Cloud Scheduler 트리거를 사용하여 만든 Cloud Scheduler 작업의 일시중지, 재개, 복사 작업을 지원하지 않습니다.

Cloud Scheduler에서 Cloud Scheduler 작업 실행을 수동으로 일시중지하면 트리거 스케줄러 창에 Cloud Scheduler 트리거로부터 오류가 발생합니다.

Cloud Scheduler 트리거 오류 메시지에 대한 자세한 내용은 Cloud Scheduler 트리거 문제 해결을 참조하세요. Cloud Scheduler를 사용하여 크론 작업을 일시중지하고 재개하는 방법은 작업 일시중지 또는 재개를 참조하세요.

Cloud Scheduler 작업 삭제

Apigee Integration의 통합 내에서 또는 Cloud Scheduler에서 Cloud Scheduler 작업을 삭제할 수 있습니다.

Apigee Integration

Apigee Integration에서 Cloud Scheduler 작업을 삭제하려면 다음 단계를 수행하세요.

  1. Apigee UI에서 Apigee 조직을 선택합니다.
  2. 개발 > 통합을 클릭합니다.
  3. 수정하려는 통합을 선택합니다.
  4. 통합 편집기에서 버전 드롭다운을 클릭하고 삭제할 Cloud Scheduler 트리거가 포함된 통합 버전을 선택합니다.
  5. 선택한 통합 버전을 게시 취소합니다.

    해당 통합 버전의 Cloud Scheduler 작업이 삭제됩니다.

Cloud Scheduler

Cloud Scheduler에서 Cloud Scheduler 작업을 삭제하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 Cloud Scheduler로 이동합니다.

    Cloud Scheduler로 이동

  2. 삭제할 Cloud Scheduler 작업을 선택합니다.
  3. Delete(삭제)를 클릭합니다.

    해당 통합 버전의 Cloud Scheduler 작업이 삭제됩니다.

권장사항

Cloud Scheduler 트리거가 더 이상 필요하지 않은 경우 게시 취소하는 것이 좋습니다. 중복 Cloud Scheduler 트리거를 게시한 상태로 두면 트리거가 계속 통합을 자동으로 호출하므로 추가 요금이 부과될 수 있습니다.

Cloud Scheduler 트리거 문제 해결

다음 표에서는 Cloud Scheduler 트리거에서 발생할 수 있는 오류와 오류의 해당 원인을 설명합니다.

오류 위치 오류 발생 오류 메시지 가능한 원인 해결 방법
트리거 구성 창 > 오류 메시지 Cloud Scheduler 작업이 통합 실행을 중지하는 경우 The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB doesn’t exist. It might be deleted from your Google Cloud project. Cloud Scheduler 작업은 Cloud Scheduler를 사용하여 삭제됩니다. 새 통합 버전을 만들어 기존 Cloud Scheduler 작업을 덮어씁니다.
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is PAUSED. You must RESUME the job from your Google Cloud project. Cloud Scheduler 작업은 Cloud Scheduler를 사용하여 일시중지됩니다. Cloud Scheduler에서 Cloud Scheduler 작업을 재개합니다.
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is DISABLED due to an internal system error. 트리거 로그를 확인하여 문제를 식별하세요. 새 통합 버전을 만들어 기존 Cloud Scheduler 작업을 덮어씁니다.
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is in an UPDATE_FAILED state due to a failed CloudScheduler.UpdateJob operation. 제공된 서비스 계정에 필요한 IAM 권한이 없습니다. 이 상태에서 작업을 복구하려면 성공적인 응답이 수신될 때까지 CloudScheduler.UpdateJob 작업을 다시 시도하세요.
The last execution of the Cloud Scheduler job CLOUD_SCHEDULER_JOB failed due to CLOUD_SCHEDULER_JOB_ISSUE. Learn more. CLOUD_SCHEDULER_JOB_ISSUE 해당 사항 없음