예약 트리거를 사용하면 주기적으로 특정 시간 간격마다 통합을 실행할 수 있습니다. 이 트리거는 수동 개입 없이 통합을 자동으로 실행하려는 경우에 유용합니다. 예를 들어 다음 유형의 태스크에 예약 트리거를 사용할 수 있습니다.
- 일정한 간격으로 한 시스템에서 다른 시스템으로 파일 업로드
- 정기 이메일 알림 보내기
- 일정한 간격으로 데이터베이스 동기화
시작하기 전에
Google Cloud 프로젝트의 Apigee 서비스 에이전트(
service-PROJECT_ID
@gcp-sa-apigee.iam.gserviceaccount.com
)에 Apigee 통합 호출자 IAM 역할을 할당해야 합니다.
IAM 역할 할당에 대한 자세한 내용은 Google Cloud에서 액세스 관리를 참조하세요.
예약 트리거 추가
신규 또는 기존 통합에 예약 트리거를 추가하려면 다음 단계를 수행하세요.- Apigee UI에서 Apigee 조직을 선택합니다.
- 개발 > 통합을 클릭합니다.
- 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
- 통합 만들기 대화상자에 이름과 설명을 입력합니다.
- 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
- 만들기를 클릭합니다.
통합 디자이너 페이지에서 통합이 열립니다.
- 통합 디자이너 탐색 메뉴에서 +태스크/트리거 추가 > 트리거를 클릭하여 사용 가능한 트리거 목록을 봅니다.
- 예약 트리거 요소를 클릭하여 디자이너에 배치합니다.
예약 트리거 구성
통합 편집기에서 예약 트리거 요소를 클릭하여 트리거 구성 창을 봅니다.
다음 모드 중 하나를 사용하여 예약 트리거를 구성할 수 있습니다.
- 기본: 실행 빈도를 구성하기 위한 사용자 인터페이스를 제공합니다.
- 고급: 크론 표현식을 사용하여 실행 빈도를 구성합니다.
기본 모드에서는 특정 시간 또는 시간별 간격으로 통합을 실행할 수 있습니다. 특정 시간에 통합을 실행하려면 시간 드롭다운에서 특정 시간에 실행을 선택하고 다음 속성을 설정합니다.
- 시간: 통합이 실행되어야 하는 시간입니다(24시간 형식).
- 일: 통합이 실행되어야 하는 날짜입니다. 매일, 특정 요일, 특정 날짜 등에 통합을 실행할 수 있습니다.
- 월: 통합이 실행되어야 하는 월입니다. 매달 통합을 실행하거나 특정 월을 선택할 수 있습니다.
고급 모드에서는 크론 표현식을 사용하여 실행 빈도를 지정할 수 있습니다. 크론 표현식에는 다음 순서로 지정되어야 하는 5개 값이 포함됩니다.
- 분(0-59)
- 시간(0-23)
- 일자(1-31)
- 월입니다. 다음 값 중 하나입니다.
- 1-12 사이의 숫자
- 세 글자 월 약어(예: Jan, Feb, Mar 등)
- 요일입니다. 다음 값 중 하나입니다.
- 0~6 사이의 숫자, 일요일은 0부터 시작
- 세 글자 요일 약어(예: Mon, Tue, Wed 등)
예를 들어 매월 1일에 통합을 실행하려면 * * 1 * * 크론 표현식을 사용합니다.
권장사항
예약 트리거가 더 이상 필요하지 않으면 비활성화하는 것이 좋습니다. 중복된 예약 트리거를 활성 상태로 두면 자동으로 통합이 계속 트리거됩니다.
예약 트리거를 비활성화하려면 다음 중 하나를 수행하면 됩니다.
- 예약 트리거가 포함된 통합을 게시 취소합니다. 통합이 더 이상 활성 상태가 아니며 트리거가 실행되지 않습니다.
- 예약 트리거를 다른 트리거로 바꾸고 통합을 다시 게시합니다. 다시 게시된 활성 버전의 통합에서는 예약 트리거를 사용하지 않습니다.
- 현재 통합 버전을 삭제합니다. 삭제 옵션은 통합 이름 옆에 있는 버전 목록 아래에 있습니다.