Öğretici: Düğümleri Azure Linux'a geçirme

Dağıtma ve Keşfetme

Beşin üçüncü bölümü olan bu öğreticide mevcut düğümlerinizi Azure Linux'a geçirirsiniz. Aşağıdaki yöntemlerden birini kullanarak mevcut düğümlerinizi Azure Linux'a geçirebilirsiniz:

• Mevcut düğüm havuzlarını kaldırın ve yeni Azure Linux düğüm havuzları ekleyin.
• Yerinde OS SKU geçişi.

Azure Linux'a geçiş için mevcut düğümleriniz yoksa sonraki öğreticiye geçebilirsiniz. Sonraki öğreticilerde kümelerinizde telemetri ve izlemeyi etkinleştirmeyi ve Azure Linux düğümlerini yükseltmeyi öğreneceksiniz.

Ö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

• Önceki öğreticilerde AKS kümesi için bir Azure Linux Container Host oluşturup dağıtmıştınız. Bu öğreticiyi tamamlamak için mevcut kümenize bir Azure Linux düğüm havuzu eklemeniz gerekir. Bu adımı henüz yapmadıysanız ve takip etmek istiyorsanız Öğretici 2: Mevcut AKS kümenize Azure Linux düğüm havuzu ekleme ile başlayın.

  Not

  Yeni bir Azure Linux düğüm havuzu eklerken en az bir tane --mode System olarak eklemeniz gerekir. Aksi takdirde AKS, mevcut düğüm havuzunuzu silmenize izin vermez.

• Azure CLI'nın en son sürümüne ihtiyacınız vardır. Sürümü bulmak için az --version komutunu çalıştırın. Yüklemeniz veya yükseltmeniz gerekirse, bkz. Azure CLI yükleme.

Azure Linux düğüm havuzları ekleme ve mevcut düğüm havuzlarını kaldırma

1. komutunu kullanarak az aks nodepool add yeni bir Azure Linux düğüm havuzu ekleyin. Bu komut, bayrağıyla --mode System kümenize yeni bir düğüm havuzu ekler ve bu da onu bir sistem düğümü havuzu yapar. Azure Linux kümeleri için sistem düğümü havuzları gereklidir.

# Declare environment variables with a random suffix for uniqueness
export RANDOM_SUFFIX=$(openssl rand -hex 3)
export NODE_POOL_NAME="np$RANDOM_SUFFIX"
az aks nodepool add --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name $NODE_POOL_NAME --mode System --os-sku AzureLinux

Sonuçlar:

{
  "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.ContainerService/managedClusters/myAKSCluster/nodePools/systempool",
  "name": "systempool",
  "provisioningState": "Succeeded"
}

2. komutunu kullanarak az aks nodepool delete mevcut düğümlerinizi kaldırın.

Yerinde OS SKU geçişi

Artık düğüm havuzunun işletim sistemi SKU'sunu değiştirerek mevcut Ubuntu düğüm havuzlarınızı Azure Linux'a geçirebilirsiniz ve bu da kümeyi standart düğüm görüntüsü yükseltme işlemi aracılığıyla yuvarlar. Bu yeni özellik, yeni düğüm havuzlarının oluşturulmasını gerektirmez.

Sınırlamalar

İşletim sistemi SKU geçiş isteğini engelleyebilecek çeşitli ayarlar vardır. Geçişin başarılı olmasını sağlamak için aşağıdaki yönergeleri ve sınırlamaları gözden geçirin:

