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.

kubeReserved, hardEvictionThreshold, softEvictionThreshold, softEvictionGracePeriod ve evictionMaxPodGracePeriodInSeconds kubelet ayarları önizleme aşamasındadır ve CustomNodeConfigPreview özellik bayrağı gerektirir. Bu ayarlar, AKS Node Hardening tarafından da yapılandırılan kaynak rezervasyonlarını ve tahliye eşiklerini özelleştirmenize olanak sağlar. Kayıt adımları, varsayılan değerler ve örnekler için bkz. AKS'de Düğüm Güçlendirme (önizleme).

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 kube-reserved kaynaklarını ve tahliye eşiklerini özelleştirmek için bkz. Düğüm Sağlamlaştırma ayarlarını özelleştirme.

İş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 tahliye eşiği kubelet ayarları yalnızca Linux düğüm havuzları için desteklenir ve CustomNodeConfigPreview özellik bayrağını gerektirir. Ekleme adımları için bkz. AKS'de Düğüm Güçlendirme (önizleme).

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 tahliye eşiği kubelet ayarları yalnızca Linux düğüm havuzları için desteklenir ve CustomNodeConfigPreview özellik bayrağını gerektirir. Kayıt adımları için bkz. AKS'de Node Hardening (önizleme).

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 tahliye eşiği kubelet ayarları yalnızca Linux düğüm havuzlarında kullanılabilir. Bunları yapılandırıyorsanız, özel düğüm yapılandırma parametreleri başvurusunda desteklenen aralıkları, birimleri ve eşleştirme kurallarını 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

  • Son güncelleştirme: