Membuat kumpulan simpul untuk kluster di Azure Kubernetes Service (AKS)

Artikel ini memperlihatkan kepada Anda cara membuat satu atau beberapa kumpulan simpul di kluster AKS.

Catatan

Fitur ini memungkinkan kontrol lebih atas pembuatan dan pengelolaan beberapa kumpulan simpul dan memerlukan perintah terpisah untuk operasi buat/perbarui/hapus (CRUD). Sebelumnya, operasi kluster melalui az aks create atau az aks update menggunakan API managedCluster dan merupakan satu-satunya opsi untuk mengubah control plane dan node pool Anda. Fitur ini mengekspos satu set operasi terpisah untuk pool agen melalui agentPool API dan memerlukan penggunaan perintah set az aks nodepool untuk menjalankan operasi pada pool node individual.

Penting

Mulai November 30, 2025, Azure Kubernetes Service (AKS) tidak lagi mendukung atau menyediakan pembaruan keamanan untuk Azure Linux 2.0. Gambar node Linux 2.0 Azure dibekukan pada rilis 202512.06.0. Mulai tanggal 31 Maret 2026, gambar simpul akan dihapus, dan Anda tidak akan dapat menskalakan kumpulan simpul Anda. Migrasikan ke versi Linux Azure yang didukung dengan meningkatkan kumpulan simpul Anda ke versi Kubernetes yang didukung atau bermigrasi ke osSku AzureLinux3. Untuk informasi selengkapnya, lihat masalah GitHub Retirement dan pengumuman penghentian pembaruan Azure. Untuk tetap mendapatkan informasi tentang pengumuman dan pembaruan, ikuti catatan rilis AKS.

Prasyarat

  • Anda memerlukan Azure CLI versi 2.2.0 atau yang lebih baru yang diinstal dan dikonfigurasi. Jalankan az --version untuk menemukan versinya. Jika Anda perlu menginstal atau meningkatkan, lihat Install Azure CLI.

  • Untuk menyebarkan templat ARM, Anda memerlukan akses tulis pada sumber daya yang Anda sebarkan dan akses ke semua operasi pada jenis sumber daya Microsoft.Resources/deployments. Misalnya, untuk menyebarkan komputer virtual (VM), Anda memerlukan izin Microsoft.Compute/virtualMachines/write dan Microsoft.Resources/deployments/*. Untuk daftar peran dan izin, lihat peran bawaan Azure.

  • Tinjau persyaratan berikut untuk setiap parameter:

    • osTYPE: Jenis sistem operasi. Defaultnya adalah Linux.
    • osSKU: Menentukan SKU OS yang digunakan oleh kumpulan agen.
    • count: Jumlah agen (VM) untuk menghosting kontainer docker. Nilai yang diizinkan harus dalam rentang 0 hingga 1000 (inklusif) untuk kumpulan pengguna dan dalam rentang 1 hingga 1000 (inklusif) untuk kumpulan sistem. Nilai defaultnya adalah 1.

  • Setelah menyebarkan kluster menggunakan templat ARM, Anda dapat menggunakan Azure CLI atau Azure PowerShell untuk menyambungkan ke kluster dan menyebarkan aplikasi sampel.

Batasan

Batasan berikut berlaku saat Anda membuat kluster AKS yang mendukung beberapa kumpulan simpul:

  • Anda dapat menghapus kumpulan simpul sistem jika Anda memiliki kumpulan simpul sistem lain untuk menggantikannya di kluster AKS. Jika tidak, Anda tidak dapat menghapus kumpulan simpul sistem.

  • Kumpulan sistem harus berisi setidaknya satu simpul. Node pool pengguna dapat berisi nol atau lebih node.

  • Jika Anda membuat kluster dengan kumpulan simpul tunggal, jenis OS harus Linux. SKU OS dapat berupa variasi Linux apa pun seperti Ubuntu atau AzureLinux. Anda tidak dapat membuat kluster dengan satu kumpulan simpul Windows. Jika Anda ingin menjalankan kontainer Windows, Anda harus tambahkan kumpulan simpul Windows ke kluster setelah membuatnya dengan kumpulan simpul sistem Linux.

  • Kluster AKS harus menggunakan load balancer SKU Standard untuk menggunakan beberapa pool node. Fitur ini tidak didukung dengan load balancer SKU Dasar.

  • Kluster AKS harus menggunakan Virtual Machine Scale Sets sebagai node.

  • Nama kumpulan simpul hanya dapat berisi karakter alfanumerik huruf kecil dan harus dimulai dengan huruf kecil.

    • Untuk kumpulan simpul Linux, panjangnya harus antara 1-12 karakter.
    • Untuk kumpulan simpul Windows, panjangnya harus antara 1-6 karakter.

  • Semua kumpulan simpul harus berada di jaringan virtual yang sama.

  • Anda tidak dapat mengubah ukuran komputer virtual (VM) kumpulan simpul setelah membuatnya.

  • Saat Anda membuat beberapa kumpulan simpul pada waktu pembuatan kluster, versi Kubernetes untuk kumpulan simpul harus cocok dengan versi yang ditetapkan untuk sarana kontrol. Anda dapat membuat pembaruan setelah memprovisikan kluster menggunakan operasi kumpulan per simpul.

Membuat kumpulan simpul khusus

Untuk mempelajari cara membuat kumpulan simpul khusus, lihat artikel berikut ini:

Atur variabel lingkungan

  • Atur variabel lingkungan berikut di shell Anda untuk menyederhanakan perintah dalam artikel ini. Anda dapat mengubah nilai menjadi nama pilihan Anda.

    export RESOURCE_GROUP_NAME="my-aks-rg"
export LOCATION="eastus"
export CLUSTER_NAME="my-aks-cluster"
export NODE_POOL_NAME="mynodepool"

Membuat grup sumber daya

  • Buat grup sumber daya Azure menggunakan perintah az group create.

    az group create --name $RESOURCE_GROUP_NAME --location $LOCATION

Membuat kluster AKS dengan kumpulan simpul tunggal menggunakan Azure CLI

Jika Anda hanya menginginkan satu kumpulan simpul di kluster AKS, Anda dapat menjadwalkan pod aplikasi pada kumpulan simpul sistem. Jika Anda menjalankan satu kumpulan simpul sistem untuk kluster AKS Anda di lingkungan produksi, kami sarankan Anda menggunakan setidaknya tiga sumpul untuk kumpulan simpul tersebut. Jika satu simpul gagal, redundansi terganggu. Anda dapat mengurangi risiko ini dengan memiliki lebih banyak node dalam kumpulan node sistem.

  1. Buat kluster dengan satu pool node Ubuntu menggunakan perintah az aks create. Langkah ini menentukan dua simpul dalam kumpulan simpul tunggal.

    az aks create \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $CLUSTER_NAME \
    --vm-set-type VirtualMachineScaleSets \
    --node-count 2 \
    --os-sku Ubuntu \
    --location $LOCATION \
    --load-balancer-sku standard \
    --generate-ssh-keys

    Perlu waktu beberapa menit untuk membuat kluster tersebut.

  2. Ketika kluster siap, dapatkan kredensial kluster menggunakan az aks get-credentials perintah .

    az aks get-credentials --resource-group $RESOURCE_GROUP_NAME --name $CLUSTER_NAME

Menambahkan kumpulan simpul kedua menggunakan Azure CLI

Kluster yang dibuat di bagian sebelumnya memiliki kumpulan simpul tunggal. Di bagian ini, kami menambahkan kumpulan simpul kedua ke kluster. Kumpulan simpul kedua ini dapat memiliki jenis OS Linux dengan SKU OS Ubuntu atau AzureLinux, atau jenis OS Windows.

Catatan

Jika Anda ingin menambahkan pool node yang menggunakan disk OS Ephemeral ke kluster AKS, Anda dapat mengatur --node-osdisk-type bendera ke Ephemeral saat menjalankan perintah az aks nodepool add.

Dengan OS Ephemeral, Anda dapat menyebarkan VM dan gambar instans hingga ukuran cache VM. Konfigurasi disk OS simpul default di AKS menggunakan 128 GB, yang berarti Anda memerlukan ukuran VM yang memiliki cache yang lebih besar dari 128 GB. Defaultnya Standard_DS2_v2 memiliki ukuran cache 86 GB, yang tidak cukup besar. Standard_DS3_v2 VM SKU memiliki ukuran cache 172 GB, yang cukup besar. Anda juga dapat mengurangi ukuran default disk OS menggunakan --node-osdisk-size, tetapi perlu diingat ukuran minimum untuk gambar AKS adalah 30 GB.

Jika Anda ingin membuat kumpulan simpul dengan disk OS yang terhubung ke jaringan, Anda dapat mengatur --node-osdisk-type flag ke Managed saat menjalankan az aks nodepool add perintah.

Menambahkan kumpulan simpul Linux

  • Buat kumpulan simpul baru menggunakan az aks nodepool add perintah . Contoh berikut membuat kumpulan node Linux dengan SKU OS Ubuntu yang mengoperasikan tiga node. Jika Anda tidak menentukan SKU OS, AKS secara otomatis menggunakan default Ubuntu.

    az aks nodepool add \
    --resource-group $RESOURCE_GROUP_NAME \
    --cluster-name $CLUSTER_NAME \
    --name $NODE_POOL_NAME \
    --node-vm-size Standard_DS2_v2 \
    --os-type Linux \
    --os-sku Ubuntu \
    --node-count 3

    Dibutuhkan beberapa menit untuk membuat kumpulan simpul.

Menambahkan kumpulan simpul Windows Server

aks-preview Menginstal ekstensi

  1. Instal ekstensi aks-preview Azure CLI menggunakan perintah az extension add.

    Penting

    Fitur pratinjau AKS tersedia atas dasar layanan mandiri dan pendaftaran sukarela. Pratinjau disediakan "apa adanya" dan "sebagaimana tersedia," dan pratinjau tersebut dikecualikan dari perjanjian tingkat layanan (SLA) serta garansi terbatas. Pratinjau AKS sebagian didukung oleh dukungan pelanggan berdasarkan upaya terbaik yang dapat dilakukan. Dengan demikian, fitur-fitur ini tidak dimaksudkan untuk penggunaan produksi. Untuk informasi lebih lanjut, lihat artikel dukungan berikut ini:

    az extension add --name aks-preview

  2. Perbarui ke versi terbaru ekstensi menggunakan az extension update perintah . Windows Server 2025 memerlukan minimal 18,0,0b5.

    az extension update --name aks-preview
Daftarkan AksWindows2025Preview penanda fitur

  1. Daftarkan penanda fitur AksWindows2025Preview menggunakan perintah az feature register.

    az feature register --namespace "Microsoft.ContainerService" --name "AksWindows2025Preview"

  2. Verifikasi status pendaftaran menggunakan az feature show perintah . Dibutuhkan beberapa menit agar status menampilkan Terdaftar.

    az feature show --namespace Microsoft.ContainerService --name AksWindows2025Preview

  3. Saat status mencerminkan Registered, perbarui pendaftaran penyedia sumber daya Microsoft.ContainerService menggunakan perintah az provider register.

    az provider register --namespace Microsoft.ContainerService
Membuat kumpulan simpul Windows Server 2025

  • Buat kumpulan simpul baru menggunakan az aks nodepool add perintah . Contoh berikut membuat kumpulan simpul Windows dengan SKU OS Windows2025 yang berjalan tiga node.

    Untuk informasi selengkapnya tentang OS Windows, lihat praktik terbaik Windows.

    az aks nodepool add \
    --resource-group $RESOURCE_GROUP_NAME \
    --cluster-name $CLUSTER_NAME \
    --name $NODE_POOL_NAME \
    --node-vm-size Standard_DS2_v2 \
    --os-type Windows \
    --os-sku Windows2025 \
    --node-count 3

Periksa status kumpulan simpul Anda

  • Periksa status kumpulan simpul Anda menggunakan az aks nodepool list perintah dan tentukan grup sumber daya dan nama kluster Anda.

    az aks nodepool list --resource-group $RESOURCE_GROUP_NAME --cluster-name $CLUSTER_NAME

Membuat kluster AKS dengan kumpulan simpul tunggal menggunakan templat ARM

Jika Anda hanya menginginkan satu kumpulan simpul di kluster AKS, Anda dapat menjadwalkan pod aplikasi pada kumpulan simpul sistem. Jika Anda menjalankan satu kumpulan simpul sistem untuk kluster AKS Anda di lingkungan produksi, kami sarankan Anda menggunakan setidaknya tiga sumpul untuk kumpulan simpul tersebut. Jika satu simpul gagal, redundansi terganggu. Anda dapat mengurangi risiko ini dengan memiliki lebih banyak node dalam kumpulan node sistem.

Membuat sumber daya Microsoft.ContainerService/managedClusters

  • Buat sumber daya Microsoft.ContainerService/managedClusters dengan menambahkan this JSON ke templat Anda.

  • Buat satu kumpulan simpul Ubuntu di kluster AKS Anda dengan membuat modifikasi berikut pada templat ARM Anda:

      "properties": {
    "agentPoolProfiles": [
    {
        "count": "1",
        "osSKU": "ubuntu",
        "osType": "linux"
     } 
     ],
}

Menambahkan kumpulan simpul kedua menggunakan templat ARM

Kluster yang dibuat di bagian sebelumnya memiliki kumpulan simpul tunggal. Di bagian ini, kami menambahkan kumpulan simpul kedua ke kluster. Kumpulan simpul kedua ini dapat memiliki jenis OS Linux dengan SKU OS Ubuntu atau AzureLinux, atau jenis OS Windows.

Menambahkan kumpulan simpul Linux

  • Buat beberapa kumpulan simpul Ubuntu di kluster AKS Anda dengan membuat modifikasi berikut pada templat ARM Anda:

      "properties": {
    "agentPoolProfiles": [
    {
        "count": "3",
        "osSKU": "ubuntu",
        "osType": "linux"
     } 
     ],
}

Menambahkan kumpulan simpul Windows Server

aks-preview Menginstal ekstensi

  1. Instal ekstensi aks-preview Azure CLI menggunakan perintah az extension add.

    Penting

    Fitur pratinjau AKS tersedia atas dasar layanan mandiri dan pendaftaran sukarela. Pratinjau disediakan "apa adanya" dan "sebagaimana tersedia," dan pratinjau tersebut dikecualikan dari perjanjian tingkat layanan (SLA) serta garansi terbatas. Pratinjau AKS sebagian didukung oleh dukungan pelanggan berdasarkan upaya terbaik yang dapat dilakukan. Dengan demikian, fitur-fitur ini tidak dimaksudkan untuk penggunaan produksi. Untuk informasi lebih lanjut, lihat artikel dukungan berikut ini:

    az extension add --name aks-preview

  2. Perbarui ke versi terbaru ekstensi menggunakan az extension update perintah . Windows Server 2025 memerlukan minimal 18,0,0b5.

    az extension update --name aks-preview
Daftarkan AksWindows2025Preview penanda fitur

  1. Daftarkan penanda fitur AksWindows2025Preview menggunakan perintah az feature register.

    az feature register --namespace "Microsoft.ContainerService" --name "AksWindows2025Preview"

  2. Verifikasi status pendaftaran menggunakan az feature show perintah . Dibutuhkan beberapa menit agar status menampilkan Terdaftar.

    az feature show --namespace Microsoft.ContainerService --name AksWindows2025Preview

  3. Saat status mencerminkan Registered, perbarui pendaftaran penyedia sumber daya Microsoft.ContainerService menggunakan perintah az provider register.

    az provider register --namespace Microsoft.ContainerService
Membuat kumpulan simpul Windows Server 2025

  • Buat beberapa kumpulan simpul Windows di kluster AKS Anda dengan membuat modifikasi berikut pada templat ARM Anda:

      "properties": {
    "agentPoolProfiles": [
    {
        "count": "3",
        "osSKU": "windows2025",
        "osType": "windows"
     } 
     ],
}

Menyebarkan templat ARM Anda

Mengatur taint, label, atau tag untuk kumpulan simpul

Saat membuat kumpulan simpul, Anda dapat menambahkan taint, label, atau tag ke dalamnya. Ketika Anda menambahkan taint, label, atau tag, semua node dalam kumpulan node tersebut juga mendapatkan taint, label, atau tag tersebut. Sebaiknya terapkan properti ini ke seluruh kumpulan simpul alih-alih simpul individual. Dengan cara ini, Anda dapat dengan mudah mengelola properti semua simpul di kumpulan simpul dengan memperbarui properti kumpulan simpul alih-alih memperbarui setiap simpul satu per satu.

Untuk instruksi khusus tentang cara mengatur taint, label, atau tag untuk kumpulan simpul, gunakan sumber daya berikut:

Langkah berikutnya

Dalam artikel ini, Anda mempelajari cara membuat kluster AKS dengan satu kumpulan simpul dan menambahkan kumpulan simpul tambahan ke kluster Anda. Untuk mempelajari selengkapnya tentang cara mengelola kumpulan simpul Anda, lihat artikel berikut ini:

  • Last updated on