• İşletim sistemi SKU'su geçiş özelliği PowerShell veya Azure portalı üzerinden kullanılamaz.
• İşletim sistemi SKU'su geçiş özelliği mevcut düğüm havuzlarını yeniden adlandıramaz.
• Ubuntu, Azure Linux ve OS Guard ile Azure Linux desteklenen tek Linux işletim sistemi SKU geçiş hedefleridir.
• OS Guard ile Azure Linux için varsayılan olarak güvenilir başlatma gereklidir, müşterilerin OS Guard ile Azure Linux'a geçiş yapabilmesi için güvenilir başlatmanın etkin olması gerekir. Güvenilen Başlatma mevcut düğüm havuzlarında etkinleştirilemediğinden, bunun için yeni düğüm havuzu oluşturulması gerekebilir.
• Desteklenen bir Gen 1 görüntüsü olmadığından, yalnızca 1. Nesil VM boyutlarını kullanan müşteriler OS Guard ile Azure Linux'a geçiş yapamayacaktır. 2. nesil'i destekleyen vm boyutuna sahip yeni düğüm havuzları oluşturmaları gerekir.
• Etkinleştirilmiş UseGPUDedicatedVHD ile bir Ubuntu işletim sistemi SKU'su, işletim sistemi SKU geçişi gerçekleştiremez.
• CVM 20.04 etkinleştirilmiş bir Ubuntu işletim sistemi SKU'su işletim sistemi SKU geçişi gerçekleştiremez.
• Kata'nın etkinleştirildiği düğüm havuzları işletim sistemi SKU geçişi gerçekleştiremez.
• Windows işletim sistemi SKU geçişi desteklenmez.
• Mariner'dan Azure Linux'a işletim sistemi SKU geçişi desteklenir, ancak Mariner'a geri dönme desteklenmez.

Önkoşullar

• En az bir Ubuntu düğüm havuzuna sahip mevcut bir AKS kümesi.
• Azure Linux kümesini geliştirme/üretim ortamında dağıtarak ve hizmetinizin sağlıklı kaldığını doğrulayarak, işletim sistemi SKU geçiş özelliğini kullanmaya çalışmadan önce iş yüklerinizin Azure Linux kapsayıcı konağında doğru şekilde yapılandırıldığından ve başarıyla çalıştığından emin olmanız önerilir.
• İşlemi bir üretim kümesinde kullanmadan önce test/geliştirme aşamasında geçiş özelliğinin sizin için çalıştığından emin olun.
• Podlarınızın, YÜKSELTME sırasında AKS'nin podları VM'ler arasında taşımasına izin vermek için yeterli Pod Kesinti Bütçesine sahip olduğundan emin olun.
• Azure CLI sürüm 2.61.0 veya üzeri 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.
• Terraform kullanıyorsanız AzureRM Terraform modülünün v3.111.0 veya üzeri bir sürümünü kullanmanız gerekir.

Azure CLI

Ubuntu düğüm havuzunuzun işletim sistemi SKU'sunu değiştirin

• komutunu kullanarak düğüm havuzunuzun işletim sistemi SKU'sunu Azure Linux'a az aks nodepool update geçirin. Bu komut, düğüm havuzunuzun işletim sistemi SKU'sunu Ubuntu'dan Azure Linux'a güncelleştirir. İşletim sistemi SKU'su değişikliği, tamamlanması birkaç dakika süren anında bir yükseltme işlemini tetikler.

az aks nodepool update --resource-group $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --name $NODE_POOL_NAME --os-sku AzureLinux

Sonuçlar:

{
  "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.ContainerService/managedClusters/myAKSCluster/nodePools/nodepool1",
  "name": "nodepool1",
  "osSku": "AzureLinux",
  "provisioningState": "Succeeded"
}

Not

İşletim sistemi SKU geçişi sırasında sorunlarla karşılaşırsanız önceki işletim sistemi SKU'nuza geri dönebilirsiniz.

ARM şablonu

Örnek ARM şablonları

0base.json

 {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.ContainerService/managedClusters",
      "apiVersion": "2023-07-01",
      "name": "akstestcluster",
      "location": "[resourceGroup().location]",
      "tags": {
        "displayname": "Demo of AKS Nodepool Migration"
      },
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "enableRBAC": true,
        "dnsPrefix": "testcluster",
        "agentPoolProfiles": [
          {
            "name": "testnp",
            "count": 3,
            "vmSize": "Standard_D4a_v4",
            "osType": "Linux",
            "osSku": "Ubuntu",
            "mode": "System"
          }
        ]
      }
    }
  ]
}

