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 cmd.exe Linux düğümünde başlatın/bin/sh:

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, PATH dahil ortam değişkeni genişletmesi gibi kabuk özelliklerini yerel olarak kullanamadıkları anlamına gelir. Bu tür özellikleri kullanmak için komut satırında kabuğu çağırmanız gerekir. Örneğin, cmd.exe Windows işlem düğümlerinde veya /bin/sh Linux düğümlerinde başlatın.

cmd /c MyTaskApplication.exe %MY_ENV_VAR%

/bin/sh -c "MyTaskApplication $MY_ENV_VAR"

Ortam değişkenleri

Uyarı

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ı Açıklama Kullanılabilirlik Örnek
AZ_BATCH_ACCOUNT_NAME Görevin ait olduğu Batch hesabının adı. Tüm görevler. MyBatchAccount (Benim Hesabım)
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 ortamında, uygulama paketi adı "Agent-linux-x64" ve sürüm "1.1.46.0" ise, ortam adı aslında şöyle olur: AZ_BATCH_APP_PACKAGE_agent_linux_x64_1_1_46_0, burada alt çizgiler ve küçük harfler kullanılır. 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ğindeauthenticationTokenSettings 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. Jeton özel ağları 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 (if a translation is necessary, consider translating it: AZ_TOPLU_HOST_LİSTESİ) biçiminde nodeIP,nodeIP ayrılan düğümlerin listesi. Çok örnekli birincil ve alt görevler. 10.0.0.4,10.0.0.5
AZ_BATCH_MEVCUT_DÜĞÜM_ANA_MAKİNE_Mİ Geçerli düğümün çok örnekli bir görev için ana düğüm olup olmadığını belirtir. Olası değerler true ve false şeklindedir. Ç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 İş hazırlama görev dizininin düğümdeki 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. AZ_BATCH_JOB_PREP_DIR
AZ_BATCH_JOB_HAZIRLIK_CALISMA_DIZINI 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. AZ_BATCH_JOB_PREP_WORKING_DIR
AZ_BATCH_MASTER_NODE Çok örnekli bir görevin ana görevinin ç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, komut satırı bağımsız değişkeni ile iletilen bir değerle MASTER_PORT değişkenini ayarlayarak kullanın (6105 iyi bir varsayılan bağlantı noktasıdır) veya eğer AML bu işlemi yapıyorsa onun belirlediği değeri 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_ADANMIŞTIR Eğer true ise, 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 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. AZ_BATCH_NODE_MOUNTS_DIR
AZ_BATCH_NODE_ROOT_DIR Düğümdeki tüm Batch dizinlerinin kökünün tam yolu. Tüm görevler. AZ_BATCH_NODE_ROOT_DIR
AZ_BATCH_NODE_SHARED_DIR Düğümdeki paylaşılan dizinin tam yolu. Yürütüldüğü düğümdeki 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. AZ_BATCH_NODE_SHARED_DIR
AZ_BATCH_NODE_STARTUP_DIR Düğümdeki başlangıç görev dizininin tam yolu. Tüm görevler. AZ_BATCH_NODE_STARTUP_DIR
AZ_BATCH_POOL_ID Görevin çalıştığı havuzun kimliği (ID'si). Tüm görevler. batchpool001
AZ_BATCH_TASK_DIR Düğümdeki görev dizininin tam yolu. Bu dizin, görevin stdout.txt ve stderr.txt ile AZ_BATCH_TASK_WORKING_DIR'i içerir. Tüm görevler. AZ_BATCH_TASK_DIR
AZ_BATCH_TASK_ID Geçerli görevin ID'si. 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. AZ_BATCH_TASK_SHARED_DIR
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. AZ_BATCH_TASK_WORKING_DIR
AZ_BATCH_TASK_RESERVED_EPHEMERAL_DISK_SPACE_BYTES VM'nin DiskFull olarak işaretleneceği mevcut disk alanı eşiği. 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

Önemli

Ortam Değişkenleri için yolların tam değerleri uygulama ayrıntıları olarak kabul edilir ve değiştirilebilir. Ham yol gösterimleri oluşturmak yerine Batch tarafından sağlanan Ortam Değişkenlerini kullanın.

Aşağıdaki tablo, AZ_BATCH_NODE_ROOT_DIR değerinden sonra her ortam değişkeni değeri sonekinin değerlerini belirtir. Daha fazla bilgi için bkz. AZ_BATCH_NODE_ROOT_DIR .

Ortam Değişkeni Adı Ortam Değişkeni Değeri Dizin Posta Ek
AZ_BATCH_NODE_STARTUP_DIR startup
AZ_BATCH_NODE_SHARED_DIR shared
AZ_BATCH_NODE_MOUNTS_DIR fsmounts

İş dizinleri, tek seferlik çalışma ve iş programı arasında farklıdır. Aşağıdaki tablo, tek çalıştırmalı iş ve iş zamanlaması içindeki iş dizini değerlerini belirtir.

İş Türü AZ_BATCH_NODE_ROOT_DIR sonra İş Dizini Değeri Son Eki
İş workitems\{job name}\job-1
İş Zamanlaması workitems\{job schedule name}\{job name}

Aşağıdaki tablo, iş dizininden sonraki her ortam değişkeni değeri sonekinin değerlerini belirtir.

Ortam Değişkeni Adı İş Dizininden Sonra Ortam Değişkeni Değer Dizini Son Eki
AZ_BATCH_TASK_WORKING_DIR {task name}\wd
AZ_BATCH_TASK_DIR {task name}
AZ_BATCH_TASK_SHARED_DIR {task name}
AZ_BATCH_JOB_PREP_DIR {job prepration task name}
AZ_BATCH_JOB_HAZIRLIK_CALISMA_DIZINI {job prepration task name}\wd

Sonraki adımlar

  • Last updated on