Azure Batch 런타임 환경 변수
Azure Batch 서비스는 컴퓨팅 노드에 다음과 같은 환경 변수를 설정합니다. 태스크 명령줄과 명령줄로 실행되는 프로그램 및 스크립트에서 이러한 환경 변수를 참조할 수 있습니다.
Batch에 환경 변수를 사용하는 방법에 대한 자세한 내용은 Environment settings for tasks(작업을 위한 환경 설정)를 참조하세요.
환경 변수 이름 표시
이러한 환경 변수는 작업 사용자, 즉 작업이 실행되는 노드의 사용자 계정의 컨텍스트에서만 표시됩니다. RDP(원격 데스크톱 프로토콜) 또는 SSH(Secure Shell)를 통해 컴퓨팅 노드에 원격으로 연결하고 환경 변수를 나열하는 경우 이러한 변수를 확인할 수 없습니다. 원격 연결에 사용되는 사용자 계정이 태스크에서 사용하는 계정과 동일하지 않기 때문입니다.
환경 변수의 현재 값을 가져오려면 Windows 컴퓨팅 노드에서는 cmd.exe를, Linux 노드에서는 /bin/sh를 시작합니다.
cmd /c set <ENV_VARIABLE_NAME>
/bin/sh -c "printenv <ENV_VARIABLE_NAME>"
환경 변수의 명령줄 확장
컴퓨팅 노드에서 작업으로 실행되는 명령줄은 셸에서 실행되지 않습니다. 즉, 이러한 명령줄은 환경 변수 확장과 같은 셸 기능을 기본적으로 사용할 수 없습니다(PATH 포함). 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다. 예를 들어 Windows 컴퓨팅 노드에서 cmd.exe를 실행하거나 Linux 노드에서 /bin/sh를 실행합니다.
cmd /c MyTaskApplication.exe %MY_ENV_VAR%
/bin/sh -c "MyTaskApplication $MY_ENV_VAR"
환경 변수
참고 항목
AZ_BATCH_AUTHENTICATION_TOKEN은 더 이상 사용되지 않으며 2024년 9월 30일에 사용 중지됩니다. 자세한 내용 및 대체 구현은 공지를 참조하세요.
| 변수 이름 | 설명 | 가용성 | 예시 |
|---|---|---|---|
| AZ_BATCH_ACCOUNT_NAME | 태스크가 속한 Batch 계정의 이름입니다. | 모든 태스크입니다. | mybatchaccount |
| AZ_BATCH_ACCOUNT_URL | 배치 계정의 URL입니다. | 모든 태스크입니다. | https://myaccount.westus.batch.azure.com |
| AZ_BATCH_APP_PACKAGE | 모든 앱 패키지 환경 변수의 접두사입니다. 예를 들어 애플리케이션 “FOO” 버전 “1”이 풀에 설치된 경우 환경 변수는 AZ_BATCH_APP_PACKAGE_FOO_1(Linux) 또는 AZ_BATCH_APP_PACKAGE_FOO#1(Windows)입니다. AZ_BATCH_APP_PACKAGE_FOO_1은 패키지가 다운로드된 위치(폴더)를 가리킵니다. 앱 패키지의 기본 버전을 사용하는 경우에는 버전 번호 없이 AZ_BATCH_APP_PACKAGE 환경 변수를 사용하세요. Linux에서 애플리케이션 패키지 이름이 "Agent-linux-x64"이고 버전이 "1.1.46.0"인 경우 환경 이름은 실제로 밑줄과 소문자를 사용하여 AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0입니다. 자세한 내용은 설치된 애플리케이션 실행을 참조하세요. | 관련 앱 패키지가 있는 모든 작업입니다. 또한 노드 자체에 애플리케이션 패키지가 있는 경우 모든 작업에 사용할 수 있습니다. | AZ_BATCH_APP_PACKAGE_FOO_1(Linux) 또는 AZ_BATCH_APP_PACKAGE_FOO#1(Windows) |
| AZ_BATCH_AUTHENTICATION_TOKEN | Batch 서비스 작업의 제한된 집합에 대한 액세스를 부여하는 인증 토큰입니다. 이 환경 변수는 작업이 추가될 때 authenticationTokenSettings가 설정된 경우에만 존재합니다. 토큰 값은 BatchClient.Open() .NET API와 같은 Batch API에서 Batch 클라이언트를 만들 때 자격 증명으로 사용됩니다. 토큰은 프라이빗 네트워킹을 지원하지 않습니다. | 모든 태스크입니다. | OAuth2 액세스 토큰 |
| AZ_BATCH_CERTIFICATES_DIR | Linux 컴퓨팅 노드에 대한 인증서가 저장된 태스크 작업 디렉터리 내 디렉터리입니다. 이 환경 변수는 Windows 컴퓨팅 노드에 적용되지 않습니다. | 모든 태스크입니다. | /mnt/batch/tasks/workitems/batchjob001/job-1/task001/certs |
| AZ_BATCH_HOST_LIST | 다중 인스턴스 작업에 할당된 노드의 목록으로, nodeIP,nodeIP 형식입니다. |
다중 인스턴스 기본 및 하위 태스크입니다. | 10.0.0.4,10.0.0.5 |
| AZ_BATCH_IS_CURRENT_NODE_MASTER | 현재 노드가 다중 인스턴스 작업의 마스터 노드인지 여부를 지정합니다. 가능한 값은 true 및 false입니다. |
다중 인스턴스 기본 및 하위 태스크입니다. | true |
| AZ_BATCH_JOB_ID | 태스크가 속한 작업의 ID | 시작 태스크를 제외한 모든 태스크입니다. | batchjob001 |
| AZ_BATCH_JOB_PREP_DIR | 노드의 작업 준비 태스크 디렉터리 전체 경로입니다. | 시작 태스크 및 작업 준비 태스크를 제외한 모든 태스크입니다. 작업에 작업 준비 태스크가 구성된 경우에만 사용할 수 있습니다. | C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation |
| AZ_BATCH_JOB_PREP_WORKING_DIR | 노드의 작업 준비 태스크 작업 디렉터리 전체 경로입니다. | 시작 태스크 및 작업 준비 태스크를 제외한 모든 태스크입니다. 작업에 작업 준비 태스크가 구성된 경우에만 사용할 수 있습니다. | C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation\wd |
| AZ_BATCH_MASTER_NODE | 다중 인스턴스 작업의 기본 작업이 실행되는 컴퓨팅 노드의 IP 주소와 포트입니다. 여기에 지정된 포트는 Azure Batch 서비스를 위해 예약되어 있으므로 MPI 또는 NCCL 통신에 사용하면 안 됩니다. 그 대신 변수 MASTER_PORT를 사용하세요. 명령줄 인수를 통해 전달된 값(포트 6105가 좋은 기본값이 됩니다)으로 설정하거나 AML이 값을 설정하는 경우 이 값을 사용하면 됩니다. | 다중 인스턴스 기본 및 하위 태스크입니다. | 10.0.0.4:6000 |
| AZ_BATCH_NODE_ID | 태스크가 할당된 노드의 ID입니다. | 모든 태스크입니다. | tvm-1219235766_3-20160919t172711z |
| AZ_BATCH_NODE_IS_DEDICATED | true의 경우 현재 노드는 전용된 노드입니다. false인 경우 Azure 스폿 노드입니다. |
모든 태스크입니다. | true |
| AZ_BATCH_NODE_LIST | 다중 인스턴스 작업에 할당된 노드의 목록으로, nodeIP;nodeIP 형식입니다. |
다중 인스턴스 기본 및 하위 태스크입니다. | 10.0.0.4;10.0.0.5 |
| AZ_BATCH_NODE_MOUNTS_DIR | 모든 탑재 디렉터리가 있는 노드 수준 파일 시스템 탑재 위치의 전체 경로입니다. Windows 파일 공유는 드라이브 문자를 사용하므로 Windows의 경우 탑재 드라이브가 디바이스 및 드라이브의 일부입니다. | 시작 작업을 포함하는 모든 작업은 사용자가 탑재된 디렉터리의 탑재 권한에 대해 알고 있는 경우 사용자에게 액세스할 수 있습니다. | Ubuntu에서는 위치의 예는 /mnt/batch/tasks/fsmounts입니다. |
| AZ_BATCH_NODE_ROOT_DIR | 노드의 모든 Batch 디렉터리 루트의 전체 경로입니다. | 모든 태스크입니다. | C:\user\tasks |
| AZ_BATCH_NODE_SHARED_DIR | 노드의 공유 디렉터리 전체 경로입니다. 노드에서 실행되는 모든 태스크는 이 디렉터리에 대한 읽기/쓰기 권한이 있습니다. 다른 노드에서 실행되는 태스크는 이 디렉터리에 대한 원격 액세스 권한이 없습니다("공유" 네트워크 디렉터리가 아님). | 모든 태스크입니다. | C:\user\tasks\shared |
| AZ_BATCH_NODE_STARTUP_DIR | 노드의 시작 작업 디렉터리 전체 경로입니다. | 모든 태스크입니다. | C:\user\tasks\startup |
| AZ_BATCH_POOL_ID | 태스크가 실행되는 풀의 ID | 모든 태스크입니다. | batchpool001 |
| AZ_BATCH_TASK_DIR | 노드의 작업 디렉터리 전체 경로입니다. 이 디렉터리에는 태스크에 대한 stdout.txt 및 stderr.txt, 그리고 AZ_BATCH_TASK_WORKING_DIR이 포함됩니다. |
모든 태스크입니다. | C:\user\tasks\workitems\batchjob001\job-1\task001 |
| AZ_BATCH_TASK_ID | 현재 태스크의 ID | 시작 태스크를 제외한 모든 태스크입니다. | task001 |
| AZ_BATCH_TASK_SHARED_DIR | 다중 인스턴스 작업의 기본 작업 및 모든 하위 작업에서 동일한 디렉터리 경로입니다. 경로는 다중 인스턴스 작업이 실행되는 모든 노드에 존재하며 해당 노드에서 실행 중인 작업 명령에 대한 읽기/쓰기 액세스 권한이 있습니다(조정 명령과 애플리케이션 명령 둘 다). 다른 노드에서 실행되는 하위 작업 또는 기본 작업은 이 디렉터리에 대한 원격 액세스 권한이 없습니다(“공유” 네트워크 디렉터리가 아님). | 다중 인스턴스 기본 및 하위 태스크입니다. | C:\user\tasks\workitems\multiinstancesamplejob\job-1\multiinstancesampletask |
| AZ_BATCH_TASK_WORKING_DIR | 노드의 태스크 작업 디렉터리 전체 경로입니다. 현재 실행 중인 태스크는 이 디렉터리에 대한 읽기/쓰기 액세스 권한이 있습니다. | 모든 태스크입니다. | C:\user\tasks\workitems\batchjob001\job-1\task001\wd |
| AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES | VM이 DiskFull(으)로 표시되는 디스크 공간에 대한 현재 임계값입니다. |
모든 태스크입니다. | 1000000 |
| CCP_NODES | 다중 인스턴스 태스크에 할당된 노드와 노드당 코어 수의 목록입니다. 노드 및 코어는 numNodes<space>node1IP<space>node1Cores<space>node2IP<space>node2Cores<space> ... 형식으로 나열됩니다. 여기서 노드 수 뒤에 하나 이상의 노드 IP 주소와 각 노드의 코어 수가 옵니다. |
다중 인스턴스 기본 및 하위 태스크입니다. | 2 10.0.0.4 1 10.0.0.5 1 |
다음 단계
- Batch를 사용하여 환경 변수를 사용하는 방법에 대해 알아봅니다.
- Batch의 파일 및 디렉터리에 대한 자세한 정보
- 다중 인스턴스 작업에 대해 알아봅니다.