Aracılığıyla paylaş

Azure Kubernetes Service'te (AKS) küme için düğüm havuzları oluşturma

Bu makalede AKS kümesinde bir veya daha fazla düğüm havuzunun nasıl oluşturulacağı gösterilmektedir.

Not

Bu özellik, birden çok düğüm havuzu oluşturma ve yönetme üzerinde daha fazla denetim sağlar ve oluşturma/güncelleştirme/silme (CRUD) işlemleri için ayrı komutlar gerektirir. Daha önce, az aks create veya az aks update aracılığıyla yapılan küme işlemleri, kontrol düzleminizi ve birden fazla düğüm havuzunu değiştirmek için managedCluster API'sini kullanıyordu ve bu tek seçenekti. Bu özellik, agentPool API aracılığıyla aracı havuzları için ayrı bir işlem kümesi sunar ve tek bir düğüm havuzunda işlemleri yürütmek için komut kümesinin az aks nodepool kullanılmasını gerektirir.

Önemli

30 Kasım 2025 itibarıyla Azure Kubernetes Service (AKS) artık Azure Linux 2.0 için güvenlik güncelleştirmelerini desteklememektedir veya sağlamamaktadır. Azure Linux 2.0 düğüm görüntüsü 202512.06.0 sürümünde dondurulur. 31 Mart 2026'dan itibaren düğüm görüntüleri kaldırılacak ve düğüm havuzlarınızı ölçeklendiremeyeceksiniz. Düğüm havuzlarınızı desteklenen bir Kubernetes sürümüne yükselterek veya osSku AzureLinux3'e geçerek desteklenen bir Azure Linux sürümüne geçin. Daha fazla bilgi için bkz. [Kullanımdan kaldırma] AKS üzerinde Azure Linux 2.0 düğüm havuzları.

