Azure Kubernetes Service (AKS) düğüm havuzları için düğüm yapılandırmasını özelleştirme

Düğüm yapılandırmanızı özelleştirerek, işletim sistemi (OS) ayarlarını veya kubelet parametrelerini iş yüklerinizin gereksinimlerine uyacak şekilde ayarlayabilirsiniz. AKS kümesi oluşturduğunuzda veya kümenize bir düğüm havuzu eklediğinizde, yaygın olarak kullanılan işletim sistemi ve kubelet ayarlarının bir alt kümesini özelleştirebilirsiniz. Bu alt kümenin ötesindeki ayarları yapılandırmak için, düğümleriniz için AKS desteğini kaybetmeden gerekli yapılandırmalarınızı özelleştirmek üzere bir daemon kümesi kullanın.

Prerequisites

Hizmet yeni ayarlar ve kubelet parametreleri için destek ekledikçe, önizleme özellik bayrağının kaydedilmesi gerekebilir. Bir önizleme bayrağı gerekiyorsa, özel düğüm yapılandırma parametreleri referansı bunu açıkça belirtir.

hardEvictionThreshold ve kubeReserved kubelet ayarları için önizleme gereksinimleri

Ö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:

aks-preview Azure CLI uzantısını yükleme

  1. aks-preview uzantısını yüklemek için aşağıdaki komutu çalıştırın:

    az extension add --name aks-preview

  2. Uzantının en son sürümüne güncelleştirmek için aşağıdaki komutu çalıştırın:

    az extension update --name aks-preview

CustomNodeConfigPreview Önizleme kubeReserved ve hardEvictionThreshold kubelet ayarlarını kullanmadan önce özellik bayrağını Azure aboneliğinize kaydedin.

Özellik bayrağını CustomNodeConfigPreview kaydetme

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

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

    Durumun Kayıtlı olarak gösterilmesi birkaç dakika sürer.

  2. komutunu kullanarak az feature show kayıt durumunu doğrulayın.

    az feature show --namespace "Microsoft.ContainerService" --name "CustomNodeConfigPreview"

  3. Durum Kayıtlı olarak gösterildiğinde, komutunu kullanarak az provider register kaynak sağlayıcısının kaydını yenileyin.

    az provider register --namespace "Microsoft.ContainerService"

AKS düğüm havuzları için özel düğüm yapılandırma dosyaları oluşturma

İşletim sistemi ve kubelet yapılandırmasını değiştirmek için, istediğiniz parametreleri ve ayarları içeren yeni bir yapılandırma dosyası oluşturun. Parametre için bir değer belirtmezseniz, varsayılan değer kullanılır.

Not

Aşağıdaki örneklerde yaygın yapılandırma ayarları gösterilmektedir. İş yükü gereksinimlerinizi karşılamak için ayarları değiştirin. Desteklenen özel yapılandırma parametrelerinin tam listesi için bkz. AKS için özel düğüm yapılandırma parametreleri.

Kubelet yapılandırması

Aşağıdaki içeriklere sahip bir linuxkubeletconfig.json dosya oluşturun:

{
 "cpuManagerPolicy": "static",
 "cpuCfsQuota": true,
 "cpuCfsQuotaPeriod": "200ms",
 "imageGcHighThreshold": 90,
 "imageGcLowThreshold": 70,
 "topologyManagerPolicy": "best-effort",
 "allowedUnsafeSysctls": [
  "kernel.msg*",
  "net.*"
],
 "failSwapOn": false
}

Linux düğüm havuzlarında Düğüm Özelleştirme Önizlemesi kubelet ayarlarını kullanmak için kubelet yapılandırma dosyanıza kubeReserved ve hardEvictionThreshold ekleyin. Aşağıdaki örnek, Kubernetes sistem daemon’ları için CPU ve bellek ayırır ve kubelet kesin tahliye eşiklerini yapılandırır:

{
  "cpuManagerPolicy": "static",
  "kubeReserved": {
    "cpuMillicores": 200,
    "memoryMB": 1024
  },
  "hardEvictionThreshold": {
    "memoryAvailable": "20%",
    "nodeFsAvailable": "10%",
    "nodeFsInodesFree": "5%"
  }
}

kubeReserved ve hardEvictionThreshold öğelerini yalnızca Linux düğüm havuzlarında kullanın. Her iki ayar için de CustomNodeConfigPreview özellik bayrağı gerekir.

İşletim sistemi yapılandırması

Aşağıdaki içeriklere sahip bir linuxosconfig.json dosya oluşturun:

{
 "transparentHugePageEnabled": "madvise",
 "transparentHugePageDefrag": "defer+madvise",
 "swapFileSizeMB": 1500,
 "sysctls": {
  "netCoreSomaxconn": 163849,
  "netIpv4TcpTwReuse": true,
  "netIpv4IpLocalPortRange": "32000 60000"
 }
}

Özel yapılandırma dosyalarını kullanarak AKS kümesi oluşturma

Not

Yeni aks kümesi oluştururken özel yapılandırma dosyalarını kullanırken aşağıdaki bilgileri göz önünde bulundurun:

  • Küme oluştururken bir yapılandırma belirtirseniz, yapılandırma yalnızca ilk düğüm havuzundaki düğümlere uygulanır. Küme, JSON dosyasında yapılandırılmamış tüm ayarlar için varsayılan değerleri korur.
  • CustomLinuxOsConfig , Windows işletim sistemi türü için desteklenmez.
  • Önizleme kubeReserved ve hardEvictionThreshold kubelet ayarları yalnızca Linux düğüm havuzlarında desteklenmektedir ve CustomNodeConfigPreview özellik bayrağını gerektirir. Kümeyi veya düğüm havuzunu oluşturmadan önce ve hardEvictionThreshold kubelet ayarları için kubeReserved önizleme gereksinimleri bölümünde yer alan kayıt adımlarını tamamlayın.

komutunu çalıştırıp az aks create ve --linux-os-config parametreleri için --kubelet-config yapılandırma dosyalarınızı belirterek özel yapılandırma dosyalarını kullanarak yeni bir küme oluşturun. Aşağıdaki örnek komut, özel ./linuxkubeletconfig.json ve ./linuxosconfig.json dosyalarıyla yeni bir küme oluşturur:

az aks create --name <cluster-name> --resource-group <resource-group-name> --kubelet-config ./linuxkubeletconfig.json --linux-os-config ./linuxosconfig.json

Özel yapılandırma dosyalarını kullanarak düğüm havuzu ekleme

Not

Mevcut AKS kümesine yeni bir düğüm havuzu eklemek için özel yapılandırma dosyalarını kullanırken aşağıdaki bilgileri göz önünde bulundurun:

  • Mevcut bir kümeye Linux düğüm havuzu eklediğinizde kubelet yapılandırmasını, işletim sistemi yapılandırmasını veya her ikisini de belirtebilirsiniz. Var olan bir kümeye Windows düğüm havuzu eklediğinizde, yalnızca kubelet yapılandırmasını belirtebilirsiniz. Düğüm havuzu eklerken bir yapılandırma belirtirseniz, yapılandırma yalnızca yeni düğüm havuzundaki düğümlere uygulanır. Düğüm havuzu, JSON dosyasında yapılandırılmamış ayarlar için varsayılan değerleri kullanmaya devam eder.
  • CustomKubeletConfig , Linux ve Windows düğüm havuzları için desteklenir.
  • Önizleme kubeReserved ve hardEvictionThreshold kubelet ayarları yalnızca Linux düğüm havuzlarında desteklenmektedir ve CustomNodeConfigPreview özellik bayrağını gerektirir. Kümeyi veya düğüm havuzunu oluşturmadan önce ve hardEvictionThreshold kubelet ayarları için kubeReserved önizleme gereksinimleri bölümünde yer alan kayıt adımlarını tamamlayın.

