Variabel lingkungan runtime bahasa umum Azure Batch

  • Artikel

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