Önkoşullar

  • Azure CLI sürüm 2.2.0 veya üzerinin yüklü ve yapılandırılmış olması gerekir. Sürümü bulmak için az --version komutunu çalıştırın. Yüklemeniz veya yükseltmeniz gerekirse, bkz. Azure CLI yükleme.

  • ARM şablonu dağıtmak için, dağıttığınız kaynaklara yazma erişimine ve kaynak türündeki Microsoft.Resources/deployments tüm işlemlere erişmeniz gerekir. Örneğin, bir sanal makine (VM) dağıtmak için Microsoft.Compute/virtualMachines/write ve Microsoft.Resources/deployments/* izinlerine ihtiyacınız vardır. Rol ve izinlerin bir listesi için Azure yerleşik roller'ine bakın.

  • Her parametre için aşağıdaki gereksinimleri gözden geçirin:

    • osTYPE: İşletim sistemi türü. Varsayılan değer Linux'tır.
    • osSKU: Aracı havuzunun kullandığı işletim sistemi SKU'sunu belirtir.
    • count: Docker kapsayıcılarını barındıracak aracıların (VM) sayısı. İzin verilen değerler, kullanıcı havuzları için 0 ile 1000 (dahil) arasında ve sistem havuzları için 1 ile 1000 (dahil) arasında olmalıdır. Varsayılan değer 1'dir.

  • Bir ARM şablonu kullanarak kümeyi dağıttığınızda, kümeye bağlanmak ve örnek uygulamayı dağıtmak için Azure CLI veya Azure PowerShell kullanabilirsiniz.

Sınırlamalar

Birden çok düğüm havuzunu destekleyen AKS kümeleri oluşturduğunuzda aşağıdaki sınırlamalar geçerlidir:

  • AKS kümesindeki yerini alacak başka bir sistem düğümü havuzunuz varsa sistem düğümü havuzunu silebilirsiniz. Aksi takdirde, sistem düğümü havuzunu silemezsiniz.

  • Sistem havuzları en az bir düğüm içermelidir. Kullanıcı düğümü havuzları sıfır veya daha fazla düğüm içerebilir.

  • Tek düğümlü havuza sahip bir küme oluşturursanız işletim sistemi türü olmalıdır Linux. İşletim sistemi SKU'su veya Ubuntugibi AzureLinux herhangi bir Linux varyasyonu olabilir. Tek bir Windows düğüm havuzuyla küme oluşturamazsınız. Windows kapsayıcılarını çalıştırmak istiyorsanız, kümeyi bir Linux sistem düğüm havuzuyla oluşturduktan sonra kümeye bir Windows düğüm havuzu eklemeniz gerekir.

  • AKS kümesinin birden çok düğüm havuzu kullanmak için Standart SKU yük dengeleyiciyi kullanması gerekir. Bu özellik Temel SKU yük dengeleyicilerde desteklenmez.

  • AKS kümesi düğümler için Sanal Makine Ölçek Kümeleri kullanmalıdır.

  • Düğüm havuzunun adı yalnızca küçük harfli alfasayısal karakterler içerebilir ve küçük harfle başlamalıdır.

    • Linux düğüm havuzları için uzunluk 1-12 karakter arasında olmalıdır.
    • Windows düğüm havuzları için uzunluk 1-6 karakter arasında olmalıdır.

  • Tüm düğüm havuzlarının aynı sanal ağda bulunması gerekir.

  • Düğüm havuzunu oluşturduktan sonra sanal makinenin (VM) boyutunu değiştiremezsiniz.

  • Küme oluşturma zamanında birden çok düğüm havuzu oluşturduğunuzda, düğüm havuzları için Kubernetes sürümleri denetim düzlemi için ayarlanan sürümle eşleşmelidir. Düğüm başına havuz işlemlerini kullanarak kümeyi sağladıktan sonra güncelleştirmeler yapabilirsiniz.

Özelleştirilmiş düğüm havuzları oluşturma

Özelleştirilmiş düğüm havuzları oluşturmayı öğrenmek için aşağıdaki makalelere bakın:

Ortam değişkenlerini belirleme

  • Bu makaledeki talimatlardaki komutları basitleştirmek için kabuğunuzda aşağıdaki ortam değişkenlerini ayarlayın. Değerleri tercih ettiğiniz adlarla değiştirebilirsiniz.

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

Bir kaynak grubu oluşturun

  • komutunu kullanarak az group create bir Azure kaynak grubu oluşturun.

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

Azure CLI kullanarak tek düğümlü havuz ile AKS kümesi oluşturma

AKS kümenizde yalnızca bir düğüm havuzu istiyorsanız, sistem düğümü havuzlarında uygulama podları zamanlayabilirsiniz. AKS kümeniz için bir üretim ortamında tek bir sistem düğümü havuzu çalıştırıyorsanız, düğüm havuzu için en az üç düğüm kullanmanızı öneririz. Bir düğüm devre dışı kalırsa yedeklilik tehlikeye girer. Daha fazla sistem düğümü havuzu düğümüne sahip olarak bu riski azaltabilirsiniz.

  1. komutunu kullanarak tek bir Ubuntu düğüm havuzuna az aks create sahip bir küme oluşturun. Bu adım, tek düğüm havuzundaki iki düğümü belirtir.

    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

    Kümenin oluşturulması birkaç dakika sürer.

  2. Küme hazır olduğunda komutunu kullanarak az aks get-credentials küme kimlik bilgilerini alın.

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

Azure CLI kullanarak ikinci düğüm havuzu ekleme

Önceki bölümde oluşturulan kümenin tek düğüm havuzu vardır. Bu bölümde kümeye ikinci bir düğüm havuzu ekleyeceğiz. Bu ikinci düğüm havuzu, işletim sistemi türü Linux ve işletim sistemi SKU'su Ubuntu veya AzureLinux, ya da işletim sistemi türü Windows olabilir.

Not

AKS kümenize Kısa ömürlü işletim sistemi diskleri kullanan bir düğüm havuzu eklemek istiyorsanız, komutu çalıştırırken --node-osdisk-type bayrağı olarak Ephemeral ayarlayabilirsinizaz aks nodepool add.

Kısa ömürlü işletim sistemi ile VM'leri ve örnek görüntülerini VM önbelleğinin boyutuna kadar dağıtabilirsiniz. AKS'deki varsayılan düğüm işletim sistemi disk yapılandırması 128 GB kullanır, bu da önbelleği 128 GB'tan büyük bir VM boyutuna ihtiyacınız olduğu anlamına gelir. Varsayılan değer Standard_DS2_v2 86 GB önbellek boyutuna sahiptir ve bu boyut yeterince büyük değildir. VM SKU'sunun Standard_DS3_v2 önbellek boyutu 172 GB'tır ve bu boyut yeterince büyüktür. kullanarak işletim sistemi diskinin --node-osdisk-sizevarsayılan boyutunu da küçültebilirsiniz, ancak AKS görüntülerinin en düşük boyutunun 30 GB olduğunu unutmayın.

Ağa bağlı işletim sistemi diskleriyle düğüm havuzları oluşturmak istiyorsanız, komutu çalıştırırken --node-osdisk-type bayrağı olarak Managed ayarlayabilirsinizaz aks nodepool add.

Linux düğüm havuzu ekleme

  • komutunu kullanarak az aks nodepool add yeni bir düğüm havuzu oluşturun. Aşağıdaki örnek, işletim sistemi SKU'su Linux ile Ubuntu üç düğüm çalıştıran bir düğüm havuzu oluşturur. bir işletim sistemi SKU'su belirtmezseniz AKS varsayılan olarak olur 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

    Düğüm havuzunun oluşturulması birkaç dakika sürer.

Windows Server düğüm havuzu ekleme

Uzantıyı aks-preview yükle

  1. aks-preview komutunu kullanarak Azure CLI uzantısını az extension add yükleyin.

    Önemli

    AKS önizleme özellikleri self servis ve kabul temelinde kullanılabilir. Önizlemeler "olduğu gibi" ve "mevcut olduğu şekilde" sağlanmakta olup, hizmet seviyesi anlaşmalarına ve sınırlı garantilere dahil edilmemektedir. AKS önizlemeleri, müşteri desteği ekibi tarafından maksimum çaba gösterilerek kısmen ele alınmaktadır. Bu nedenle, bu özellikler üretim kullanımı için tasarlanmamıştır. Daha fazla bilgi için aşağıdaki destek makalelerine bakın:

    az extension add --name aks-preview

  2. komutunu kullanarak uzantının en son sürümüne güncelleştirin az extension update . Windows Server 2025 için en az 18.0.0b5 gerekir.

    az extension update --name aks-preview
Özellik bayrağını AksWindows2025Preview kaydetme

  1. AksWindows2025Preview özellik bayrağını az feature register komutunu kullanarak kaydedin.

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

  2. komutunu kullanarak az feature show kayıt durumunu doğrulayın. Durumun Kayıtlı olarak gösterilmesi birkaç dakika sürer.

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

  3. Durum Kayıtlı olarak yansıtıldığında komutunu kullanarak az provider register kaynak sağlayıcısının kaydını yenileyin.

    az provider register --namespace Microsoft.ContainerService
Windows Server 2025 düğüm havuzunu oluşturma

  • komutunu kullanarak az aks nodepool add yeni bir düğüm havuzu oluşturun. Aşağıdaki örnek, işletim sistemi SKU'su Windows ile Windows2025 üç düğüm çalıştıran bir düğüm havuzu oluşturur.

    Windows işletim sistemi hakkında daha fazla bilgi için bkz. Windows en iyi yöntemleri.

    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

Düğüm havuzlarınızın durumunu kontrol edin

  • komutunu kullanarak az aks nodepool list düğüm havuzlarınızın durumunu denetleyin ve kaynak grubunuzu ve küme adınızı belirtin.

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

ARM şablonu kullanarak tek düğümlü havuz ile AKS kümesi oluşturma

AKS kümenizde yalnızca bir düğüm havuzu istiyorsanız, sistem düğümü havuzlarında uygulama podları zamanlayabilirsiniz. AKS kümeniz için bir üretim ortamında tek bir sistem düğümü havuzu çalıştırıyorsanız, düğüm havuzu için en az üç düğüm kullanmanızı öneririz. Bir düğüm devre dışı kalırsa yedeklilik tehlikeye girer. Daha fazla sistem düğümü havuzu düğümüne sahip olarak bu riski azaltabilirsiniz.

Microsoft.ContainerService/managedClusters Kaynak oluşturma

  • Microsoft.ContainerService/managedClusters şablonunuz için ekleyerek bir kaynak oluşturun.

  • ARM şablonunuzda aşağıdaki değişiklikleri yaparak AKS kümenizde tek bir Ubuntu düğüm havuzu oluşturun:

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

ARM şablonu kullanarak ikinci düğüm havuzu ekleme

Önceki bölümde oluşturulan kümenin tek düğüm havuzu vardır. Bu bölümde kümeye ikinci bir düğüm havuzu ekleyeceğiz. Bu ikinci düğüm havuzu, işletim sistemi türü Linux ve işletim sistemi SKU'su Ubuntu veya AzureLinux, ya da işletim sistemi türü Windows olabilir.

Linux düğüm havuzları ekleme

  • ARM şablonunuzda aşağıdaki değişiklikleri yaparak AKS kümenizde birden çok Ubuntu düğüm havuzu oluşturun:

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

Windows Server düğüm havuzları ekleme

Uzantıyı aks-preview yükle

  1. aks-preview komutunu kullanarak Azure CLI uzantısını az extension add yükleyin.

    Önemli

    AKS önizleme özellikleri self servis ve kabul temelinde kullanılabilir. Önizlemeler "olduğu gibi" ve "mevcut olduğu şekilde" sağlanmakta olup, hizmet seviyesi anlaşmalarına ve sınırlı garantilere dahil edilmemektedir. AKS önizlemeleri, müşteri desteği ekibi tarafından maksimum çaba gösterilerek kısmen ele alınmaktadır. Bu nedenle, bu özellikler üretim kullanımı için tasarlanmamıştır. Daha fazla bilgi için aşağıdaki destek makalelerine bakın:

    az extension add --name aks-preview

  2. komutunu kullanarak uzantının en son sürümüne güncelleştirin az extension update . Windows Server 2025 için en az 18.0.0b5 gerekir.

    az extension update --name aks-preview
Özellik bayrağını AksWindows2025Preview kaydetme

  1. AksWindows2025Preview özellik bayrağını az feature register komutunu kullanarak kaydedin.

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

  2. komutunu kullanarak az feature show kayıt durumunu doğrulayın. Durumun Kayıtlı olarak gösterilmesi birkaç dakika sürer.

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

  3. Durum Kayıtlı olarak yansıtıldığında komutunu kullanarak az provider register kaynak sağlayıcısının kaydını yenileyin.

    az provider register --namespace Microsoft.ContainerService
Windows Server 2025 düğüm havuzlarını oluşturma

  • ARM şablonunuzda aşağıdaki değişiklikleri yaparak AKS kümenizde birden çok Windows düğümü havuzu oluşturun:

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

ARM şablonunuzu dağıtma

Düğüm havuzu için kirlilikler, etiketler veya etiketler ayarlayın

Düğüm havuzu oluştururken, bu havuza renk tonları, etiketler veya etiketler ekleyebilirsiniz. Taint, etiket veya etiket eklediğinizde, bu düğüm havuzundaki tüm düğümler de bu taint, etiket veya etiketi alır. Bu özellikleri tek tek düğümler yerine düğüm havuzunun tamamına uygulamanızı öneririz. Bu şekilde, her düğümü ayrı ayrı güncelleştirmek yerine düğüm havuzu özelliklerini güncelleştirerek düğüm havuzundaki tüm düğümlerin özelliklerini kolayca yönetebilirsiniz.

Bir düğüm havuzu için lekeler, etiketler veya taglar ayarlama hakkında belirli yönergeler için aşağıdaki kaynakları kullanın:

Sonraki adımlar

Bu makalede, tek düğümlü havuza sahip bir AKS kümesi oluşturmayı ve kümenize ek düğüm havuzları eklemeyi öğrendiniz. Düğüm havuzlarınızı yönetme hakkında daha fazla bilgi edinmek için aşağıdaki makalelere bakın:

  • Last updated on