다음을 통해 공유

CLI(v2) 작업 일정 YAML 스키마

  • 아티클

적용 대상:Azure CLI ml 확장 v2(현재)

원본 JSON 스키마는 .에서 https://azuremlschemas.azureedge.net/latest/schedule.schema.json찾을 수 있습니다.

참고 항목

이 문서에 자세히 설명된 YAML 구문은 최신 버전의 ML CLI v2 확장에 대한 JSON 스키마를 기반으로 합니다. 이 구문은 최신 버전의 ML CLI v2 확장에서만 작동하도록 보장됩니다. https://azuremlschemasprod.azureedge.net/에서 이전 확장 버전에 대한 스키마를 찾을 수 있습니다.

YAML 구문

키 형식 설명 허용된 값
$schema string YAML 스키마입니다.
name string 필수입니다. 일정의 이름입니다.
description string 일정에 대한 설명입니다.
tags 개체 일정에 대한 태그 사전입니다.
trigger 개체 작업을 트리거할 때 규칙을 정의하는 트리거 구성입니다. RecurrenceTrigger 또는 CronTrigger 중 하나가 필요합니다.
create_job 개체 또는 문자열 필수입니다. 일정에 의해 트리거될 작업의 정의입니다. string 또는 JobDefinition 중 하나가 필요합니다.

트리거 구성

되풀이 트리거

키 형식 설명 허용된 값
type string 필수입니다. 일정 유형을 지정합니다. 되풀이
frequency string 필수입니다. 일정이 실행되는 빈도를 설명하는 시간 단위를 지정합니다. minute, hour, day, weekmonth
interval 정수 필수입니다. 일정이 실행되는 간격을 지정합니다.
start_time string 시작 날짜와 시간을 시간대와 함께 설명합니다. start_time이 생략되면 첫 번째 작업이 즉시 실행되고 스케줄에 따라 이후 작업이 트리거됩니다. 즉, start_time은 작업 생성 시간과 동일합니다. 시작 시간이 과거이면 첫 번째 작업은 계산된 다음 런타임에 실행됩니다.
end_time string 종료 날짜와 시간을 시간대와 함께 설명합니다. end_time을 생략하면 명시적으로 사용하지 않도록 설정될 때까지 일정이 계속 실행됩니다.
timezone string 되풀이의 표준 시간대를 지정합니다. 생략하면 기본적으로 UTC입니다. 시간대 값에 대한 부록을 참조하세요.
pattern 개체 되풀이의 패턴을 지정합니다. 패턴이 생략되면 start_time, 빈도 및 간격의 논리에 따라 작업이 트리거됩니다.

되풀이 일정

되풀이 일정은 hours, minutes 및 weekdays를 포함하는 되풀이 방법을 정의합니다.

  • 빈도가 day인 경우 패턴은 hours 및 minutes를 지정할 수 있습니다.
  • 빈도가 week 및 month인 경우 패턴은 hours, minutes 및 weekdays를 지정할 수 있습니다.
키 Type 허용된 값
hours 정수 또는 정수 배열 0-23
minutes 정수 또는 정수 배열 0-59
week_days 문자열 또는 문자열 배열 monday, tuesday, wednesday, thursday, friday, saturdaysunday

CronTrigger

키 형식 설명 허용된 값
type string 필수입니다. 일정 유형을 지정합니다. cron
expression string 필수입니다. 작업을 트리거하는 방법을 정의하는 cron 식을 지정합니다. 식은 표준 crontab 식을 사용하여 되풀이 일정을 표현합니다. 단일 식은 공백으로 구분된 5개의 필드로 구성됩니다(MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK).
start_time string 시작 날짜와 시간을 시간대와 함께 설명합니다. start_time이 생략되면 첫 번째 작업이 즉시 실행되고 스케줄에 따라 이후 작업이 트리거됩니다. 즉, start_time은 작업 생성 시간과 동일합니다. 시작 시간이 과거이면 첫 번째 작업은 계산된 다음 런타임에 실행됩니다.
end_time string 종료 날짜와 시간을 시간대와 함께 설명합니다. end_time을 생략하면 명시적으로 사용하지 않도록 설정될 때까지 일정이 계속 실행됩니다.
timezone string 되풀이의 표준 시간대를 지정합니다. 생략하면 기본적으로 UTC입니다. 시간대 값에 대한 부록을 참조하세요.

