일정 생성
Application Service > Cloud Scheduler > 콘솔 사용 가이드 > 일정 생성
일정은 기본 정보, 대상 정보, 추가 설정 정보로 구성됩니다.
- 기본 정보: 일정 실행을 위한 유형, 주기, 시작/종료 일시를 선택합니다.
- 대상 정보: 일정이 호출한 API 정보 및 HTTP 메서드, 헤더, 파라미터를 입력합니다.
- 추가 설정: 일정 활성화/비활성화 여부 및 재시도 정책(횟수, 간격)을 설정합니다.
여기서는 일정 생성하는 단계를 자세하게 안내합니다.
일정 생성하기
일정을 생성하려면 먼저 Cloud Scheduler 서비스를 활성화해야 합니다. 프로젝트 서비스 활성화 가이드를 참고하여 Cloud Scheduler 서비스를 활성화하세요.
-
NHN Cloud 콘솔에서 Application Service > Cloud Scheduler를 클릭하세요.
-
+ 일정 생성을 클릭하세요.
-
템플릿을 사용한다면 사용으로 선택하세요.
-
사용하고 싶은 템플릿이 있다면 선택하세요.
-
기본 정보 설정을 입력한 뒤 다음을 클릭하세요.
-
대상 유형을 선택합니다. 대상 유형은 직접 입력 또는 대상 템플릿을 선택할 수 있으며, 선택한 유형에 따라 입력하는 항목이 달라집니다.
-
직접 입력: 대상 정보를 직접 입력합니다.
* URL: 호출할 URL을 입력합니다. 최대 255자까지 입력할 수 있습니다.
* HTTP 메서드: 드롭다운 목록을 클릭해 HTTP 메서드를 선택합니다.
* HTTP 헤더: + 추가를 클릭해 HTTP 헤더를 입력합니다. HTTP 헤더는 최대 20개까지 추가할 수 있으며, 추가한 전체 헤더 크기를 합산해 최대 8KB까지 입력할 수 있습니다.
* 파라미터: 요청 본문을 입력합니다. HTTP 메서드를 POST, PUT, PATCH로 선택 시 파라미터 필드가 표시됩니다. 입력 가능한 파라미터 크기는 256KB입니다.
- 대상 템플릿: Cloud Scheduler에서 제공하는 대상 템플릿에 따라 대상 정보를 입력합니다.
-
추가 설정을 완료한 뒤 다음을 클릭하세요.
- 일정 활성화: 일정 활성화 여부를 선택합니다.
- 재시도 정책: 일정 실행을 실패했을 때 다시 시도하도록 설정할 수 있습니다. 설정을 선택하면 재시도 간격과 최대 재시도 횟수 필드가 표시됩니다.
- API 호출을 실패할 경우 설정한 재시도 정책에 따라 일정을 재시도합니다.
- API 성공 기준은 타임아웃 및 결과 검증 조건에 따라 달라집니다.
- 재시도 간격: 실패한 일정을 재시도할 간격을 입력합니다. 최소 1분에서 최대 60분까지 설정할 수 있습니다.
- 최대 재시도 횟수: 최대 재시도 횟수를 입력합니다. 최대 5회까지 설정할 수 있습니다.
- 타임아웃: API 호출의 타임아웃 시간을 입력합니다. API 수행 시간이 설정한 시간을 초과하면, 해당 호출은 실패로 처리됩니다.
- 결과 검증: API 호출 응답에 대한 검증 기준을 설정할 수 있습니다. 사용자 설정을 선택하면 결과 검증 조건과 조건 결합 방식 필드가 표시됩니다.
- 결과 검증 조건: 검증 타입, 대상, 값, 연산자를 입력하여 결과 검증 조건을 설정합니다. 최대 10개까지 추가할 수 있습니다.
- 검증 타입: 다음 중 하나를 선택합니다.
- HTTP Status Code: 응답의 HTTP 상태 코드를 검증합니다.
- Response Body: 응답 본문을 검증합니다.
- Response Body(Optional): 응답 본문을 검증합니다. 대상에 입력한 검증 필드가 응답 본문에 존재하지 않을 경우, ‘True’로 처리됩니다.
- Header: 응답 헤더를 검증합니다.
- 대상: 검증 타입에 따라 검증할 필드를 입력합니다. 최대 50자까지 입력할 수 있습니다.
- HTTP Status Code: 입력할 대상이 없으므로 비활성화됩니다.
- Response Body: JSONPath를 입력하여 검증할 필드를 지정합니다. 자세한 내용은 하단의 예시를 참고하세요.
- Response Body(Optional): JSONPath를 입력하여 검증할 필드를 지정합니다. 자세한 내용은 하단의 예시를 참고하세요.
- Header: 검증할 헤더 이름을 입력합니다.
- 값: 검증할 대상의 값을 입력합니다. 최대 20자까지 입력할 수 있습니다. HTTP Status Code를 검증하는 경우 입력 가능한 범위는 100~599입니다.
- 연산자: 결과 검증 시 사용할 연산자를 선택합니다.
- 조건 결합 방식: 여러 검증 조건을 조합할 때의 방식을 선택합니다.
- 모든 조건 일치: 모든 조건이 ‘True’일 경우 결과를 성공으로 처리합니다.
- 일부 조건 일치: 하나라도 ‘True’인 조건이 있으면 결과를 성공으로 처리합니다.
Response Body(Optional 포함) JSONPath 대상 입력 예시
{
"firstName": "NHN",
"lastName" : "Cloud",
"phoneNumbers": [
{
"type" : "iPhone",
"number": "0123-4567-8888"
},
{
"type" : "galaxy",
"number": "0123-4567-8910"
}
]
}
* 위 응답 본문의 firstName 필드를 검증할 경우 JSONPath: $.firstName
* 위 응답 본문의 phoneNumbers 필드의 두 번째 객체의 type 필드를 검증할 경우 JSONPath: $.phoneNumbers[1].type
* JSONPath 공식 가이드
- 최종 검토 및 저장 단계에서 앞서 설정한 정보를 확인한 뒤 일정 생성을 클릭하세요.
알아두기
- 템플릿 기능을 이용하여 미리 설정해 둔 정보를 빠르게 입력할 수 있습니다. 템플릿 관리를 참고하세요.
- Cron식은 5개의 필드로 작성하며, 필드는 순서대로 '분 시 일 월 요일'입니다.
- 원활한 일정 실행을 위해 시작 일시를 현재 시각보다 5분 이상 여유롭게 설정하세요.
- 생성한 일정이 반영되는 데 최대 30초까지 걸릴 수 있습니다. 따라서 해당 시간 동안 활성화/비활성화를 포함한 일정 내용 변경에 실패할 수 있습니다.
주의
- Cron식은 한국 표준시(UTC+09:00) 기준으로 동작합니다. 예를 들어, '0 9 * * *'로 입력하면 매일 한국 시간으로 오전 9시에 작업이 실행됩니다.
- 반복 유형을 Rate로 선택한 경우 일정 실행은 시작 일시와 Rate 값에 따라 변경될 수 있습니다. Rate 일정의 동작 방식 및 일정 실행 예시를 참고하여 올바르게 설정하세요.
Rate 일정의 동작 방식
Rate 일정은 설정한 시간 간격에 따라 일정을 실행합니다.
여기에서는 Rate 일정의 동작 방식을 설명합니다.
- 최초 시작 일시: Rate 일정이 최초 시작되는 날짜는 사용자가 설정한 시작 일시입니다.
- 일정 실행 시간: Rate 일정의 실행 시간은 시작 일시를 기준으로 사용자가 설정한 Rate 간격마다 실행됩니다. 이는 비활성화 후 활성화 시에도 동일하게 적용됩니다.
- Rate 변경 시: Rate가 변경되면 변경된 Rate 간격에 따라 일정이 실행됩니다. 단, 직전 실행 시간과는 무관하게 시작 일시를 기준으로 변경된 Rate 간격에 맞게 실행됩니다.
일정 실행 예시
일정이 실행하는 시각은 설정한 시작 일시와 종료 일시, 그리고 어떠한 일정 유형으로 입력했는냐에 따라 다릅니다.
여기에서는 사용자의 이해를 돕기 위해 동일한 시작 일시와 종료 일시일 때 Cron, Rate 일정 유형에 따른 일정 실행 예시를 보여줍니다.
알아두기
일정 실행 예시의 날짜 데이터는 한국 표준시(UTC+09:00) 기준입니다.
- 시작 일시: 2024-01-05 00:00:00
- 종료 일시: 2024-01-08 01:00:00
- Cron 일정일 경우
- Cron식: 0 12 * * * (매일 낮 12시 실행)
- 첫 일정 실행 시간
- 마지막 일정 실행 시간
- Rate 일정일 경우
- 일반적인 상황
- Rate: 12시간마다 실행
- 첫 일정 실행 시간
- 마지막 일정 실행 시간
- 일정 비활성화 후 활성화
- Rate: 3시간마다 실행
- 1차 실행
- 2차 실행
- 일정 비활성화
- 일정 활성화
- 3차 실행
- 4차 실행
- Rate 변경
- Rate: 3시간마다 실행
- 1차 실행
- 2차 실행
- Rate: 4시간마다 실행으로 변경
- 3차 실행
- 4차 실행