StartTask interface
경우에 따라 노드가 다시 부팅되지 않은 경우에도 시작 작업이 다시 실행될 수 있습니다. 이로 인해 시작 작업은 idempotent여야 하며 수행 중인 설정이 이미 완료된 경우 정상적으로 종료되어야 합니다. 중단 프로세스를 만들거나 시작 작업 작업 디렉터리에서 서비스를 설치/시작하는 시작 작업을 방지하기 위해 특별히 주의해야 합니다. 그러면 Batch가 시작 작업을 다시 실행할 수 없도록 차단됩니다.
속성
| command |
명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows에서 "cmd /c MyCommand"를 사용하거나 Linux에서 "/bin/sh -c MyCommand"). startTask의 다른 속성이 지정된 경우 필수입니다. |
| container |
이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 작업 명령줄이 컨테이너에서 실행됩니다. |
| environment |
시작 작업에 대한 환경 변수 설정 목록입니다. |
| max |
종료 코드가 0이 아니면 Batch 서비스가 태스크를 다시 시도합니다. 이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 태스크를 한 번 시도한 후 이 한도까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 작업을 최대 4번(한 번의 초기 시도 및 3번의 다시 시도)으로 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스에서 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1이면 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 기본값은 0입니다. |
| resource |
명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. |
| user |
생략하면 태스크가 작업에 고유한 비관리 사용자로 실행됩니다. |
| wait |
true이고 컴퓨팅 노드에서 시작 작업이 실패하면 Batch 서비스는 최대 재시도 횟수(maxTaskRetryCount)까지 시작 작업을 다시 시도합니다. 모든 재시도 후에도 작업이 성공적으로 완료되지 않은 경우 Batch 서비스는 컴퓨팅 노드를 사용할 수 없음으로 표시하고 작업을 예약하지 않습니다. 이 조건은 노드 상태 및 예약 오류 세부 정보를 통해 검색할 수 있습니다. false이면 Batch 서비스는 시작 작업이 완료될 때까지 기다리지 않습니다. 이 경우 시작 태스크가 계속 실행되는 동안 다른 태스크가 컴퓨팅 노드에서 실행을 시작할 수 있습니다. 시작 작업이 실패하더라도 노드에서 새 작업이 계속 예약됩니다. 기본값은 true입니다. |
속성 세부 정보
commandLine
명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows에서 "cmd /c MyCommand"를 사용하거나 Linux에서 "/bin/sh -c MyCommand"). startTask의 다른 속성이 지정된 경우 필수입니다.
commandLine?: string속성 값
string
containerSettings
이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 작업 명령줄이 컨테이너에서 실행됩니다.
containerSettings?: TaskContainerSettings속성 값
environmentSettings
maxTaskRetryCount
종료 코드가 0이 아니면 Batch 서비스가 태스크를 다시 시도합니다. 이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 태스크를 한 번 시도한 후 이 한도까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 작업을 최대 4번(한 번의 초기 시도 및 3번의 다시 시도)으로 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스에서 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1이면 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 기본값은 0입니다.
maxTaskRetryCount?: number속성 값
number
resourceFiles
userIdentity
waitForSuccess
true이고 컴퓨팅 노드에서 시작 작업이 실패하면 Batch 서비스는 최대 재시도 횟수(maxTaskRetryCount)까지 시작 작업을 다시 시도합니다. 모든 재시도 후에도 작업이 성공적으로 완료되지 않은 경우 Batch 서비스는 컴퓨팅 노드를 사용할 수 없음으로 표시하고 작업을 예약하지 않습니다. 이 조건은 노드 상태 및 예약 오류 세부 정보를 통해 검색할 수 있습니다. false이면 Batch 서비스는 시작 작업이 완료될 때까지 기다리지 않습니다. 이 경우 시작 태스크가 계속 실행되는 동안 다른 태스크가 컴퓨팅 노드에서 실행을 시작할 수 있습니다. 시작 작업이 실패하더라도 노드에서 새 작업이 계속 예약됩니다. 기본값은 true입니다.
waitForSuccess?: boolean속성 값
boolean