Aracılığıyla paylaş


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