작업 정의

고객은 create_job: azureml:<job_name>을 직접 사용하거나 다음 속성을 사용하여 작업을 정의할 수 있습니다.

키 형식 설명 허용된 값
type string 필수입니다. 작업 형식을 지정합니다. 파이프라인 작업만 지원됩니다. pipeline
job string 필수입니다. 작업을 참조하는 방법을 정의합니다. azureml:<job_name> 또는 file:hello-pipeline.yml과 같은 로컬 파이프라인 작업 yaml일 수 있습니다.
experiment_name string 작업을 구성할 실험 이름입니다. 각 작업의 실행 기록은 스튜디오의 "실험" 탭에 있는 해당 실험 아래에 구성됩니다. 생략하면 일정 이름을 기본값으로 사용합니다.
inputs 개체 작업에 대한 입력의 사전입니다. 키는 작업의 컨텍스트 내에서 입력에 대한 이름이고 값은 입력 값입니다.
outputs 개체 작업의 출력 구성 사전입니다. 키는 작업의 컨텍스트 내에서 출력에 대한 이름이고 값은 출력 구성입니다.
settings 개체 파이프라인 작업에 대한 기본 설정입니다. 구성 가능한 속성 집합은 settings 키의 특성을 참조하세요.

settings 키의 특성

키 형식 설명 기본값
default_datastore string 파이프라인 작업의 기본 데이터 저장소로 사용할 데이터 저장소의 이름입니다. 이 값은 azureml:<datastore-name> 구문을 사용하여 작업 영역의 기존 데이터 저장소에 대한 참조여야 합니다. 부모 파이프라인 작업 또는 자식 단계 작업의 outputs 속성에 정의된 모든 출력은 이 데이터 저장소에 저장됩니다. 생략하면 출력은 작업 영역 Blob 데이터 저장소에 저장됩니다.
default_compute string 파이프라인의 모든 단계에 대한 기본 컴퓨팅으로 사용할 컴퓨팅 대상의 이름입니다. 계산이 단계 수준에서 정의된 경우 해당 특정 단계에 대한 이 기본 계산을 재정의합니다. 이 값은 azureml:<compute-name> 구문을 사용하여 작업 영역의 기존 컴퓨팅에 대한 참조여야 합니다.
continue_on_step_failure 부울 값 한 단계가 실패할 경우 파이프라인의 단계 실행을 계속해야 하는지 여부입니다. 기본값은 False이며, 한 단계가 실패하면 파이프라인 실행이 중지되고 실행 중인 단계가 모두 취소됩니다. False

작업 입력

키 형식 설명 허용된 값 기본값
type string 작업 입력의 형식입니다. 단일 파일 원본을 가리키는 입력 데이터의 경우 uri_file을 지정하거나 폴더 원본을 가리키는 입력 데이터의 경우 uri_folder를 지정합니다. uri_file, uri_folder uri_folder
path string 입력으로 사용할 데이터의 경로입니다. 다음과 같은 몇 가지 방법으로 지정할 수 있습니다.

- 데이터 원본 파일 또는 폴더에 대한 로컬 경로(예: path: ./iris.csv). 데이터는 작업 제출 중에 업로드됩니다.

- 입력으로 사용할 파일 또는 폴더에 대한 클라우드 경로의 URI입니다. 지원되는 URI 형식은 azureml, https, wasbs, abfss, adl입니다. azureml:// URI 양식을 사용하는 방법에 대한 자세한 내용은 핵심 yaml 구문을 참조하세요.

- 입력으로 사용할 기존 등록된 Azure Machine Learning 데이터 자산입니다. 등록된 데이터 자산을 참조하려면 azureml:<data_name>:<data_version> 구문 또는 azureml:<data_name>@latest(해당 데이터 자산의 최신 버전 참조)를 사용합니다(예: path: azureml:cifar10-data:1 또는 path: azureml:cifar10-data@latest).
mode string 컴퓨팅 대상에 데이터를 제공하는 방법의 모드입니다.