1mcupdate.json

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.ContainerService/managedClusters",
      "apiVersion": "2023-07-01",
      "name": "akstestcluster",
      "location": "[resourceGroup().location]",
      "tags": {
        "displayname": "Demo of AKS Nodepool Migration"
      },
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "enableRBAC": true,
        "dnsPrefix": "testcluster",
        "agentPoolProfiles": [
          {
            "name": "testnp",
            "osType": "Linux",
            "osSku": "AzureLinux",
            "mode": "System"
          }
        ]
      }
    }
  ]
} 

2apupdate.json

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "apiVersion": "2023-07-01",
      "type": "Microsoft.ContainerService/managedClusters/agentPools",
      "name": "akstestcluster/testnp",
      "location": "[resourceGroup().location]",
      "properties": {
        "osType": "Linux",
        "osSku": "Ubuntu",
        "mode": "System"
      }
    }
  ]
}

Test kümesi dağıtın

1. komutunu kullanarak az group create test kümesi için bir kaynak grubu oluşturun.

   az group create --name testRG --location eastus
   

2. komutunu ve 0base.json örnek ARM şablonunu kullanarak az deployment group create üç düğümle bir temel Ubuntu OS SKU kümesi dağıtın.

   az deployment group create --resource-group testRG --template-file 0base.json
   

3. komutunu kullanarak sistem düğümü havuzunuzun işletim sistemi SKU'sunu Azure Linux'a az deployment group create geçirin.

   az deployment group create --resource-group testRG --template-file 1mcupdate.json
   

4. komutunu kullanarak sistem düğümü havuzunuzun işletim sistemi SKU'sunu Ubuntu'ya geri geçirin az deployment group create .

   az deployment group create --resource-group testRG --template-file 2apupdate.json
   

Terraform

Örnek Terraform şablonu

1. Dosyanızın providers.tf Azure sağlayıcısının gerekli sürümünü alacak şekilde güncelleştirildiğini onaylayın.

providers.tf

terraform {
      required_version = ">=1.0"

      required_providers {
        azurerm = {
          source  = "hashicorp/azurerm"
          version = "~>3.111.0"
        }
        random = {
          source  = "hashicorp/random"
          version = "~>3.0"
        }
      }
    }

    provider "azurerm" {
      features {}
    }

2. Kısa olması için, aşağıda yalnızca Terraform şablonunun ilgilendiği kod parçacığı görüntülenir. Bu ilk yapılandırmada, Ubuntu ile os_sku düğüm havuzuna sahip bir AKS kümesi dağıtılır.

base.tf

resource "azurerm_kubernetes_cluster" "k8s" {
  location            = azurerm_resource_group.rg.location
  name                = var.cluster_name
  resource_group_name = azurerm_resource_group.rg.name
  dns_prefix          = var.dns_prefix
  tags                = {
    Environment = "Development"
  }

  default_node_pool {
    name       = "azurelinuxpool"
    vm_size    = "Standard_D2_v2"
    node_count = var.agent_count
    os_sku = "Ubuntu"
  }
  linux_profile {
    admin_username = "azurelinux"

    ssh_key {
      key_data = file(var.ssh_public_key)
    }
  }
  network_profile {
    network_plugin    = "kubenet"
    load_balancer_sku = "standard"
  }
  service_principal {
    client_id     = var.aks_service_principal_app_id
    client_secret = var.aks_service_principal_client_secret
  }
}

3. Yerinde işletim sistemi SKU geçişi çalıştırmak için os_sku dosyasını AzureLinux olarak değiştirin ve Terraform planını yeniden uygulayın.

update.tf

