BatchJobPreparationTaskOutput interface

Paket:

@azure-rest/batch

Belirli bir İşlem Düğümünde işin herhangi bir Görevinden önce çalıştırılacak bir İş Hazırlama Görevi. İş için Görevleri çalıştırmak üzere bir Düğüm hazırlamak için İş Hazırlığı'nı kullanabilirsiniz. İş Hazırlama'da yaygın olarak gerçekleştirilen etkinlikler şunlardır: İşteki tüm Görevler tarafından kullanılan ortak kaynak dosyalarını indirme. İş Hazırlama Görevi bu yaygın kaynak dosyalarını Düğümdeki paylaşılan konuma indirebilir. (AZ_BATCH_NODE_ROOT_DIR\shared) veya Düğümde yerel bir hizmet başlatarak bu İşin tüm Görevlerinin onunla iletişim kurabilmesini sağlayın. İş Hazırlama Görevi başarısız olursa (yani, çıkış kodu 0 ile çıkmadan önce yeniden deneme sayısını tüketirse), Batch Bu İşin Görevlerini Düğümde çalıştırmaz. İşlem Düğümü, yeniden tasarlanana kadar bu İşin Görevlerini çalıştırmak için uygun değildir. İşlem Düğümü etkin kalır ve diğer İşler için kullanılabilir. İş Hazırlama Görevi aynı Düğümde birden çok kez çalıştırılabilir. Bu nedenle, yeniden yürütmeyi işlemek için İş Hazırlama Görevi'ni yazmanız gerekir. Düğüm yeniden başlatılırsa, yeniden çalıştırOnNodeRebootAfterSuccess doğruysa veya İş Hazırlama Görevi daha önce tamamlanmamışsa, İşin başka bir Görevi zamanlanmadan önce İşlem Düğümünde İş Hazırlama Görevi yeniden çalıştırılır. Düğüm yeniden oluşturulursa, İşin herhangi bir Görevi zamanlanmadan önce İş Hazırlama Görevi yeniden çalıştırılı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

commandLine	İş Hazırlama 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	İş Hazırlama Görevine uygulanan kısıtlamalar.
containerSettings	İş Hazırlama Görevinin çalıştığı kapsayıcının ayarları. 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.
environmentSettings	İş Hazırlama Görevi için ortam değişkeni ayarlarının listesi.
id	İş içindeki İş Hazırlama 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. Bu özelliği belirtmezseniz, Batch hizmeti 'jobpreparation' varsayılan değerini atar. İş'teki başka hiçbir Görev, İş Hazırlama Görevi ile aynı kimlikte olamaz. Aynı kimlikle bir Görev göndermeye çalışırsanız, Batch hizmeti isteği TaskIdSameAsJobPreparationTask hata koduyla reddeder; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 409 (Çakışma) olur.
rerunOnNodeRebootAfterSuccess	İşlem Düğümü yeniden başlatıldıktan sonra Batch hizmetinin İş Hazırlama Görevini yeniden çalıştırıp çalıştırmaması. bir İşlem Düğümü yeniden oluşturulduysa veya İş Hazırlama Görevi tamamlanmadıysa (örneğin, Görev çalışırken yeniden başlatma gerçekleştiğinden) İş Hazırlama Görevi her zaman yeniden çalıştırılır. Bu nedenle, her zaman bir İş Hazırlama Görevi yazmanız ve birden çok kez çalıştırıldığında doğru şekilde davranmanız gerekir. Varsayılan değer true değeridir.
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.
userIdentity	İş Hazırlama Görevinin çalıştığı kullanıcı kimliği. Atlanırsa, Görev, Windows İşlem Düğümleri'nde Görev'e özgü bir yönetici olmayan kullanıcı veya Linux İşlem Düğümleri'nde Havuza özgü yönetici olmayan bir kullanıcı olarak çalışır.
waitForSuccess	Batch hizmetinin İşlem Düğümünde İşin diğer Görevlerini zamanlamadan önce İş Hazırlama Görevinin başarıyla tamamlanmasını beklemesi gerekip gerekmediği. Bir İş Hazırlama Görevi, çıkış kodu 0 ile çıkarsa başarıyla tamamlanır. True ise ve Bir Düğümde İş Hazırlama Görevi başarısız olursa, Batch hizmeti İş Hazırlama Görevi'ni en yüksek yeniden deneme sayısına kadar (constraints öğesinde belirtildiği gibi) yeniden dener. Tüm yeniden denemelerden sonra Görev hala başarıyla tamamlanmamışsa, Batch hizmeti İşin Görevlerini Düğüme zamanlamaz. Düğüm etkin kalır ve diğer İşlerin Görevlerini çalıştırmaya uygun kalır. Yanlışsa, Batch hizmeti İş Hazırlama Görevinin tamamlanmasını beklemez. Bu durumda, İş Hazırlama Görevi çalışmaya devam ederken İşin diğer Görevleri İşlem Düğümünde yürütülmeye başlayabilir; ve İş Hazırlama Görevi başarısız olsa bile, yeni Görevler İşlem Düğümünde zamanlamaya devam eder. Varsayılan değer true değeridir.

