Memperbarui properti kumpulan Batch

Saat membuat kumpulan Azure Batch, Anda menentukan properti tertentu yang menentukan konfigurasi kumpulan. Contohnya termasuk menentukan ukuran VM, gambar VM yang akan digunakan, konfigurasi jaringan virtual, dan pengaturan enkripsi. Namun, Anda mungkin perlu memperbarui properti kumpulan saat beban kerja Anda berkembang dari waktu ke waktu atau jika gambar VM mencapai akhir masa pakai.

Beberapa, tetapi tidak semua, properti kolam ini dapat diperbaiki atau diperbarui untuk mengakomodasi situasi ini. Artikel ini menyediakan informasi tentang properti kumpulan yang dapat diperbarui, perilaku yang diharapkan untuk pembaruan properti kumpulan, dan contoh.

Tip

Beberapa properti kumpulan hanya dapat diperbarui menggunakan Batch Management Plane API atau SDK dengan autentikasi Entra. Anda harus menginstal atau menggunakan API atau SDK yang sesuai agar operasi ini tersedia.

Properti kumpulan yang dapat diperbarui

Batch menyediakan beberapa metode untuk memperbarui properti pada kumpulan. Memilih API mana yang akan digunakan menentukan kumpulan properti kumpulan yang dapat diperbarui serta perilaku pembaruan.

Catatan

Jika Anda ingin memperbarui properti kumpulan yang bukan bagian dari API Pembaruan atau Patch berikut, maka Anda harus membuat ulang kumpulan untuk mencerminkan status yang diinginkan.

Tingkat Manajemen: Kumpulan - Pembaruan

Jalur yang direkomendasikan untuk memperbarui properti kolam dengan menggunakan Pool - Update API sebagai bagian dari API atau SDK Bidang Manajemen Batch. API ini menyediakan cara paling komprehensif dan fleksibel untuk memperbarui properti kumpulan. Menggunakan API ini memungkinkan pembaruan selektif untuk properti kumpulan hanya pada bidang Manajemen dan kemampuan untuk memperbarui properti lain yang sebaliknya tidak dapat diubah melalui API Data Plane.

Penting

Anda harus menggunakan API versi 2024-07-01 atau yang lebih baru dari API Sarana Manajemen Batch untuk memperbarui properti kumpulan seperti yang dijelaskan di bagian ini.

Karena operasi ini adalah PATCH, hanya properti kumpulan yang ditentukan dalam permintaan yang diperbarui. Jika properti tidak ditentukan sebagai bagian dari permintaan, maka nilai yang ada tetap tidak dimodifikasi.

Beberapa properti hanya dapat diperbarui ketika kumpulan tidak memiliki simpul aktif di dalamnya atau di mana jumlah total simpul komputasi di kumpulan adalah nol. Properti yang tidak mengharuskan kumpulan berukuran nol agar nilai baru berlaku adalah:

  • paket aplikasi
  • sertifikat
  • metadata
  • pengaturan skala
  • mulaiTugas

Jika ada simpul aktif saat kumpulan diperbarui dengan properti ini, boot ulang simpul komputasi aktif mungkin diperlukan agar perubahan diterapkan. Untuk informasi selengkapnya, lihat dokumentasi untuk setiap properti kumpulan individual.

Semua properti kumpulan lain yang dapat diperbarui mengharuskan kumpulan memiliki ukuran nol simpul agar dapat diterima sebagai bagian dari permintaan pembaruan.

Misalnya, perubahan pada vmSize, deploymentConfiguration, diskEncryptionConfiguration, atau securityProfile mengharuskan pool berada dalam status alokasi Steady dengan nol node dedicated dan Spot atau prioritas rendah. Saat Anda mengubah ukuran pool setelah pembaruan, Batch membuat deployment komputasi dasar baru dengan menggunakan konfigurasi yang diperbarui.

Anda juga dapat menggunakan Pool - Create API untuk memperbarui properti pilihan ini, tetapi karena operasinya adalah PUT, permintaan sepenuhnya menggantikan semua properti yang ada. Oleh karena itu, properti apa pun yang tidak ditentukan dalam permintaan dihapus atau diatur dengan default terkait.

Contoh: Memperbarui Spesifikasi Gambar VM

Contoh berikut menunjukkan cara memperbarui konfigurasi gambar VM kumpulan melalui Management Plane C# SDK:

public async Task UpdatePoolVmImage()
{
     // Authenticate
     var clientId = Environment.GetEnvironmentVariable("CLIENT_ID");
     var clientSecret = Environment.GetEnvironmentVariable("CLIENT_SECRET");
     var tenantId = Environment.GetEnvironmentVariable("TENANT_ID");
     var subscriptionId = Environment.GetEnvironmentVariable("SUBSCRIPTION_ID");
     ClientSecretCredential credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
     ArmClient client = new ArmClient(credential, subscriptionId);

     // Get an existing Batch account
     string resourceGroupName = "<resourcegroup>";
     string accountName = "<batchaccount>";
     ResourceIdentifier batchAccountResourceId = BatchAccountResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName);
     BatchAccountResource batchAccount = client.GetBatchAccountResource(batchAccountResourceId);

     // get the collection of this BatchAccountPoolResource
     BatchAccountPoolCollection collection = batchAccount.GetBatchAccountPools();

     // Update the pool
     string poolName = "mypool";
     BatchAccountPoolData data = new BatchAccountPoolData()
     {
         DeploymentConfiguration = new BatchDeploymentConfiguration()
         {
             VmConfiguration = new BatchVmConfiguration(new BatchImageReference()
             {
                 Publisher = "MicrosoftWindowsServer",
                 Offer = "WindowsServer",
                 Sku = "2022-datacenter-azure-edition-smalldisk",
                 Version = "latest",
             },
             nodeAgentSkuId: "batch.node.windows amd64"),
         },
     };

     ArmOperation<BatchAccountPoolResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, poolName, data);
     BatchAccountPoolResource result = lro.Value;

     BatchAccountPoolData resourceData = result.Data;
     Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Contoh: Memperbarui Ukuran VM dan Mode Komunikasi Simpul Target

Contoh berikut menunjukkan cara memperbarui ukuran gambar VM kumpulan dan mode komunikasi simpul target untuk disederhanakan melalui REST API:

PATCH https://management.azure.com/subscriptions/<subscriptionid>/resourceGroups/<resourcegroupName>/providers/Microsoft.Batch/batchAccounts/<batchaccountname>/pools/<poolname>?api-version=2024-07-01

Isi Permintaan

{
    "type": "Microsoft.Batch/batchAccounts/pools",
    "parameters": {
        "properties": {
            "vmSize": "standard_d32ads_v5",
            "targetNodeCommunicationMode": "simplified"
        }
    }
}

Contoh: Migrasi dari Azure Disk Encryption ke enkripsi di host

Azure Disk Encryption untuk Batch pools akan pensiun pada 15 September 2028. Jika sebuah pool dapat menggunakan Azure Disk Encryption untuk enkripsi disk sementara, ubah ukuran pool menjadi nol node dan tunggu status alokasinya menjadi Steady. Kemudian gunakan versi 2024-07-01 API atau versi yang lebih baru untuk memilih ukuran VM yang didukung, jika perlu, dan atur securityProfile.encryptionAtHost ke true.

Setelah pembaruan, ubah ukuran pool ke jumlah node target yang diperlukan. Batch membuat deployment komputasi yang mendasari baru dengan enkripsi di host diaktifkan. Untuk prosedur migrasi lengkap dan contoh permintaan, lihat Migrasikan pool yang sudah ada ke enkripsi di host.

Sarana Data: Kumpulan - Patch atau Perbarui Properti

Data Plane menawarkan kemampuan untuk melakukan patch atau memperbarui properti kumpulan tertentu. API yang tersedia adalah API Pool - Memperbarui Properti sebagai bagian dari API Bidang Data Batch atau SDK.

API Pembaruan Properti memungkinkan pembaruan terpilih dari properti kumpulan sesuai dengan yang ditentukan dalam dokumentasi. Permintaan ini sepenuhnya menggantikan properti yang ada, oleh karena itu properti apa pun yang tidak ditentukan dalam permintaan dihapus.

Simpul komputasi harus di-boot ulang agar perubahan berlaku untuk properti berikut:

  • applicationPackageReferences
  • certificateReferences
  • mulaiTugas

Ukuran grup harus diatur ulang menjadi nol simpul aktif untuk pembaruan properti targetNodeCommunicationMode.

Tanya Jawab Umum

  • Apakah saya perlu melakukan operasi lain setelah memperbarui properti kumpulan ketika kumpulan tersebut memiliki simpul aktif?

Ya, untuk properti kumpulan yang dapat diperbarui dengan simpul aktif, ada properti pilih yang mengharuskan simpul komputasi di-boot ulang. Atau, kumpulan bisa diskalakan ke simpul nol untuk mencerminkan properti yang dimodifikasi.

  • Bisakah saya mengubah kumpulan identitas terkelola pada pool saat pool memiliki simpul yang aktif?

Ya, tapi anda tidak harus. Meskipun Batch tidak melarang perubahan koleksi dengan simpul yang aktif, kami menyarankan untuk menghindari melakukannya karena dapat menyebabkan ketidakkonsistensian dalam koleksi identitas jika kumpulan diperluas. Kami menyarankan untuk hanya memperbarui properti ini ketika ukuran kumpulan adalah nol. Untuk informasi selengkapnya, lihat artikel Mengonfigurasi identitas terkelola.

Langkah berikutnya

  • Terakhir diperbarui pada