Azure Batch çalışma zamanı ortam değişkenleri
Azure Batch hizmeti, işlem düğümlerinde aşağıdaki ortam değişkenlerini ayarlar. Bu ortam değişkenlerine görev komut satırlarında ve komut satırları tarafından çalıştırılan programlarda ve betiklerde başvurabilirsiniz.
Batch ile ortam değişkenlerini kullanma hakkında daha fazla bilgi için bkz . Görevler için ortam ayarları.
Ortam değişkeni görünürlüğü
Bu ortam değişkenleri yalnızca görevin yürütüldiği düğümdeki kullanıcı hesabı olan görev kullanıcısı bağlamında görünür. Uzak Masaüstü Protokolü (RDP) veya Secure Shell (SSH) aracılığıyla bir işlem düğümüne uzaktan bağlanırken ve ortam değişkenlerini listelerken bu değişkenleri görmezsiniz. Bunun nedeni, uzak bağlantı için kullanılan kullanıcı hesabının görev tarafından kullanılan hesapla aynı olmamasıdır.
Bir ortam değişkeninin geçerli değerini almak için Windows işlem düğümünde veya /bin/sh Linux düğümünde başlatıncmd.exe:
cmd /c set <ENV_VARIABLE_NAME>
/bin/sh -c "printenv <ENV_VARIABLE_NAME>"
Ortam değişkenlerinin komut satırı genişletmesi
İşlem düğümlerinde görevler tarafından yürütülen komut satırları kabuk altında çalışmaz. Bu, bu komut satırlarının ortam değişkeni genişletmesi (dahil) gibi kabuk özelliklerini yerel olarak kullanamadıları PATHanlamına gelir. Bu tür özellikleri kullanmak için komut satırında kabuğu çağırmanız gerekir. Örneğin, Windows işlem düğümlerinde veya /bin/sh Linux düğümlerinde başlatıncmd.exe:
cmd /c MyTaskApplication.exe %MY_ENV_VAR%
/bin/sh -c "MyTaskApplication $MY_ENV_VAR"
Ortam değişkenleri
Dekont
AZ_BATCH_AUTHENTICATION_TOKEN kullanım dışı bırakılmıştır ve 30 Eylül 2024 tarihinde kullanımdan kaldırılacaktır. Ayrıntılar ve alternatif uygulama için duyuruya bakın.
| Değişken adı | Tanım | Uygunluk | Örnek |
|---|---|---|---|
| AZ_BATCH_ACCOUNT_NAME | Görevin ait olduğu Batch hesabının adı. | Tüm görevler. | mybatchaccount |
| AZ_BATCH_ACCOUNT_URL | Batch hesabının URL'si. | Tüm görevler. | https://myaccount.westus.batch.azure.com |
| AZ_BATCH_APP_PACKAGE | Tüm uygulama paketi ortam değişkenlerinin ön eki. Örneğin, Uygulama "FOO" sürümü "1" bir havuza yüklenmişse ortam değişkeni AZ_BATCH_APP_PACKAGE_FOO_1 (Linux üzerinde) veya AZ_BATCH_APP_PACKAGE_FOO#1 (Windows üzerinde) olur. AZ_BATCH_APP_PACKAGE_FOO_1 paketin indirildiği konumu (klasör) gösterir. Uygulama paketinin varsayılan sürümünü kullanırken, sürüm numaraları olmadan AZ_BATCH_APP_PACKAGE ortam değişkenini kullanın. Linux'ta ve uygulama paketi adı "Agent-linux-x64" ve sürüm "1.1.46.0" ise, ortam adı aslında: alt çizgi ve küçük harf kullanarak AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0. Daha fazla bilgi için bkz . Yüklü uygulamaları yürütme. | İlişkili uygulama paketi olan herhangi bir görev. Düğümün kendisinde uygulama paketleri varsa tüm görevler için de kullanılabilir. | AZ_BATCH_APP_PACKAGE_FOO_1 (Linux) veya AZ_BATCH_APP_PACKAGE_FOO#1 (Windows) |
| AZ_BATCH_AUTHENTICATION_TOKEN | Sınırlı bir Batch hizmeti işlemleri kümesine erişim sağlayan bir kimlik doğrulama belirteci. Bu ortam değişkeni yalnızca görev eklendiğinde authenticationToken Ayarlar ayarlanırsa bulunur. Belirteç değeri Batch API'lerinde BatchClient.Open() .NET API'sindeki gibi bir Batch istemcisi oluşturmak için kimlik bilgileri olarak kullanılır. Belirteç özel ağı desteklemez. | Tüm görevler. | OAuth2 erişim belirteci |
| AZ_BATCH_CERTIFICATES_DIR | Linux işlem düğümleri için sertifikaların depolandığı görev çalışma dizini içindeki bir dizin . Bu ortam değişkeni Windows işlem düğümleri için geçerli değildir. | Tüm görevler. | /mnt/batch/tasks/workitems/batchjob001/job-1/task001/certs |
| AZ_BATCH_HOST_LIST | biçiminde nodeIP,nodeIPçok örnekli bir göreve ayrılan düğümlerin listesi. |
Çok örnekli birincil ve alt görevler. | 10.0.0.4,10.0.0.5 |
| AZ_BATCH_IS_CURRENT_NODE_MASTER | Geçerli düğümün çok örnekli bir görev için ana düğüm olup olmadığını belirtir. Olası değerler ve falseşeklindedirtrue. |
Çok örnekli birincil ve alt görevler. | true |
| AZ_BATCH_JOB_ID | Görevin ait olduğu işin kimliği. | Başlangıç görevi dışındaki tüm görevler. | batchjob001 |
| AZ_BATCH_JOB_PREP_DIR | Düğümdeki iş hazırlama görev dizininin tam yolu. | Görevi başlatma ve iş hazırlama görevi dışındaki tüm görevler. Yalnızca iş bir iş hazırlama göreviyle yapılandırılmışsa kullanılabilir. | C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation |
| AZ_BATCH_JOB_PREP_WORKING_DIR | Düğümdeki iş hazırlama görevi çalışma dizininin tam yolu. | Görevi başlatma ve iş hazırlama görevi dışındaki tüm görevler. Yalnızca iş bir iş hazırlama göreviyle yapılandırılmışsa kullanılabilir. | C:\user\tasks\workitems\jobprepreleasesamplejob\job-1\jobpreparation\wd |
| AZ_BATCH_MASTER_NODE | Çok örnekli bir görevin birincil görevinin üzerinde çalıştığı işlem düğümünün IP adresi ve bağlantı noktası. Burada belirtilen bağlantı noktasını MPI veya NCCL iletişimi için kullanmayın; Azure Batch hizmeti için ayrılmıştır. Bunun yerine MASTER_PORT değişkenini, komut satırı bağımsız değişkeni aracılığıyla geçirilen bir değerle ayarlayarak (bağlantı noktası 6105 iyi bir varsayılan seçenektir) veya varsa AML kümeleri değerini kullanarak kullanın. | Çok örnekli birincil ve alt görevler. | 10.0.0.4:6000 |
| AZ_BATCH_NODE_ID | Görevin atandığı düğümün kimliği. | Tüm görevler. | tvm-1219235766_3-20160919t172711z |
| AZ_BATCH_NODE_IS_DEDICATED | ise true, geçerli düğüm ayrılmış bir düğümdür. ise falsebir Azure Spot düğümüdür. |
Tüm görevler. | true |
| AZ_BATCH_NODE_LIST | biçiminde nodeIP;nodeIPçok örnekli bir göreve ayrılan düğümlerin listesi. |
Çok örnekli birincil ve alt görevler. | 10.0.0.4;10.0.0.5 |
| AZ_BATCH_NODE_MOUNTS_DIR | Tüm bağlama dizinlerinin bulunduğu düğüm düzeyinde dosya sistemi bağlama konumunun tam yolu. Windows dosya paylaşımları bir sürücü harfi kullandığından, Windows için bağlama sürücüsü cihazların ve sürücülerin bir parçasıdır. | Kullanıcının bağlı dizin için bağlama izinlerinin farkında olması nedeniyle, başlangıç görevi de dahil olmak üzere tüm görevlerin kullanıcıya erişimi vardır. | Örneğin Ubuntu'da konum: /mnt/batch/tasks/fsmounts |
| AZ_BATCH_NODE_ROOT_DIR | Düğümdeki tüm Batch dizinlerinin kökünün tam yolu. | Tüm görevler. | C:\user\tasks |
| AZ_BATCH_NODE_SHARED_DIR | Düğümdeki paylaşılan dizinin tam yolu. Düğümde yürütülen tüm görevlerin bu dizine okuma/yazma erişimi vardır. Diğer düğümlerde yürütülen görevlerin bu dizine uzaktan erişimi yoktur ("paylaşılan" bir ağ dizini değildir). | Tüm görevler. | C:\user\tasks\shared |
| AZ_BATCH_NODE_STARTUP_DIR | Düğümdeki başlangıç görevi dizininin tam yolu. | Tüm görevler. | C:\user\tasks\startup |
| AZ_BATCH_POOL_ID | Görevin çalıştığı havuzun kimliği. | Tüm görevler. | batchpool001 |
| AZ_BATCH_TASK_DIR | Düğümdeki görev dizininin tam yolu. Bu dizin görevin ve stderr.txt AZ_BATCH_TASK_WORKING_DIR içerirstdout.txt. |
Tüm görevler. | C:\user\tasks\workitems\batchjob001\job-1\task001 |
| AZ_BATCH_TASK_ID | Geçerli görevin kimliği. | Başlangıç görevi dışındaki tüm görevler. | görev001 |
| AZ_BATCH_TASK_SHARED_DIR | Birincil görev ve çok örnekli bir görevin her alt görevi için aynı olan dizin yolu. Yol, çok örnekli görevin çalıştığı her düğümde bulunur ve bu düğümde çalışan görev komutları (hem koordinasyon komutu hem de uygulama komutu) için okuma/yazma erişilebilir. Alt görevlerin veya diğer düğümlerde yürütülen birincil görevin bu dizine uzaktan erişimi yoktur ("paylaşılan" bir ağ dizini değildir). | Çok örnekli birincil ve alt görevler. | C:\user\tasks\workitems\multiinstancesamplejob\job-1\multiinstancesampletask |
| AZ_BATCH_TASK_WORKING_DIR | Düğümdeki görev çalışma dizininin tam yolu. Şu anda çalışan görevin bu dizine okuma/yazma erişimi vardır. | Tüm görevler. | C:\user\tasks\workitems\batchjob001\job-1\task001\wd |
| AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES | VM'nin olarak DiskFullişaretleneceği disk alanı için geçerli eşik. |
Tüm görevler. | 1000000 |
| CCP_NODES | Çok örnekli bir göreve ayrılan düğümlerin listesi ve düğüm başına çekirdek sayısı. Düğümler ve çekirdekler biçiminde listelenir numNodes<space>node1IP<space>node1Cores<space>node2IP<space>node2Cores<space> ..., burada düğüm sayısının ardından bir veya daha fazla düğüm IP adresi ve her biri için çekirdek sayısı eklenir. |
Çok örnekli birincil ve alt görevler. | 2 10.0.0.4 1 10.0.0.5 1 |
Sonraki adımlar
- Batch ile ortam değişkenlerini kullanmayı öğrenin.
- Batch'te dosyalar ve dizinler hakkında daha fazla bilgi edinin
- Çok örnekli görevler hakkında bilgi edinin.