BatchJobManagerTask interface

Paket:

@azure-rest/batch

İş Yöneticisi Görevinin ayrıntılarını belirtir. İş Yöneticisi Görevi, İş oluşturulduğunda otomatik olarak başlatılır. Batch hizmeti, İş Yöneticisi Görevini İş'teki diğer Görevlerden önce zamanlamayı dener. Bir Havuzu daraltırken Batch hizmeti, İş Yöneticisi Görevlerinin çalıştığı Düğümleri mümkün olduğunca uzun süre korumaya çalışır (yani, 'normal' Görevleri çalıştıran İşlem Düğümleri, İş Yöneticisi Görevlerini çalıştıran İşlem Düğümleri'ne geçmeden önce kaldırılır). Bir İş Yöneticisi Görevi başarısız olduğunda ve yeniden başlatılması gerektiğinde, sistem bunu en yüksek önceliğe göre zamanlamaya çalışır. Kullanılabilir boşta İşlem Düğümü yoksa sistem, İş Yöneticisi Görevinin yeniden başlatılmasına yer açmak için Havuzda çalışan Görevlerden birini sonlandırabilir ve kuyruğa döndürebilir. Bir İşteki İş Yöneticisi Görevinin diğer İşlerdeki Görevlere göre önceliğe sahip olmadığını unutmayın. İşler genelinde yalnızca İş düzeyi öncelikleri gözlenir. Örneğin, öncelik 0 İşindeki bir İş Yöneticisi'nin yeniden başlatılması gerekiyorsa, öncelik 1 İşin Görevlerinin yerini almayacaktır. Batch, Bir Düğümde kurtarma işlemi tetiklendiğinde Görevleri yeniden dener. İyi durumda olmayan bir Düğüm yeniden başlatıldığında veya konak hatası nedeniyle bir İşlem Düğümü kaybolduğunda kurtarma işlemlerine örnek olarak verilebilir (ancak bunlarla sınırlı değildir). Kurtarma işlemleri nedeniyle yapılan yeniden denemeler, maxTaskRetryCount'a göre bağımsızdır ve sayılmaz. maxTaskRetryCount değeri 0 olsa bile, kurtarma işlemi nedeniyle bir iç yeniden deneme gerçekleşebilir. Bu nedenle, tüm Görevler bir kez etkili olmalıdır. Bu, Görevlerin bozulmaya veya yinelenen verilere neden olmadan kesintiye uğramasına ve yeniden başlatılmasına tolerans göstermesi gerektiği anlamına gelir. Uzun süre çalışan Görevler için en iyi yöntem, bir tür denetim noktası kullanmaktır.

Özellikler