Özellik Ayrıntıları

commandLine

İş Hazırlama 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

İş Hazırlama Görevine uygulanan kısıtlamalar.

constraints?: BatchTaskConstraintsOutput

Özellik Değeri

BatchTaskConstraintsOutput

containerSettings

İş Hazırlama Görevinin çalıştığı kapsayıcının ayarları. 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?: BatchTaskContainerSettingsOutput

Özellik Değeri

BatchTaskContainerSettingsOutput

environmentSettings

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

environmentSettings?: EnvironmentSettingOutput[]

Özellik Değeri

EnvironmentSettingOutput[]

id

İş içindeki İş Hazırlama 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. Bu özelliği belirtmezseniz, Batch hizmeti 'jobpreparation' varsayılan değerini atar. İş'teki başka hiçbir Görev, İş Hazırlama Görevi ile aynı kimlikte olamaz. Aynı kimlikle bir Görev göndermeye çalışırsanız, Batch hizmeti isteği TaskIdSameAsJobPreparationTask hata koduyla reddeder; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 409 (Çakışma) olur.

id?: string

Özellik Değeri

string

rerunOnNodeRebootAfterSuccess

İşlem Düğümü yeniden başlatıldıktan sonra Batch hizmetinin İş Hazırlama Görevini yeniden çalıştırıp çalıştırmaması. bir İşlem Düğümü yeniden oluşturulduysa veya İş Hazırlama Görevi tamamlanmadıysa (örneğin, Görev çalışırken yeniden başlatma gerçekleştiğinden) İş Hazırlama Görevi her zaman yeniden çalıştırılır. Bu nedenle, her zaman bir İş Hazırlama Görevi yazmanız ve birden çok kez çalıştırıldığında doğru şekilde davranmanız gerekir. Varsayılan değer true değeridir.

rerunOnNodeRebootAfterSuccess?: boolean

Özellik Değeri

boolean

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?: ResourceFileOutput[]

Özellik Değeri

ResourceFileOutput[]

userIdentity

İş Hazırlama Görevinin çalıştığı kullanıcı kimliği. Atlanırsa, Görev, Windows İşlem Düğümleri'nde Görev'e özgü bir yönetici olmayan kullanıcı veya Linux İşlem Düğümleri'nde Havuza özgü yönetici olmayan bir kullanıcı olarak çalışır.

userIdentity?: UserIdentityOutput

Özellik Değeri

UserIdentityOutput

waitForSuccess

Batch hizmetinin İşlem Düğümünde İşin diğer Görevlerini zamanlamadan önce İş Hazırlama Görevinin başarıyla tamamlanmasını beklemesi gerekip gerekmediği. Bir İş Hazırlama Görevi, çıkış kodu 0 ile çıkarsa başarıyla tamamlanır. True ise ve Bir Düğümde İş Hazırlama Görevi başarısız olursa, Batch hizmeti İş Hazırlama Görevi'ni en yüksek yeniden deneme sayısına kadar (constraints öğesinde belirtildiği gibi) yeniden dener. Tüm yeniden denemelerden sonra Görev hala başarıyla tamamlanmamışsa, Batch hizmeti İşin Görevlerini Düğüme zamanlamaz. Düğüm etkin kalır ve diğer İşlerin Görevlerini çalıştırmaya uygun kalır. Yanlışsa, Batch hizmeti İş Hazırlama Görevinin tamamlanmasını beklemez. Bu durumda, İş Hazırlama Görevi çalışmaya devam ederken İşin diğer Görevleri İşlem Düğümünde yürütülmeye başlayabilir; ve İş Hazırlama Görevi başarısız olsa bile, yeni Görevler İşlem Düğümünde zamanlamaya devam eder. Varsayılan değer true değeridir.

waitForSuccess?: boolean

Özellik Değeri

boolean