Batch kaynaklarını Azure CLI ile yönetme
Azure Batch hesaplarınızı ve kaynaklarınızı Azure Komut Satırı Arabirimi'ni (Azure CLI) kullanarak yönetebilirsiniz. Havuzlar, işler ve görevler gibi Batch kaynaklarını oluşturmaya ve güncelleştirmeye yönelik komutlar vardır. Batch API'leri, PowerShell cmdlet'leri ve Azure portalı aracılığıyla gerçekleştirdiğiniz görevlerin birçoğu için betikler de oluşturabilirsiniz.
Azure CLI'yi Azure Cloud Shell'de çalıştırabilir veya Azure CLI'yi yerel olarak yükleyebilirsiniz. Sürümler Windows, Mac ve Linux işletim sistemlerinde (OS) kullanılabilir.
Bu makalede, Batch hesapları ve kaynaklarıyla Azure CLI'nin nasıl kullanılacağı açıklanmaktadır.
Azure CLI'yı ayarlama
Azure CLI'yı nasıl ayarlamak istediğinizi seçin:
- Cloud Shell'de Azure CLI'yi çalıştırın.
- Azure CLI'yi yerel olarak yükleyin.
- Azure CLI'yi Windows'a yükleme
- macOS'ta Azure CLI'yi yükleme
- Birden çok Linux dağıtımı için Linux üzerinde Azure CLI'yi yükleyin.
Azure CLI'yı kullanmaya yeni başladıysanız devam etmeden önce bkz . Azure CLI ile çalışmaya başlama.
Azure CLI'yi daha önce yerel olarak yüklediyseniz yüklemenizi en son sürüme güncelleştirdiğinizden emin olun.
Azure CLI ile kimlik doğrulaması
Azure CLI'yı Batch ile kullanmak için önce Azure hesabınızda oturum açın, ardından Batch hesabınızda oturum açın.
Azure hesabında oturum açma
Azure CLI'yı kullanmak için önce Azure hesabınızda oturum açın. Bu adım, Batch Management hizmet komutlarını içeren Azure Resource Manager komutlarına erişmenizi sağlar. Ardından Batch hesaplarını, anahtarları, uygulama paketlerini ve kotaları yönetmek için komutlar çalıştırabilirsiniz.
Azure CLI'da Azure hesabınızın kimliğini iki şekilde doğrulayabilirsiniz. Komutları kendiniz çalıştırmak için Azure CLI'da etkileşimli olarak oturum açın. Azure CLI kimlik bilgilerinizi önbelleğe alır ve bundan sonra Batch hesabınızda oturum açmak için aynı kimlik bilgilerini kullanabilir. Bir betikten veya uygulamadan komut çalıştırmak için Azure CLI'da hizmet sorumlusuyla oturum açın.
Azure CLI'da etkileşimli olarak oturum açmak için komutunu çalıştırınaz login:
az login
Batch hesabında oturum açma
Ardından az batch account login komutunu kullanarak Azure CLI'da Batch hesabınızda oturum açın . Bu adım Batch hizmeti komutlarına erişmenizi sağlar. Ardından havuzlar, işler ve görevler gibi Batch kaynaklarını yönetebilirsiniz.
Azure CLI'da Batch hesabınızın kimliğini iki şekilde doğrulayabilirsiniz. Varsayılan yöntem, Microsoft Entra Id kullanarak kimlik doğrulaması yapmaktır. Çoğu senaryoda bu yöntemi kullanmanızı öneririz. Bir diğer seçenek de Paylaşılan Anahtar kimlik doğrulamasını kullanmaktır.
Batch komutlarını otomatikleştirmek için Azure CLI betikleri oluşturuyorsanız, iki kimlik doğrulama yöntemini de kullanabilirsiniz. Bazı senaryolarda Paylaşılan Anahtar kimlik doğrulaması, hizmet sorumlusu oluşturmaktan daha basit olabilir.
Microsoft Entra ID ile kimlik doğrulaması
Batch hesabınızla kimlik doğrulaması için varsayılan yöntem Microsoft Entra Id'dir. Azure CLI'da etkileşimli olarak veya bir hizmet sorumlusuyla oturum açtığınızda, Batch hesabınızda Microsoft Entra Id ile oturum açmak için aynı önbelleğe alınmış kimlik bilgilerini kullanabilirsiniz. Bu kimlik doğrulama yöntemi ayrıca Azure rol tabanlı erişim denetimi (Azure RBAC) sunar. Azure RBAC ile kullanıcı erişimi hesap anahtarlarına değil, atanan rolüne bağlıdır. Hesap anahtarlarını değil yalnızca Azure rollerini yönetmeniz gerekir. Microsoft Entra Id daha sonra erişim ve kimlik doğrulama işlemlerini işler.
Batch hesabınızda Microsoft Entra Id ile oturum açmak için komutunu çalıştırın az batch login. Batch hesabınızın adı ( ) ve kaynak grubunuzun adı (-n-g) için gerekli parametreleri eklediğinizden emin olun.
az batch account login -g <your-resource-group> -n <your-batch-account>
Paylaşılan Anahtarla Kimlik Doğrulaması
Batch hesabınızda oturum açmak için Paylaşılan Anahtar kimlik doğrulamasını da kullanabilirsiniz. Bu yöntem, Batch hizmeti için Azure CLI komutlarının kimliğini doğrulamak için hesap erişim anahtarlarınızı kullanır.
Paylaşılan Anahtar kimlik doğrulaması ile Batch hesabınızda oturum açmak için parametresiyle --shared-key-authkomutunu çalıştırınaz batch login. Batch hesabınızın adı ( ) ve kaynak grubunuzun adı (-n-g) için gerekli parametreleri eklediğinizden emin olun.
az batch account login -g <your-resource-group> -n <your-batch-account> --shared-key-auth
Batch komutlarını öğrenme
Azure CLI başvuru belgelerinde Batch için tüm Azure CLI komutları listelenir.
Azure CLI'daki tüm Batch komutlarını listelemek için komutunu çalıştırın az batch -h.
Yaygın Batch görevleri için birden çok örnek CLI betikleri vardır. Bu örneklerde, Azure CLI'da Batch için birçok kullanılabilir komutun nasıl kullanılacağı gösterilmektedir. Batch hesaplarını, havuzlarını, işlerini ve görevlerini oluşturmayı ve yönetmeyi öğrenebilirsiniz.
Batch CLI uzantısı komutlarını kullanma
Batch IŞLERINI kod yazmadan çalıştırmak için Batch CLI uzantısını kullanabilirsiniz. Uzantı, Azure CLI ile havuzlar, işler ve görevler oluşturmak için JSON şablonlarını kullanmaya yönelik komutlar sağlar. Uzantı, Batch hesabınıza bağlı bir Azure Depolama hesabına bağlanmaya yönelik komutlar da sağlar. Ardından, iş giriş dosyalarını karşıya yükleyebilir ve iş giriş dosyalarını indirebilirsiniz.
JSON ile kaynak oluşturma
Batch kaynaklarının çoğunu yalnızca komut satırı parametrelerini kullanarak oluşturabilirsiniz. Bazı özellikler için bunun yerine bir JSON yapılandırma dosyası belirtmeniz gerekir. JSON dosyası, yeni kaynağınızın yapılandırma ayrıntılarını içerir. Örneğin, bir başlangıç görevi için kaynak dosyaları belirtmek üzere bir JSON dosyası kullanmanız gerekir.
Örneğin, yeni bir Batch havuzu kaynağı yapılandırmak için bir JSON dosyası kullanmak için:
az batch pool <your-batch-pool-configuration>.json
Yeni bir kaynak için bir JSON dosyası belirttiğinizde, komutunuzda başka parametreler kullanmayın. Hizmet, kaynağı yapılandırmak için yalnızca JSON dosyasını kullanır.
Batch REST API başvuru belgelerinde kaynak oluşturmak için gereken JSON söz dizimi listelenir.
Kaynak oluşturmak için gereken JSON söz dizimi dosyasını bulmak üzere Batch REST API başvurusu belgelerine bakın. Kaynak işleminin başvuru sayfasındaki Örnekler bölümüne gidin. Ardından Kaynak türü> ekle <başlıklı alt bölümü bulun. Örneğin, Temel görev ekleyin. Örnek JSON kodunu yapılandırma dosyalarınız için şablon olarak kullanın.
Bir JSON dosyasını belirten örnek bir betik için bkz. Batch ile bir iş ve görevlerini çalıştırma.
Batch kaynaklarını verimli bir şekilde sorgulama
Komutunu kullanarak list Batch hesabınızı sorgulayabilir ve tüm kaynakları listeleyebilirsiniz. Örneğin, hesabınızdaki havuzları ve bir işteki görevleri listelemek için:
az batch pool list
az batch task list --job-id <your-job-id>
Batch sorgunuzun döndürdüğü veri miktarını sınırlamak için bir OData yan tümcesi belirtin. Tüm filtrelemeler sunucu tarafında gerçekleşir, bu nedenle yalnızca istediğiniz verileri alırsınız. İşlemlerle list bant genişliğinden ve zamandan tasarruf etmek için bu OData yan tümcelerini kullanın. Daha fazla bilgi için bkz . Batch kaynakları için verimli liste sorguları tasarlama.
| Yan Tümce | Tanım |
|---|---|
--select-clause [select-clause] |
Her varlık için bir özellik alt kümesi döndürür. |
--filter-clause [filter-clause] |
Yalnızca belirtilen OData ifadesiyle eşleşen varlıklar döndürür. |
--expand-clause [expand-clause] |
Tek bir temel alınan REST çağrısındaki varlık bilgilerini alır. Expand yan tümcesi şu anda yalnızca stats özelliğini desteklemektedir. |
Bu yan tümcelerin nasıl kullanılacağını gösteren örnek bir betik için bkz . Batch ile iş ve görevler çalıştırma.
Sorun giderme
Herhangi bir Batch komutuyla ilgili yardım almak için komutunuzun sonuna ekleyin -h . Başka seçenekler eklemeyin. Örneğin, Batch hesabı oluşturma konusunda yardım almak için komutunu çalıştırın az batch account create -h.
Ayrıntılı komut çıktısı döndürmek için, komutunuzun sonuna veya -vv ekleyin-v. Hata çıkışının tamamını görüntülemek için bu anahtarları kullanın. -vv bayrağı gerçek REST isteklerini ve yanıtlarını döndürür.
Komut çıkışını JSON biçiminde görüntülemek için komutunuzun sonuna ekleyin --json . Örneğin, pool001 adlı havuzun özelliklerini görüntülemek için komutunu çalıştırınaz batch pool show pool001 --json. Ardından, JSON yapılandırma dosyasını kullanarak Batch kaynakları oluşturmak için çıktıyı kopyalayın ve değiştirin.
Genel Azure CLI sorunlarını giderme
Azure CLI çeşitli kabuk ortamlarında çalışabilir, ancak hafif biçim çeşitlemeleriyle. Azure CLI komutlarıyla ilgili beklenmeyen sonuçlara sahipseniz bkz . Azure CLI'yi başarıyla kullanma.