allowLowPriorityNode	İş Yöneticisi Görevinin Spot/Düşük öncelikli bir İşlem Düğümünde çalışıp çalışmayabileceği. Varsayılan değer true değeridir.
applicationPackageReferences	Komut satırını çalıştırmadan önce Batch hizmetinin İşlem Düğümüne dağıtacağı Uygulama Paketlerinin listesi. Uygulama Paketleri indirilir ve Görev çalışma dizinine değil paylaşılan dizine dağıtılır. Bu nedenle, başvuruda bulunılan bir Uygulama Paketi zaten İşlem Düğümündeyse ve güncelse, yeniden indirılmaz; İşlem Düğümündeki mevcut kopya kullanılır. Başvurulan bir Uygulama Paketi, örneğin paket silindiği veya indirme başarısız olduğu için yüklenemediyse, Görev başarısız olur.
authenticationTokenSettings	Görevin Batch hizmeti işlemlerini gerçekleştirmek için kullanabileceği kimlik doğrulama belirtecinin ayarları. Bu özellik ayarlanırsa Batch hizmeti, Bir Hesap erişim anahtarı gerektirmeden Batch hizmeti işlemlerinin kimliğini doğrulamak için kullanılabilecek bir kimlik doğrulama belirteci ile Görev sağlar. Belirteç, AZ_BATCH_AUTHENTICATION_TOKEN ortam değişkeni aracılığıyla sağlanır. Görevin belirteci kullanarak gerçekleştirebileceği işlemler ayarlara bağlıdır. Örneğin, Bir Görev, İş'e başka Görevler eklemek için İş izinleri isteyebilir veya İşin veya İş altındaki diğer Görevlerin durumunu denetleyebilir.
commandLine	İş Yöneticisi Görevinin komut satırı. Komut satırı bir kabuk altında çalışmaz ve bu nedenle ortam değişkeni genişletme gibi kabuk özelliklerinden yararlanamaz. Bu tür özelliklerden yararlanmak istiyorsanız, kabuğu komut satırında çağırmanız gerekir; örneğin, Windows'ta "cmd /c MyCommand" veya Linux'ta "/bin/sh -c MyCommand" kullanın. Komut satırı dosya yollarına başvuruyorsa, göreli bir yol (Görev çalışma dizinine göre) veya Batch tarafından sağlanan ortam değişkenini (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables) kullanmalıdır.
constraints	İş Yöneticisi Görevi için geçerli olan kısıtlamalar.
containerSettings	İş Yöneticisi Görevinin altında çalıştığı kapsayıcının ayarları. Bu Görevi çalıştıracak Havuz containerConfiguration kümesine sahipse, bunun da ayarlanması gerekir. Bu Görevi çalıştıracak Havuzda containerConfiguration ayarlanmamışsa, bu ayar yapılmamalıdır. Bu belirtildiğinde, AZ_BATCH_NODE_ROOT_DIR altındaki tüm dizinler (düğümdeki Azure Batch dizinlerinin kökü) kapsayıcıya eşlenir, tüm Görev ortamı değişkenleri kapsayıcıya eşlenir ve Görev komut satırı kapsayıcıda yürütülür. AZ_BATCH_NODE_ROOT_DIR dışında kapsayıcıda üretilen dosyalar konak diske yansıtılmayabilir; bu da Batch dosya API'lerinin bu dosyalara erişemeyeceği anlamına gelir.
displayName	İş Yöneticisi Görevinin görünen adı. Benzersiz olması gerekmez ve en fazla 1024 uzunluğa kadar Unicode karakter içerebilir.
environmentSettings	İş Yöneticisi Görevi için ortam değişkeni ayarlarının listesi.
id	İş içindeki İş Yöneticisi Görevini benzersiz olarak tanımlayan bir dize. Kimlik, kısa çizgi ve alt çizgi gibi alfasayısal karakterlerin herhangi bir bileşimini içerebilir ve 64'ten fazla karakter içeremez.
killJobOnCompletion	İş Yöneticisi Görevinin tamamlanıp tamamlanmadığı, işin tamamının tamamlanıp tamamlanmadığını gösterir. Doğruysa, İş Yöneticisi Görevi tamamlandığında Batch hizmeti İşi tamamlandı olarak işaretler. Şu anda çalışmaya devam eden görevler varsa (İş Sürümü dışında), bu Görevler sonlandırılır. Yanlışsa, İş Yöneticisi Görevinin tamamlanması İş durumunu etkilemez. Bu durumda, İşi sonlandırmak için onAllTasksComplete özniteliğini kullanmanız veya bir istemcinin veya kullanıcının İşi açıkça sonlandırmasını sağlayın. Bunun bir örneği, İş Yöneticisi'nin bir dizi Görev oluşturması ancak daha sonra yürütmesinde başka rol almama olmasıdır. Varsayılan değer true değeridir. İş ömrünü denetlemek için onAllTasksComplete ve onTaskFailure özniteliklerini kullanıyorsanız ve İş Yöneticisi Görevini yalnızca İşin Görevlerini oluşturmak için kullanıyorsanız (ilerlemeyi izlemek için değil), killJobOnCompletion değerini false olarak ayarlamanız önemlidir.
outputFiles	Komut satırını çalıştırdıktan sonra Batch hizmetinin İşlem Düğümü'nden karşıya yükleyeceği dosyaların listesi. Çok örnekli Görevler için dosyalar yalnızca birincil Görevin yürütüleceği İşlem Düğümü'nden karşıya yüklenir.
requiredSlots	Görevin çalışması için gereken zamanlama yuvalarının sayısı. Varsayılan değer 1'dir. Görev yalnızca düğümde yeterli boş zamanlama yuvası varsa işlem düğümünde çalışacak şekilde zamanlanabilir. Çok örnekli Görevler için bu özellik desteklenmez ve belirtilmemelidir.
resourceFiles	Komut satırını çalıştırmadan önce Batch hizmetinin İşlem Düğümüne indireceği dosyaların listesi. Bu öğe altında listelenen dosyalar Görevin çalışma dizininde bulunur. Kaynak dosyaları listesi için en büyük boyut vardır. En büyük boyut aşıldığında istek başarısız olur ve yanıt hata kodu RequestEntityTooLarge olur. Bu durumda ResourceFiles koleksiyonunun boyutu azaltılmalıdır. Bu, .zip dosyaları, Uygulama Paketleri veya Docker Kapsayıcıları kullanılarak elde edilebilir.
runExclusive	İş Yöneticisi Görevinin çalıştığı İşlem Düğümü'ne özel kullanım gerekip gerekmediği. True ise, İş Yöneticisi çalıştığı sürece aynı Düğümde başka hiçbir Görev çalışmaz. False ise, diğer Görevler bir İşlem Düğümündeki İş Yöneticisi ile aynı anda çalıştırılabilir. İş Yöneticisi Görevi normalde İşlem Düğümü'nin eş zamanlı Görev sınırına göre sayılır, bu nedenle bu yalnızca İşlem Düğümü birden çok eşzamanlı Göreve izin veriyorsa geçerlidir. Varsayılan değer true değeridir.
userIdentity	İş Yöneticisi Görevinin altında çalıştığı kullanıcı kimliği. Atlanırsa, Görev, Göreve özgü yönetici olmayan bir kullanıcı olarak çalışır.

