Variabel lingkungan runtime bahasa umum Azure Batch
Layanan Azure Batch mengeset variabel lingkungan berikut pada simpul komputasi. Anda dapat mereferensikan variabel lingkungan ini di baris perintah tugas, dan dalam program serta skrip yang dijalankan oleh baris perintah.
Untuk informasi selengkapnya tentang menggunakan variabel lingkungan dengan Batch, lihat Pengaturan lingkungan untuk tugas.
Visibilitas variabel lingkungan
Variabel lingkungan ini hanya terlihat dalam konteks pengguna tugas, yang merupakan akun pengguna pada simpul tempat tugas dijalankan. Anda tidak akan melihat variabel ini saat menggunakansambungan jarak jauh ke simpul komputasi melalui Remote Desktop Protocol (RDP) atau Secure Shell (SSH) dan daftar variabel lingkungan. Hal Ini karena akun pengguna yang digunakan untuk sambungan jarak jauh tidak sama dengan akun yang digunakan oleh tugas.
Untuk mendapatkan nilai variabel lingkungan terkini, luncurkan cmd.exe
pada simpul komputasi Windows atau /bin/sh
pada simpul Linux:
cmd /c set <ENV_VARIABLE_NAME>
/bin/sh -c "printenv <ENV_VARIABLE_NAME>"
Perluasan baris perintah variabel lingkungan
Baris perintah yang dijalankan oleh tugas pada simpul komputasi tidak berjalan pada shell. Ini berarti baris perintah ini secara alami tidak dapat menggunakan fitur shell seperti perluasan variabel lingkungan (termasuk PATH
). Untuk memanfaatkan fitur tersebut, Anda harus memanggil shell di baris perintah. Misalnya, luncurkan cmd.exe
pada simpul komputasi Windows atau /bin/sh
pada simpul Linux:
cmd /c MyTaskApplication.exe %MY_ENV_VAR%
/bin/sh -c "MyTaskApplication $MY_ENV_VAR"
Variabel lingkungan
Catatan
AZ_BATCH_AUTHENTICATION_TOKEN
tidak digunakan lagi dan akan dihentikan pada 30 September 2024. Lihat pengumuman untuk detail dan implementasi alternatif.
Nama variabel | Deskripsi | Ketersediaan | Contoh |
---|---|---|---|
AZ_BATCH_ACCOUNT_NAME | Nama akun Batch tempat tugas tersebut berada. | Semua tugas. | mybatchaccount |
AZ_BATCH_ACCOUNT_URL | URL akun Batch. | Semua tugas. | https://myaccount.westus.batch.azure.com |
AZ_BATCH_APP_PACKAGE | Prefiks dari semua paket aplikasi variabel lingkungan. Misalnya, jika Aplikasi "FOO" versi "1" dipasang pada suatu kumpulan, variabel lingkungan adalah AZ_BATCH_APP_PACKAGE_FOO_1 (di Linux) atau AZ_BATCH_APP_PACKAGE_FOO#1 (di Windows). AZ_BATCH_APP_PACKAGE_FOO_1 menunjuk ke lokasi tempat paket terunduh (sebuah folder). Saat menggunakan versi default paket aplikasi, gunakan variabel lingkungan AZ_BATCH_APP_PACKAGE tanpa nomor versi. Jika di Linux, dan nama paket aplikasi adalah "Agent-linux-x64" serta versinya adalah "1.1.46.0, nama lingkungan sebenarnya adalah: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0, menggunakan garis bawah dan huruf kecil. Untuk informasi selengkapnya, lihat Menjalankan aplikasi terpasang untuk detail lebih lanjut. | Setiap tugas dengan paket aplikasi terkait. Juga tersedia untuk semua tugas jika simpul itu sendiri memiliki paket aplikasi. | AZ_BATCH_APP_PACKAGE_FOO_1 (Linux) atau AZ_BATCH_APP_PACKAGE_FOO#1 (Windows) |
AZ_BATCH_AUTHENTICATION_TOKEN | Token autentikasi yang memberikan akses ke set operasi layanan Batch terbatas. Variabel lingkungan ini hanya muncul jika otentikasiTokenSettings diset saat tugas ditambahkan. Nilai token digunakan dalam API Batch sebagai informasi masuk untuk membuat klien Batch, seperti pada BatchClient.Open() .NET API. Token tidak mendukung jaringan privat. | Semua tugas. | Token akses OAuth2 |
AZ_BATCH_CERTIFICATES_DIR | Direktori dalam direktori kerja tugas tempat sertifikat disimpan untuk simpul komputasi Linux. Variabel lingkungan ini tidak berlaku untuk simpul komputasi Windows. | Semua tugas. | /mnt/batch/tasks/workitems/batchjob001/job-1/task001/certs |
AZ_BATCH_HOST_LIST | Daftar simpul yang dialokasikan untuk tugas multi instans di dalam format nodeIP,nodeIP . |
Multi instans primer dan sub-tugas. | 10.0.0.4,10.0.0.5 |
AZ_BATCH_IS_CURRENT_NODE_MASTER | Menentukan apakah simpul terkini merupakan simpul master untuk tugas multi instans. Nilai yang mungkin adalah true dan false . |
Multi instans primer dan sub-tugas. | true |
AZ_BATCH_JOB_ID | ID pekerjaan tempat tugas itu berada. | Semua tugas kecuali mulai tugas. | batchjob001 |
AZ_BATCH_JOB_PREP_DIR | Jalur lengkap persiapan pekerjaan direktori tugas pada simpul. | Semua tugas kecuali mulai tugas dan tugas persiapan pekerjaan. Hanya tersedia jika pekerjaan dikonfigurasi dengan tugas persiapan pekerjaan. | C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation |
AZ_BATCH_JOB_PREP_WORKING_DIR | Jalur lengkap persiapan pekerjaan direktori kerja tugas pada simpul. | Semua tugas kecuali mulai tugas dan tugas persiapan pekerjaan. Hanya tersedia jika pekerjaan dikonfigurasi dengan tugas persiapan pekerjaan. | C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation\wd |
AZ_BATCH_MASTER_NODE | Alamat IP dan port simpul komputasi tempat tugas utama dari tugas multi instans dijalankan. Jangan gunakan port yang ditentukan di sini untuk komunikasi MPI atau NCCL - Port ini disediakan untuk layanan Azure Batch. Gunakan saja variabel MASTER_PORT, dengan mengaturnya menggunakan nilai yang dilewatkan melalui argumen baris perintah (port 6105 adalah pilihan default yang baik), atau menggunakan set nilai AML, jika perlu. | Multi instans primer dan sub-tugas. | 10.0.0.4:6000 |
AZ_BATCH_NODE_ID | ID simpul tempat tugas ditetapkan. | Semua tugas. | tvm-1219235766_3-20160919t172711z |
AZ_BATCH_NODE_IS_DEDICATED | Jika true , simpul terkini adalah simpul khusus. Jika false , simpul tersebut adalah simpul Azure Spot. |
Semua tugas. | true |
AZ_BATCH_NODE_LIST | Daftar simpul yang dialokasikan untuk tugas multi instans di dalam format nodeIP;nodeIP . |
Multi instans primer dan sub-tugas. | 10.0.0.4;10.0.0.5 |
AZ_BATCH_NODE_MOUNTS_DIR | Jalur lengkap dari lokasi tingkat simpul pemasangan sistem file tempat semua direktori pemasangan berada. Berkas berbagi file Windows menggunakan huruf kandar, jadi untuk Windows, kandar pemasangan adalah bagian dari perangkat dan kandar. | Semua tugas termasuk mulai tugas memiliki akses ke pengguna, mengingat pengguna mengetahui izin pemasangan untuk direktori yang terpasang. | Di Ubuntu, misalnya, lokasinya adalah: /mnt/batch/tasks/fsmounts |
AZ_BATCH_NODE_ROOT_DIR | Jalur lengkap akar semua direktori Batch pada simpul. | Semua tugas. | C:\user\tasks |
AZ_BATCH_NODE_SHARED_DIR | Jalur lengkap direktori bersama pada simpul. Semua tugas yang dijalankan pada sebuah simpul memiliki akses baca/tulis ke direktori ini. Tugas yang dijalankan pada simpul lain tidak memiliki akses jarak jauh ke direktori ini (bukan direktori jaringan “bersama”). | Semua tugas. | C:\user\tasks\shared |
AZ_BATCH_NODE_STARTUP_DIR | Jalur lengkap dari direktori mulai tugas pada simpul. | Semua tugas. | C:\user\tasks\startup |
AZ_BATCH_POOL_ID | ID kumpulan tempat tugas dijalankan. | Semua tugas. | batchpool001 |
AZ_BATCH_TASK_DIR | Jalur lengkap direktori tugas pada simpul. Direktori ini berisi stdout.txt dan stderr.txt untuk tugas, dan AZ_BATCH_TASK_WORKING_DIR. |
Semua tugas. | C:\user\tasks\workitems\batchjob001\job-1\task001 |
AZ_BATCH_TASK_ID | ID tugas terkini. | Semua tugas kecuali mulai tugas. | task001 |
AZ_BATCH_TASK_SHARED_DIR | Jalur direktori yang identik untuk tugas utama dan setiap sub-tugas dari tugas multi instans. Jalur terdapat pada setiap simpul tempat tugas multi instans dijalankan, dan memiliki akses baca/tulis terhadap perintah tugas yang berjalan pada simpul tersebut (baik pada perintah koordinasi mau pun perintah aplikasi). Sub-tugas atau tugas utama yang dijalankan pada simpul lain tidak memiliki akses jarak jauh ke direktori ini (bukan direktori jaringan "bersama"). | Multi instans primer dan sub-tugas. | C:\user\tasks\workitems\multiinstancesamplejob\job-1\multiinstancesampletask |
AZ_BATCH_TASK_WORKING_DIR | Jalur lengkap direktori pekerjaan tugas pada simpul. Tugas yang saat ini berjalan memiliki akses baca/tulis ke direktori ini. | Semua tugas. | C:\user\tasks\workitems\batchjob001\job-1\task001\wd |
AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES | Ambang batas terkini untuk ruang disk tempat VM, akan ditandai sebagai DiskFull . |
Semua tugas. | 1000000 |
CCP_NODES | Daftar simpul dan jumlah inti per simpul yang dialokasikan untuk tugas multi instans. Simpul dan inti tercantum dalam format numNodes<space>node1IP<space>node1Cores<space> node2IP<space>node2Cores<space> ... , di mana jumlah simpul diikuti oleh satu atau lebih alamat IP simpul dengan jumlah inti untuk tiap simpul. |
Multi instans primer dan sub-tugas. | 2 10.0.0.4 1 10.0.0.5 1 |
Langkah berikutnya
- Pelajari cara menggunakan variabel lingkungan dengan Batch.
- Pelajari selengkapnya tentang file dan direktori di Batch
- Pelajari tentang tugas multi instans.