BatchJobManagerTask interface
작업 관리자 작업의 세부 정보를 지정합니다. 작업 관리자 작업은 작업을 만들 때 자동으로 시작됩니다. Batch 서비스는 작업의 다른 작업 앞에 작업 관리자 태스크를 예약하려고 합니다. 풀을 축소할 때 Batch 서비스는 작업 관리자 태스크가 가능한 한 오랫동안 실행되는 노드를 유지하려고 합니다(즉, '정상' 작업을 실행하는 컴퓨팅 노드는 작업 관리자 작업을 실행하는 컴퓨팅 노드 전에 제거됨). 작업 관리자 태스크가 실패하고 다시 시작해야 하는 경우 시스템은 가장 높은 우선 순위로 예약을 시도합니다. 사용 가능한 유휴 컴퓨팅 노드가 없는 경우 시스템은 작업 관리자 작업을 다시 시작할 공간을 확보하기 위해 풀에서 실행 중인 작업 중 하나를 종료하고 큐로 반환할 수 있습니다. 한 작업의 작업 관리자 태스크는 다른 작업의 작업보다 우선 순위가 없습니다. 작업 전체에서 작업 수준 우선 순위만 관찰됩니다. 예를 들어 우선 순위 0 작업의 작업 관리자를 다시 시작해야 하는 경우 우선 순위 1 작업의 태스크를 대체하지 않습니다. Batch는 노드에서 복구 작업이 트리거될 때 작업을 다시 시도합니다. 복구 작업의 예로는 비정상 노드가 다시 부팅되거나 호스트 오류로 인해 컴퓨팅 노드가 사라진 경우(제한되지 않음) 등이 있습니다. 복구 작업으로 인한 재시도는 maxTaskRetryCount와 독립적이며 계산되지 않습니다. maxTaskRetryCount가 0이더라도 복구 작업으로 인한 내부 재시도가 발생할 수 있습니다. 이 때문에 모든 작업은 idempotent여야 합니다. 즉, 작업이 손상되거나 중복된 데이터를 유발하지 않고 중단되고 다시 시작되는 것을 허용해야 합니다. 장기 실행 작업의 모범 사례는 일종의 검사점을 사용하는 것입니다.
속성
| allow |
작업 관리자 작업이 스팟/저우선순위 컴퓨트 노드에서 실행될 수 있는지 여부. 기본값은 true입니다. |
| application |
배치 서비스가 명령줄 실행 전에 컴퓨트 노드에 배포할 애플리케이션 패키지 목록입니다. 애플리케이션 패키지는 작업 디렉터리가 아닌 공유 디렉터리에 다운로드 및 배포됩니다. 따라서 참조된 애플리케이션 패키지가 이미 컴퓨트 노드에 있고 최신 상태라면 재다운로드되지 않습니다; 컴퓨트 노드에 존재하는 기존 복사본을 사용합니다. 참조된 애플리케이션 패키지가 삭제되었거나 다운로드 실패로 인해 설치할 수 없다면, 작업은 실패합니다. |
| command |
작업 관리자 작업의 명령줄입니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이런 기능을 활용하고 싶다면, 명령줄에서 셸을 호출해야 합니다. 예를 들어 Windows에서는 "cmd /c MyCommand"를, Linux에서는 "/bin/sh -c MyCommand"를 사용하는 식입니다. 명령줄이 파일 경로를 참조하는 경우 상대 경로(작업 작업 디렉터리를 기준으로)를 사용하거나 Batch 제공 환경 변수(https://dotnet.territoriali.olinfo.it/azure/batch/batch-compute-node-environment-variables)를 사용해야 합니다. |
| constraints | 작업 관리자 작업에 적용되는 제약 조건들. |
| container |
작업 관리자 작업이 실행되는 컨테이너 설정입니다. 이 작업을 실행할 풀에 containerConfiguration 설정이 있다면, 이 또한 설정되어야 합니다. 이 작업을 실행할 풀에 containerConfiguration 설정이 없다면, 이 설정은 하지 않아야 합니다. 이 명령이 명시되면, 노드 내 Azure Batch 디렉터리의 루트인 AZ_BATCH_NODE_ROOT_DIR 아래에 있는 모든 디렉터리가 재귀적으로 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되며, 작업 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부에서 생성된 컨테이너 파일은 호스트 디스크에 반영되지 않을 수 있어, 배치 파일 API가 해당 파일에 접근할 수 없습니다. |
| display |
작업 관리자 작업의 표시명입니다. 고유할 필요는 없으며 최대 1024 길이의 유니코드 문자를 포함할 수 있습니다. |
| environment |
작업 관리자 작업의 환경 변수 설정 목록입니다. |
| id | 작업 내 작업 관리자 작업을 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함한 모든 영숫자 문자 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. |
| kill |
작업 관리자 작업 완료가 전체 작업 완료를 의미하는지. 만약 그렇다면, 작업 관리자 작업이 완료되면 배치 서비스는 작업을 완료로 표시합니다. 이 시점에 작업 해제 외에 실행 중인 작업이 있다면, 해당 작업들은 종료됩니다. 만약 잘못이라면, 작업 관리자 작업 완료는 작업 상태에 영향을 미치지 않습니다. 이 경우에는 onAllTasksComplete 속성을 사용해 작업을 종료하거나, 클라이언트나 사용자가 명시적으로 작업을 종료하도록 해야 합니다. 예를 들어, 작업 관리자가 작업 집합을 생성하지만 그 작업 실행에 더 이상 참여하지 않는 경우가 있습니다. 기본값은 true입니다. onAllTasksComplete와 onTaskFailure 속성을 사용해 작업 수명을 제어하고, 작업 관리자 작업은 작업 생성에만 사용한다면(진행 상황 모니터링용이 아님), killJobOnCompletion을 false로 설정하는 것이 중요합니다. |
| output |
명령줄을 실행한 후 배치 서비스가 컴퓨트 노드에서 업로드하는 파일 목록입니다. 다중 인스턴스 작업의 경우, 파일은 주 작업이 실행되는 컴퓨트 노드에서만 업로드됩니다. |
| required |
작업이 실행에 필요한 스케줄링 슬롯 수. 기본값은 1입니다. 작업은 컴퓨팅 노드에 충분한 빈 스케줄링 슬롯이 있을 때만 실행되도록 스케줄링할 수 있습니다. 다중 인스턴스 작업의 경우 이 속성은 지원되지 않으며 명시되어서는 안 됩니다. |
| resource |
명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다. |
| run |
작업 관리자 작업이 실행되는 컴퓨트 노드를 독점적으로 사용해야 하는지 여부. 만약 그렇다면, 작업 관리자가 실행 중인 동안 다른 작업들은 같은 노드에서 실행되지 않습니다. 만약 false일 경우, 다른 작업들이 컴퓨트 노드의 작업 관리자와 동시에 실행될 수 있습니다. 작업 관리자 작업은 보통 컴퓨트 노드의 동시 작업 제한에 반영되므로, 컴퓨트 노드가 여러 개의 동시 작업을 허용할 때만 이 점이 중요합니다. 기본값은 true입니다. |
| user |
작업 관리자 작업이 실행되는 사용자 신원입니다. 만약 이 옵션을 누락할 경우, 해당 작업은 해당 작업에 고유한 비관리자 사용자로 실행됩니다. |
속성 세부 정보
allowLowPriorityNode
작업 관리자 작업이 스팟/저우선순위 컴퓨트 노드에서 실행될 수 있는지 여부. 기본값은 true입니다.
allowLowPriorityNode?: boolean속성 값
boolean
applicationPackageReferences
배치 서비스가 명령줄 실행 전에 컴퓨트 노드에 배포할 애플리케이션 패키지 목록입니다. 애플리케이션 패키지는 작업 디렉터리가 아닌 공유 디렉터리에 다운로드 및 배포됩니다. 따라서 참조된 애플리케이션 패키지가 이미 컴퓨트 노드에 있고 최신 상태라면 재다운로드되지 않습니다; 컴퓨트 노드에 존재하는 기존 복사본을 사용합니다. 참조된 애플리케이션 패키지가 삭제되었거나 다운로드 실패로 인해 설치할 수 없다면, 작업은 실패합니다.
applicationPackageReferences?: BatchApplicationPackageReference[]속성 값
commandLine
작업 관리자 작업의 명령줄입니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이런 기능을 활용하고 싶다면, 명령줄에서 셸을 호출해야 합니다. 예를 들어 Windows에서는 "cmd /c MyCommand"를, Linux에서는 "/bin/sh -c MyCommand"를 사용하는 식입니다. 명령줄이 파일 경로를 참조하는 경우 상대 경로(작업 작업 디렉터리를 기준으로)를 사용하거나 Batch 제공 환경 변수(https://dotnet.territoriali.olinfo.it/azure/batch/batch-compute-node-environment-variables)를 사용해야 합니다.
commandLine: string속성 값
string
constraints
containerSettings
작업 관리자 작업이 실행되는 컨테이너 설정입니다. 이 작업을 실행할 풀에 containerConfiguration 설정이 있다면, 이 또한 설정되어야 합니다. 이 작업을 실행할 풀에 containerConfiguration 설정이 없다면, 이 설정은 하지 않아야 합니다. 이 명령이 명시되면, 노드 내 Azure Batch 디렉터리의 루트인 AZ_BATCH_NODE_ROOT_DIR 아래에 있는 모든 디렉터리가 재귀적으로 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되며, 작업 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부에서 생성된 컨테이너 파일은 호스트 디스크에 반영되지 않을 수 있어, 배치 파일 API가 해당 파일에 접근할 수 없습니다.
containerSettings?: BatchTaskContainerSettings속성 값
displayName
작업 관리자 작업의 표시명입니다. 고유할 필요는 없으며 최대 1024 길이의 유니코드 문자를 포함할 수 있습니다.
displayName?: string속성 값
string
environmentSettings
id
작업 내 작업 관리자 작업을 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함한 모든 영숫자 문자 조합을 포함할 수 있으며 64자를 초과할 수 없습니다.
id: string속성 값
string
killJobOnCompletion
작업 관리자 작업 완료가 전체 작업 완료를 의미하는지. 만약 그렇다면, 작업 관리자 작업이 완료되면 배치 서비스는 작업을 완료로 표시합니다. 이 시점에 작업 해제 외에 실행 중인 작업이 있다면, 해당 작업들은 종료됩니다. 만약 잘못이라면, 작업 관리자 작업 완료는 작업 상태에 영향을 미치지 않습니다. 이 경우에는 onAllTasksComplete 속성을 사용해 작업을 종료하거나, 클라이언트나 사용자가 명시적으로 작업을 종료하도록 해야 합니다. 예를 들어, 작업 관리자가 작업 집합을 생성하지만 그 작업 실행에 더 이상 참여하지 않는 경우가 있습니다. 기본값은 true입니다. onAllTasksComplete와 onTaskFailure 속성을 사용해 작업 수명을 제어하고, 작업 관리자 작업은 작업 생성에만 사용한다면(진행 상황 모니터링용이 아님), killJobOnCompletion을 false로 설정하는 것이 중요합니다.
killJobOnCompletion?: boolean속성 값
boolean
outputFiles
명령줄을 실행한 후 배치 서비스가 컴퓨트 노드에서 업로드하는 파일 목록입니다. 다중 인스턴스 작업의 경우, 파일은 주 작업이 실행되는 컴퓨트 노드에서만 업로드됩니다.
outputFiles?: OutputFile[]속성 값
requiredSlots
작업이 실행에 필요한 스케줄링 슬롯 수. 기본값은 1입니다. 작업은 컴퓨팅 노드에 충분한 빈 스케줄링 슬롯이 있을 때만 실행되도록 스케줄링할 수 있습니다. 다중 인스턴스 작업의 경우 이 속성은 지원되지 않으며 명시되어서는 안 됩니다.
requiredSlots?: number속성 값
number
resourceFiles
명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.
resourceFiles?: ResourceFile[]속성 값
runExclusive
작업 관리자 작업이 실행되는 컴퓨트 노드를 독점적으로 사용해야 하는지 여부. 만약 그렇다면, 작업 관리자가 실행 중인 동안 다른 작업들은 같은 노드에서 실행되지 않습니다. 만약 false일 경우, 다른 작업들이 컴퓨트 노드의 작업 관리자와 동시에 실행될 수 있습니다. 작업 관리자 작업은 보통 컴퓨트 노드의 동시 작업 제한에 반영되므로, 컴퓨트 노드가 여러 개의 동시 작업을 허용할 때만 이 점이 중요합니다. 기본값은 true입니다.
runExclusive?: boolean속성 값
boolean
userIdentity
작업 관리자 작업이 실행되는 사용자 신원입니다. 만약 이 옵션을 누락할 경우, 해당 작업은 해당 작업에 고유한 비관리자 사용자로 실행됩니다.
userIdentity?: UserIdentity