Özellik Ayrıntıları

allowLowPriorityNode

İş Yöneticisi Görevinin Spot/Düşük öncelikli bir İşlem Düğümünde çalışıp çalışmayabileceği. Varsayılan değer true değeridir.

allowLowPriorityNode?: boolean

Özellik Değeri

boolean

applicationPackageReferences

Komut satırını çalıştırmadan önce Batch hizmetinin İşlem Düğümüne dağıtacağı Uygulama Paketlerinin listesi. Uygulama Paketleri indirilir ve Görev çalışma dizinine değil paylaşılan dizine dağıtılır. Bu nedenle, başvuruda bulunılan bir Uygulama Paketi zaten İşlem Düğümündeyse ve güncelse, yeniden indirılmaz; İşlem Düğümündeki mevcut kopya kullanılır. Başvurulan bir Uygulama Paketi, örneğin paket silindiği veya indirme başarısız olduğu için yüklenemediyse, Görev başarısız olur.

applicationPackageReferences?: BatchApplicationPackageReference[]

Özellik Değeri

BatchApplicationPackageReference[]

authenticationTokenSettings

Görevin Batch hizmeti işlemlerini gerçekleştirmek için kullanabileceği kimlik doğrulama belirtecinin ayarları. Bu özellik ayarlanırsa Batch hizmeti, Bir Hesap erişim anahtarı gerektirmeden Batch hizmeti işlemlerinin kimliğini doğrulamak için kullanılabilecek bir kimlik doğrulama belirteci ile Görev sağlar. Belirteç, AZ_BATCH_AUTHENTICATION_TOKEN ortam değişkeni aracılığıyla sağlanır. Görevin belirteci kullanarak gerçekleştirebileceği işlemler ayarlara bağlıdır. Örneğin, Bir Görev, İş'e başka Görevler eklemek için İş izinleri isteyebilir veya İşin veya İş altındaki diğer Görevlerin durumunu denetleyebilir.

authenticationTokenSettings?: AuthenticationTokenSettings

Özellik Değeri

AuthenticationTokenSettings

commandLine

İş Yöneticisi Görevinin komut satırı. Komut satırı bir kabuk altında çalışmaz ve bu nedenle ortam değişkeni genişletme gibi kabuk özelliklerinden yararlanamaz. Bu tür özelliklerden yararlanmak istiyorsanız, kabuğu komut satırında çağırmanız gerekir; örneğin, Windows'ta "cmd /c MyCommand" veya Linux'ta "/bin/sh -c MyCommand" kullanın. Komut satırı dosya yollarına başvuruyorsa, göreli bir yol (Görev çalışma dizinine göre) veya Batch tarafından sağlanan ortam değişkenini (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables) kullanmalıdır.

commandLine: string

Özellik Değeri

string

constraints

İş Yöneticisi Görevi için geçerli olan kısıtlamalar.

constraints?: BatchTaskConstraints

Özellik Değeri

BatchTaskConstraints

containerSettings

İş Yöneticisi Görevinin altında çalıştığı kapsayıcının ayarları. Bu Görevi çalıştıracak Havuz containerConfiguration kümesine sahipse, bunun da ayarlanması gerekir. Bu Görevi çalıştıracak Havuzda containerConfiguration ayarlanmamışsa, bu ayar yapılmamalıdır. Bu belirtildiğinde, AZ_BATCH_NODE_ROOT_DIR altındaki tüm dizinler (düğümdeki Azure Batch dizinlerinin kökü) kapsayıcıya eşlenir, tüm Görev ortamı değişkenleri kapsayıcıya eşlenir ve Görev komut satırı kapsayıcıda yürütülür. AZ_BATCH_NODE_ROOT_DIR dışında kapsayıcıda üretilen dosyalar konak diske yansıtılmayabilir; bu da Batch dosya API'lerinin bu dosyalara erişemeyeceği anlamına gelir.

containerSettings?: BatchTaskContainerSettings

