Azure Kubernetes Service (AKS)'da 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

10 Aralık 2026 tarihinden itibaren Azure Kubernetes Service (AKS), AKS için OS Guard özellikli Azure Linux'u artık desteklemez (önizleme). Bu noktada AKS artık OS Guard düğüm görüntüleriyle yeni Azure Linux üretmez veya güvenlik düzeltme ekleri sağlamaz ve artık OS Guard ile Azure Linux ile yeni düğüm havuzları oluşturamıyabilirsiniz. 10 Mart 2027'de AKS, OS Guard düğüm görüntüleriyle tüm mevcut Azure Linux'u kaldırır ve bu da ölçeklendirme ve düzeltme (yeniden oluşturma ve yeniden dağıtma) işlemlerinin başarısız olmasına neden olur. Kesintiyi önlemek için Azure Container Linux'a (ACL) geçin. Bu kullanımdan kaldırma hakkında daha fazla bilgi için Kullanımdan kaldırma GitHub sorununa ve Azure Updates kullanımdan kaldırma duyurusuna bakın. Duyurular ve güncelleştirmeler hakkında bilgi sahibi olmak için AKS sürüm notlarını izleyin.

Önemli

November 30, 2025 tarihinden itibaren Azure Kubernetes Service (AKS) artık Azure Linux 2.0 için güvenlik güncelleştirmelerini desteklemez veya sağlamaz. 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 ile desteklenen bir Azure Linux sürümüne geçin. Daha fazla bilgi için Emeklilik GitHub sorunu ve Azure Güncelleştirmeleri kullanımdan kaldırma duyurusu'na bakınız. Duyurular ve güncelleştirmeler hakkında bilgi sahibi olmak için AKS sürüm notlarını izleyin.

Önkoşullar

  • Azure CLI sürüm 2.87.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 gerekiyorsa bkz. Azure CLI yükleme.
  • ARM şablonu dağıtmak için, dağıttığınız kaynaklara yazma erişimine ve Microsoft.Resources/deployments kaynak türündeki 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 sahip olmanız gerekir. Rollerin ve izinlerin listesi için bkz. Azure yerleşik roller.
  • 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 iki düğüm içermelidir ve 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, , Ubuntuveya AzureContainerLinuxgibi AzureLinuxherhangi bir Linux varyasyonu olabilir. Tek bir Windows düğüm havuzuyla küme oluşturamazsınız. Windows kapsayıcıları ç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.

  • Windows desteği olmadan oluşturulmuş bir kümede etkinleştiremezsiniz. Bir kümeye Windows düğüm havuzu eklemek için, windowsProfile öğesinin küme ilk oluşturulurken yapılandırılması gerekir (örneğin, Azure CLI ile --windows-admin-username ve --windows-admin-password belirtilerek). Bu parametreler olmadan bir küme oluşturulduysa, kümenin Windows profil tanımı olmadığından Windows düğüm havuzu ekleme girişimleri başarısız olur. Windows kapsayıcıları var olan bir Yalnızca Linux kümesinde çalıştırmak için, Windows desteği etkinleştirilmiş olarak kümeyi yeniden oluşturmanız gerekir. Daha fazla bilgi için GitHub ilgili özellik isteğine bakın.

  • 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.

  • Bir düğüm havuzunu oluşturduktan sonra en fazla pod ayarını değiştiremezsiniz. Farklı bir maksimum pod değeri kullanmak için, istenen maksimum pod ayarına sahip yeni bir düğüm havuzu oluşturun, iş yüklerini geçirin ve ardından eski düğüm havuzunu silin.

  • 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.

Önemli

AKS üzerinde Azure Container Linux (ACL) kullanıyorsanız aşağıdaki önemli noktaları ve sınırlamaları gözden geçirin:

Ö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

az group create komutunu kullanarak 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, Linux veya Ubuntu işletim sistemi SKU'su ile AzureLinux işletim sistemi türüne veya Windows işletim sistemi türüne sahip 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

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 Server 2025 düğüm havuzları FIPS etkinleştirilmiş bir görüntü gerektirir, bu nedenle komut --enable-fips-image içerir.

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 \
    --enable-fips-image \
    --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 kaynağı oluşturma

Şablonunuza Microsoft.ContainerService/managedClusters ekleyerek kaynağı 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, Linux veya Ubuntu işletim sistemi SKU'su ile AzureLinux işletim sistemi türüne veya Windows işletim sistemi türüne sahip 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

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

  • Azure Kubernetes Service (AKS) kümesini bir ARM şablonu kullanarak dağıtma hakkındaki yönergeleri izleyerek ARM şablonunuzu dağıtın.

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