resource "azurerm_kubernetes_cluster" "k8s" {
  location            = azurerm_resource_group.rg.location
  name                = var.cluster_name
  resource_group_name = azurerm_resource_group.rg.name
  dns_prefix          = var.dns_prefix
  tags                = {
    Environment = "Development"
  }

  default_node_pool {
    name       = "azurelinuxpool"
    vm_size    = "Standard_D2_v2"
    node_count = var.agent_count
    os_sku = "AzureLinux"
  }
  linux_profile {
    admin_username = "azurelinux"

    ssh_key {
      key_data = file(var.ssh_public_key)
    }
  }
  network_profile {
    network_plugin    = "kubenet"
    load_balancer_sku = "standard"
  }
  service_principal {
    client_id     = var.aks_service_principal_app_id
    client_secret = var.aks_service_principal_client_secret
  }
}

İşletim sistemi SKU geçişini doğrulama

Test kümelerinizde geçiş tamamlandıktan sonra, geçişin başarılı olduğundan emin olmak için aşağıdakileri doğrulamanız gerekir:

• Geçiş hedefiniz Azure Linux ise komutunu çalıştırın kubectl get nodes -o wide . Çıktıda, Microsoft Azure Linux 3.0 işletim sistemi imajı olarak ve .azl3 çekirdek sürümünüzün sonunda görünmelidir.
• kubectl get pods -o wide -A Tüm podlarınızın ve daemonset'lerinizin yeni düğüm havuzunda çalıştığını doğrulamak için komutunu çalıştırın.
• kubectl get nodes --show-labels Yükseltilmiş düğüm havuzunuzdaki tüm düğüm etiketlerinin beklediğiniz gibi olduğunu doğrulamak için komutunu çalıştırın.

İpucu

Üretim kümelerinizi geçirmeden önce hizmetinizin durumunu birkaç hafta izlemenizi öneririz.

Üretim kümelerinizde işletim sistemi SKU geçişini çalıştırma

1. Mevcut şablonlarınızı OSSKU=AzureLinux ayarlamak için güncelleyin. ARM şablonlarında "OSSKU": "AzureLinux" bölümünde agentPoolProfile kullanırsınız. Bicep'te osSku: "AzureLinux" bölümünde agentPoolProfile kullanırsınız. Son olarak, Terraform için os_sku = "AzureLinux" bölümünde default_node_pool kullanırsınız. apiVersion ayarının 2023-07-01 veya daha sonrası olduğundan emin olun.
2. Yeni OSSKU ayarı uygulamak için ARM, Bicep veya Terraform şablonunuzu küme için yeniden dağıtın. Bu dağıtım sırasında kümeniz bir düğüm görüntüsü yükseltmesi alıyor gibi davranır. Kümeniz kapasiteyi artırır ve ardından mevcut düğümlerinizi yeni işletim sistemi SKU'nuzdan en son AKS görüntüsüne tek tek yeniden başlatır.

Geri alma

İşletim sistemi SKU geçişi sırasında sorunlarla karşılaşırsanız önceki işletim sistemi SKU'nuza geri dönebilirsiniz. Bunu yapmak için, şablonunuzdaki işletim sistemi SKU'su alanını değiştirmeniz ve dağıtımı yeniden göndermeniz gerekir; bu da başka bir yükseltme işlemini tetikler ve düğüm havuzunu önceki işletim sistemi SKU'sunun geri yükler.

Not

İşletim sistemi SKU geçişi, Mariner adlı işletim sistemi SKU'suna geri dönmeyi desteklemez.

• komutunu kullanarak önceki işletim sistemi SKU'nuza geri dönün az aks nodepool update . Bu komut, düğüm havuzunuzun işletim sistemi SKU'sunu Azure Linux'tan Ubuntu'ya geri güncelleştirir.

Sonraki adımlar

Bu kılavuzda, mevcut düğümleri aşağıdaki yöntemlerden birini kullanarak Azure Linux'a geçirdiniz:

• Mevcut düğüm havuzlarını kaldırın ve yeni Azure Linux düğüm havuzları ekleyin.
• Yerinde OS SKU geçişi.

Sonraki öğreticide, kümelerinizi izlemek için telemetriyi etkinleştirmeyi öğreneceksiniz.

Telemetriyi ve izlemeyi etkinleştirme