Özellik Değeri

BatchTaskContainerSettings

displayName

İş Yöneticisi Görevinin görünen adı. Benzersiz olması gerekmez ve en fazla 1024 uzunluğa kadar Unicode karakter içerebilir.

displayName?: string

Özellik Değeri

string

environmentSettings

İş Yöneticisi Görevi için ortam değişkeni ayarlarının listesi.

environmentSettings?: EnvironmentSetting[]

Özellik Değeri

EnvironmentSetting[]

id

İş içindeki İş Yöneticisi Görevini benzersiz olarak tanımlayan bir dize. Kimlik, kısa çizgi ve alt çizgi gibi alfasayısal karakterlerin herhangi bir bileşimini içerebilir ve 64'ten fazla karakter içeremez.

id: string

Özellik Değeri

string

killJobOnCompletion

İş Yöneticisi Görevinin tamamlanıp tamamlanmadığı, işin tamamının tamamlanıp tamamlanmadığını gösterir. Doğruysa, İş Yöneticisi Görevi tamamlandığında Batch hizmeti İşi tamamlandı olarak işaretler. Şu anda çalışmaya devam eden görevler varsa (İş Sürümü dışında), bu Görevler sonlandırılır. Yanlışsa, İş Yöneticisi Görevinin tamamlanması İş durumunu etkilemez. Bu durumda, İşi sonlandırmak için onAllTasksComplete özniteliğini kullanmanız veya bir istemcinin veya kullanıcının İşi açıkça sonlandırmasını sağlayın. Bunun bir örneği, İş Yöneticisi'nin bir dizi Görev oluşturması ancak daha sonra yürütmesinde başka rol almama olmasıdır. Varsayılan değer true değeridir. İş ömrünü denetlemek için onAllTasksComplete ve onTaskFailure özniteliklerini kullanıyorsanız ve İş Yöneticisi Görevini yalnızca İşin Görevlerini oluşturmak için kullanıyorsanız (ilerlemeyi izlemek için değil), killJobOnCompletion değerini false olarak ayarlamanız önemlidir.

killJobOnCompletion?: boolean

Özellik Değeri

boolean

outputFiles

Komut satırını çalıştırdıktan sonra Batch hizmetinin İşlem Düğümü'nden karşıya yükleyeceği dosyaların listesi. Çok örnekli Görevler için dosyalar yalnızca birincil Görevin yürütüleceği İşlem Düğümü'nden karşıya yüklenir.

outputFiles?: OutputFile[]

Özellik Değeri

OutputFile[]

requiredSlots

Görevin çalışması için gereken zamanlama yuvalarının sayısı. Varsayılan değer 1'dir. Görev yalnızca düğümde yeterli boş zamanlama yuvası varsa işlem düğümünde çalışacak şekilde zamanlanabilir. Çok örnekli Görevler için bu özellik desteklenmez ve belirtilmemelidir.

requiredSlots?: number

Özellik Değeri

number

resourceFiles

Komut satırını çalıştırmadan önce Batch hizmetinin İşlem Düğümüne indireceği dosyaların listesi. Bu öğe altında listelenen dosyalar Görevin çalışma dizininde bulunur. Kaynak dosyaları listesi için en büyük boyut vardır. En büyük boyut aşıldığında istek başarısız olur ve yanıt hata kodu RequestEntityTooLarge olur. Bu durumda ResourceFiles koleksiyonunun boyutu azaltılmalıdır. Bu, .zip dosyaları, Uygulama Paketleri veya Docker Kapsayıcıları kullanılarak elde edilebilir.

resourceFiles?: ResourceFile[]

Özellik Değeri

ResourceFile[]

runExclusive

İş Yöneticisi Görevinin çalıştığı İşlem Düğümü'ne özel kullanım gerekip gerekmediği. True ise, İş Yöneticisi çalıştığı sürece aynı Düğümde başka hiçbir Görev çalışmaz. False ise, diğer Görevler bir İşlem Düğümündeki İş Yöneticisi ile aynı anda çalıştırılabilir. İş Yöneticisi Görevi normalde İşlem Düğümü'nin eş zamanlı Görev sınırına göre sayılır, bu nedenle bu yalnızca İşlem Düğümü birden çok eşzamanlı Göreve izin veriyorsa geçerlidir. Varsayılan değer true değeridir.

runExclusive?: boolean

Özellik Değeri

boolean

userIdentity

İş Yöneticisi Görevinin altında çalıştığı kullanıcı kimliği. Atlanırsa, Görev, Göreve özgü yönetici olmayan bir kullanıcı olarak çalışır.

userIdentity?: UserIdentity

Özellik Değeri

UserIdentity