komutunu kullanarak az aks nodepool add ve ve --linux-os-config parametreleri için --kubelet-config yapılandırma dosyalarınızı belirterek yeni bir Linux düğüm havuzu oluşturun. Aşağıdaki örnek komut, özel ./linuxkubeletconfig.json dosyayla yeni bir Linux düğüm havuzu oluşturur:

az aks nodepool add --name <node-pool-name> --cluster-name <cluster-name> --resource-group <resource-group-name> --kubelet-config ./linuxkubeletconfig.json

Ayarların uygulandığını onaylayın

Özel düğüm yapılandırmasını uyguladıktan sonra, ana bilgisayara bağlanarak ve dosya sisteminde yapılandırma değişiklikleri yapıldığını doğrulayarak sysctl ayarların düğümlere uygulandığını onaylayabilirsiniz.

Desteklenen özel yapılandırma parametrelerini gözden geçirin

Desteklenen kubelet ve Linux işletim sistemi yapılandırma parametrelerinin, izin verilen değerlerin, varsayılan değerlerin ve açıklamaların tam listesi için bkz. AKS için özel düğüm yapılandırma parametreleri.

Özel düğüm yapılandırmaları için dikkat edilmesi gerekenler

Düğüm yapılandırmanızı özelleştirirken aşağıdaki noktaları göz önünde bulundurun:

  • Düğüm imajı yükseltmeleri özel düğüm yapılandırmalarını yeniden uygular.
  • Ölçeği genişletme işlemleri özel düğüm yapılandırmalarını korur.
  • AKS, her özel düğüm yapılandırma parametresi veya değeri için uçuş öncesi doğrulama gerçekleştirmez. Küme düğümlerinizle ilgili olası sorunları önlemek için belirttiğiniz özel düğüm yapılandırma parametrelerinin ve değerlerinin desteklenip geçerli olduğundan emin olun.
  • Önizleme kubeReserved ve hardEvictionThreshold ayarlar yalnızca Linux düğüm havuzlarında kullanılabilir.
  • yapılandırıyorsanız kubeReserved, değerlerin pozitif olması gerekir ve hedef düğüm havuzunda kullanılabilir CPU veya bellek kapasitesini aşamaz.
  • hardEvictionThreshold yapılandırırsanız, Ki ve Mi için yalnızca desteklenen birimleri kullanın: Gi, %, memoryAvailable veya nodeFsAvailable; % için ise yalnızca salt sayı veya nodeFsInodesFree kullanın.
  • Özel düğüm yapılandırma parametreleri için varsayılan değerler genellikle yeni işletim sistemi sürümleriyle değişir. Özel düğüm yapılandırmalarını uygularken, özel ayarlarınızın küme düğümlerinizin işletim sistemi sürümüne uygun olduğundan emin olmak için yapılandırdığınız parametrelerin varsayılan değerlerini gözden geçirin.
  • Küme kararlılığı ve performansı üzerinde istenmeyen sonuçları önlemek için özel düğüm yapılandırmasını değiştirme izinleri olan kişi sayısını sınırlayın. Küme yapılandırma ayarlarına erişimi kısıtlamak için Kubernetes API'si için Microsoft Entra Id yetkilendirmesini kullanmayı göz önünde bulundurun.
  • Belirli yapılandırma değişikliklerine duyarlı olabilecek iş yüklerinde istenmeyen sonuçları önlemek için özel yapılandırmaları olan düğüm havuzlarını özel yapılandırmaları olmayanlardan ayırın. Örneğin, belirli kubelet ayarları gerektiren kritik bir iş yükünüz varsa, bu iş yükünü gerekli özel kubelet yapılandırmasıyla ayrılmış bir düğüm havuzuna yalıtmayı göz önünde bulundurun.

İlgili içerik

  • Last updated on