읽기 전용 탑재(ro_mount)의 경우 데이터는 탑재 경로로 사용됩니다. 폴더는 폴더로 탑재되고 파일은 파일로 탑재됩니다. Azure Machine Learning은 탑재 경로에 대한 입력을 확인합니다.

download 모드의 경우 데이터는 컴퓨팅 대상에 다운로드됩니다. Azure Machine Learning은 다운로드한 경로에 대한 입력을 확인합니다.

데이터 자체를 탑재하거나 다운로드하는 대신 데이터 아티팩트의 스토리지 위치 URL만 원하는 경우 direct 모드를 사용할 수 있습니다. 그러면 스토리지 위치의 URL이 작업 입력으로 전달됩니다. 이 경우 스토리지에 액세스하기 위한 자격 증명을 처리하는 것은 사용자의 책임입니다.		 ro_mount, , downloaddirect ro_mount

작업 출력

키 형식 설명 허용된 값 기본값
type string 작업 출력의 형식입니다. 기본 uri_folder 형식의 경우 출력은 폴더에 해당합니다. uri_folder uri_folder
path string 입력으로 사용할 데이터의 경로입니다. 다음과 같은 몇 가지 방법으로 지정할 수 있습니다.

- 데이터 원본 파일 또는 폴더에 대한 로컬 경로(예: path: ./iris.csv). 데이터는 작업 제출 중에 업로드됩니다.

- 입력으로 사용할 파일 또는 폴더에 대한 클라우드 경로의 URI입니다. 지원되는 URI 형식은 azureml, https, wasbs, abfss, adl입니다. azureml:// URI 양식을 사용하는 방법에 대한 자세한 내용은 핵심 yaml 구문을 참조하세요.

- 입력으로 사용할 기존 등록된 Azure Machine Learning 데이터 자산입니다. 등록된 데이터 자산을 참조하려면 azureml:<data_name>:<data_version> 구문 또는 azureml:<data_name>@latest(해당 데이터 자산의 최신 버전 참조)를 사용합니다(예: path: azureml:cifar10-data:1 또는 path: azureml:cifar10-data@latest).
mode string 출력 파일을 대상 스토리지에 제공하는 방법의 모드입니다. 읽기-쓰기 탑재 모드(rw_mount)의 경우 출력 디렉터리는 탑재된 디렉터리가 됩니다. 업로드 모드의 경우 작성된 파일은 작업 종료 시 업로드됩니다. rw_mount, upload rw_mount

설명

이 az ml schedule 명령은 Azure Machine Learning 모델을 관리하는 데 사용할 수 있습니다.

예제

예제는 예제 GitHub 리포지토리에서 사용할 수 있습니다. 몇가지는 다음과 같습니다.

YAML: 되풀이 방법이 있는 일정

적용 대상:Azure CLI ml 확장 v2(현재)

$schema: https://azuremlschemas.azureedge.net/latest/schedule.schema.json
name: simple_recurrence_job_schedule
display_name: Simple recurrence job schedule
description: a simple hourly recurrence job schedule

trigger:
  type: recurrence
  frequency: day #can be minute, hour, day, week, month
  interval: 1 #every day
  schedule:
    hours: [4,5,10,11,12]
    minutes: [0,30]
  start_time: "2022-07-10T10:00:00" # optional - default will be schedule creation time
  time_zone: "Pacific Standard Time" # optional - default will be UTC

create_job: ./simple-pipeline-job.yml
# create_job: azureml:simple-pipeline-job

YAML: cron 식을 사용한 일정

적용 대상:Azure CLI ml 확장 v2(현재)

$schema: https://azuremlschemas.azureedge.net/latest/schedule.schema.json
name: simple_cron_job_schedule
display_name: Simple cron job schedule
description: a simple hourly cron job schedule

trigger:
  type: cron
  expression: "0 * * * *"
  start_time: "2022-07-10T10:00:00" # optional - default will be schedule creation time
  time_zone: "Pacific Standard Time" # optional - default will be UTC

# create_job: azureml:simple-pipeline-job
create_job: ./simple-pipeline-job.yml

부록

표준 시간대

현재 일정은 다음 시간대를 지원합니다. 키는 Python SDK에서 직접 사용할 수 있지만 값은 YAML 작업에서 사용할 수 있습니다. 테이블은 UTC(협정 세계시)로 구성됩니다.

UTC 키 값
UTC -12:00 DATELINE_STANDARD_TIME "날짜 변경선 표준시"
UTC -11:00 UTC_11 "UTC-11"
UTC - 10:00 ALEUTIAN_STANDARD_TIME 알류샨 표준시
UTC - 10:00 HAWAIIAN_STANDARD_TIME "하와이 표준시"
UTC -09:30 MARQUESAS_STANDARD_TIME "마키저스 표준시"
UTC -09:00 ALASKAN_STANDARD_TIME "알래스카 표준시"
UTC -09:00 UTC_09 "UTC-09"
UTC -08:00 PACIFIC_STANDARD_TIME_MEXICO "태평양 표준시(멕시코)"
UTC -08:00 UTC_08 "UTC-08"
UTC -08:00 PACIFIC_STANDARD_TIME "태평양 표준시"
UTC -07:00 US_MOUNTAIN_STANDARD_TIME "미국 산지 표준시"
UTC -07:00 MOUNTAIN_STANDARD_TIME_MEXICO "산지 표준시(멕시코)"
UTC -07:00 MOUNTAIN_STANDARD_TIME "산지 표준시"
UTC -06:00 CENTRAL_AMERICA_STANDARD_TIME "중앙 아메리카 표준시"
UTC -06:00 CENTRAL_STANDARD_TIME "중부 표준시"
UTC -06:00 EASTER_ISLAND_STANDARD_TIME "이스터 섬 표준시"
UTC -06:00 CENTRAL_STANDARD_TIME_MEXICO "중부 표준시(멕시코)"
UTC -06:00 CANADA_CENTRAL_STANDARD_TIME "캐나다 중부 표준시"
UTC -05:00 SA_PACIFIC_STANDARD_TIME "SA 태평양 표준시"
UTC -05:00 EASTERN_STANDARD_TIME_MEXICO "동부 표준시(멕시코)"
UTC -05:00 EASTERN_STANDARD_TIME "동부 표준시"
UTC -05:00 HAITI_STANDARD_TIME "아이티 표준시"
UTC -05:00 CUBA_STANDARD_TIME "쿠바 표준시"
UTC -05:00 US_EASTERN_STANDARD_TIME "미국 동부 표준시"
UTC -05:00 TURKS_AND_CAICOS_STANDARD_TIME "터크스 케이커스 표준시"
UTC -04:00 PARAGUAY_STANDARD_TIME "파라과이 표준시"
UTC -04:00 ATLANTIC_STANDARD_TIME "대서양 표준시"
UTC -04:00 VENEZUELA_STANDARD_TIME "베네수엘라 표준시"
UTC -04:00 CENTRAL_BRAZILIAN_STANDARD_TIME "브라질 중부 표준시"
UTC -04:00 SA_WESTERN_STANDARD_TIME "SA 서부 표준시"
UTC -04:00 PACIFIC_SA_STANDARD_TIME "태평양 SA 표준시"
UTC -03:30 NEWFOUNDLAND_STANDARD_TIME "뉴펀들랜드 표준시"
UTC -03:00 TOCANTINS_STANDARD_TIME "토칸칭스 표준시"
UTC -03:00 E_SOUTH_AMERICAN_STANDARD_TIME "E. "남아메리카 표준시"
UTC -03:00 SA_EASTERN_STANDARD_TIME "SA 동부 표준시"
UTC -03:00 ARGENTINA_STANDARD_TIME "아르헨티나 표준시"
UTC -03:00 GREENLAND_STANDARD_TIME "그린란드 표준시"
UTC -03:00 MONTEVIDEO_STANDARD_TIME "몬테비디오 표준시"
UTC -03:00 SAINT_PIERRE_STANDARD_TIME "생피에르 표준시"
UTC -03:00 BAHIA_STANDARD_TIM "바이아 표준시"
UTC -02:00 UTC_02 "UTC-02"
UTC -02:00 MID_ATLANTIC_STANDARD_TIME "중부-대서양 표준시"
UTC -01:00 AZORES_STANDARD_TIME "아조레스 표준시"
UTC -01:00 CAPE_VERDE_STANDARD_TIME "카보베르데 표준시"
UTC UTC UTC
UTC +00:00 GMT_STANDARD_TIME "GMT 표준시"
UTC +00:00 GREENWICH_STANDARD_TIME "그리니치 표준시"
UTC +01:00 MOROCCO_STANDARD_TIME "모로코 표준시"
UTC +01:00 W_EUROPE_STANDARD_TIME "W. 유럽 표준시"
UTC +01:00 CENTRAL_EUROPE_STANDARD_TIME "중앙 유럽 표준시"
UTC +01:00 ROMANCE_STANDARD_TIME "로망스 표준시"
UTC +01:00 CENTRAL_EUROPEAN_STANDARD_TIME "중앙 유럽 표준시"
UTC +01:00 W_CENTRAL_AFRICA_STANDARD_TIME "W. 중앙 아프리카 표준시"
UTC +02:00 NAMIBIA_STANDARD_TIME "나미비아 표준시"
UTC +02:00 JORDAN_STANDARD_TIME "요르단 표준시"
UTC +02:00 GTB_STANDARD_TIME "GTB 표준시"
UTC +02:00 MIDDLE_EAST_STANDARD_TIME "중동 표준시"
UTC +02:00 EGYPT_STANDARD_TIME "이집트 표준시""
UTC +02:00 E_EUROPE_STANDARD_TIME "E. 유럽 표준시"
UTC +02:00 SYRIA_STANDARD_TIME "시리아 표준시"
UTC +02:00 WEST_BANK_STANDARD_TIME "팔레스타인 영토 표준시"
UTC +02:00 SOUTH_AFRICA_STANDARD_TIME "남아프리카 공화국 표준시"
UTC +02:00 FLE_STANDARD_TIME "FLE 표준시"
UTC +02:00 ISRAEL_STANDARD_TIME "이스라엘 표준시"
UTC +02:00 KALININGRAD_STANDARD_TIME "칼리닌그라드 표준시"
UTC +02:00 LIBYA_STANDARD_TIME "리비아 표준시"
UTC +03:00 TÜRKIYE_STANDARD_TIME "Türkiye Standard Time"
UTC +03:00 ARABIC_STANDARD_TIME "아랍 표준시"
UTC +03:00 ARAB_STANDARD_TIME "아랍 표준시"
UTC +03:00 BELARUS_STANDARD_TIME "벨라루스 표준시"
UTC +03:00 RUSSIAN_STANDARD_TIME "러시아 표준시"
UTC +03:00 E_AFRICA_STANDARD_TIME "E. "아프리카 표준시"
UTC +03:30 IRAN_STANDARD_TIME "이란 표준시"
UTC +04:00 ARABIAN_STANDARD_TIME "아랍 표준시"
UTC +04:00 ASTRAKHAN_STANDARD_TIME "아스트라한 표준시"
UTC +04:00 AZERBAIJAN_STANDARD_TIME "아제르바이잔 표준시"
UTC +04:00 RUSSIA_TIME_ZONE_3 "러시아 표준시 3"
UTC +04:00 MAURITIUS_STANDARD_TIME "모리셔스 표준시"
UTC +04:00 GEORGIAN_STANDARD_TIME "그루지야 표준시"
UTC +04:00 CAUCASUS_STANDARD_TIME "코카서스표준시"
UTC +04:30 AFGHANISTAN_STANDARD_TIME "아프가니스탄 표준시"
UTC +05:00 WEST_ASIA_STANDARD_TIME "서아시아 표준시"
UTC +05:00 EKATERINBURG_STANDARD_TIME "예카테린부르크 표준시"
UTC +05:00 PAKISTAN_STANDARD_TIME "파키스탄 표준시"
UTC +05:30 INDIA_STANDARD_TIME "인도 표준시"
UTC +05:30 SRI_LANKA_STANDARD_TIME "스리랑카 표준시"
UTC +05:45 NEPAL_STANDARD_TIME "네팔 표준시"
UTC +06:00 CENTRAL_ASIA_STANDARD_TIME "중앙 아시아 표준시"
UTC +06:00 BANGLADESH_STANDARD_TIME "방글라데시 표준시"
UTC +06:30 MYANMAR_STANDARD_TIME "미얀마 표준시"
UTC +07:00 N_CENTRAL_ASIA_STANDARD_TIME "중앙 아시아 표준시"
UTC +07:00 SE_ASIA_STANDARD_TIME "동남 아시아 표준시"
UTC +07:00 ALTAI_STANDARD_TIME "알타이 표준시"
UTC +07:00 W_MONGOLIA_STANDARD_TIME "W. 몽골 표준시"
UTC +07:00 NORTH_ASIA_STANDARD_TIME "북아시아 표준시"
UTC +07:00 TOMSK_STANDARD_TIME "톰스크 표준시"
UTC +08:00 CHINA_STANDARD_TIME "중국 표준시"
UTC +08:00 NORTH_ASIA_EAST_STANDARD_TIME "북아시아 동부 표준시"
UTC +08:00 SINGAPORE_STANDARD_TIME "싱가포르 표준시"
UTC +08:00 W_AUSTRALIA_STANDARD_TIME "W. 오스트레일리아 표준시"
UTC +08:00 TAIPEI_STANDARD_TIME "타이베이 표준시"
UTC +08:00 ULAANBAATAR_STANDARD_TIME "울란바토르 표준시"
UTC +08:45 AUS_CENTRAL_W_STANDARD_TIME "오스트레일리아 중부 표준시"
UTC +09:00 NORTH_KOREA_STANDARD_TIME "북한 표준시"
UTC +09:00 TRANSBAIKAL_STANDARD_TIME "트란스바이칼 표준시"
UTC +09:00 TOKYO_STANDARD_TIME "도쿄 표준시"
UTC +09:00 KOREA_STANDARD_TIME "대한민국 표준시"
UTC +09:00 YAKUTSK_STANDARD_TIME "야쿠츠크 표준시"
UTC +09:30 CEN_AUSTRALIA_STANDARD_TIME "중부 오스트레일리아 표준시"
UTC +09:30 AUS_CENTRAL_STANDARD_TIME "오스트레일리아 중부 표준시"
UTC +10:00 E_AUSTRALIAN_STANDARD_TIME "E. 오스트레일리아 표준시"
UTC +10:00 AUS_EASTERN_STANDARD_TIME "오스트레일리아 동부 표준시"
UTC +10:00 WEST_PACIFIC_STANDARD_TIME "서태평양 표준시"
UTC +10:00 TASMANIA_STANDARD_TIME "태즈메이니아 표준시"
UTC +10:00 VLADIVOSTOK_STANDARD_TIME "블라디보스토크 표준시"
UTC +10:30 LORD_HOWE_STANDARD_TIME "로드하우 표준시"
UTC +11:00 BOUGAINVILLE_STANDARD_TIME "부건빌 표준시"
UTC +11:00 RUSSIA_TIME_ZONE_10 "러시아 표준시 10"
UTC +11:00 MAGADAN_STANDARD_TIME "마가단 표준시"
UTC +11:00 NORFOLK_STANDARD_TIME "노퍽 표준시"
UTC +11:00 SAKHALIN_STANDARD_TIME "사할린 표준시"
UTC +11:00 CENTRAL_PACIFIC_STANDARD_TIME "중앙 태평양 표준시"
UTC +12:00 RUSSIA_TIME_ZONE_11 "러시아 표준시 11"
UTC +12:00 NEW_ZEALAND_STANDARD_TIME "뉴질랜드 표준시"
UTC +12:00 UTC_12 "UTC+12"
UTC +12:00 FIJI_STANDARD_TIME "피지 표준시"
UTC +12:00 KAMCHATKA_STANDARD_TIME "캄차카 반도 표준시"
UTC +12:45 CHATHAM_ISLANDS_STANDARD_TIME "채텀 섬 표준시"
UTC +13:00 TONGA__STANDARD_TIME "통가 표준시"
UTC +13:00 SAMOA_STANDARD_TIME "사모아 표준시"
UTC +14:00 LINE_ISLANDS_STANDARD_TIME "라인 제도 표준시"