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

Makale
10/17/2024

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 işletim sistemi SKU geçişi.

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

Ö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 olarak en az bir tane --mode Systemeklemeniz 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

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.
```
az aks nodepool add --resource-group <resource-group-name> --cluster-name <cluster-name> --name <node-pool-name> --mode System --os-sku AzureLinux
```

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

az aks nodepool delete --resource-group <resource-group-name> --cluster-name <cluster-name> --name <node-pool-name>

Yerinde işletim sistemi 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 ve Azure Linux desteklenen tek Linux işletim sistemi SKU geçiş hedefleridir.
Etkin Ubuntu işletim sistemi SKU'su UseGPUDedicatedVHD , 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.
Geliştirme/üretim ortamında bir Azure Linux kümesi dağıtarak ve hizmetinizin iyi durumda kaldığını doğrulayarak işletim sistemi SKU geçiş özelliğini kullanmaya çalışmadan önce iş yüklerinizin Azure Linux kapsayıcı konağından başarıyla yapılandırıldığından ve ç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.

Ubuntu düğüm havuzunuzun işletim sistemi SKU'su geçirme

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-name> --cluster-name <cluster-name> --name <node-pool-name> --os-sku AzureLinux
```
Not

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

Ö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ğıtma

komutunu kullanarak az group create test kümesi için bir kaynak grubu oluşturun.
```
az group create --name testRG --location eastus
```
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
```
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
```
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
```

Örnek Terraform şablonu

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 {}
    }

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
  }
}

Yerinde işletim sistemi SKU geçişi çalıştırmak için os_sku 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 . Çıkış, işletim sistemi görüntünüz olarak ve .cm2 çekirdek sürümünüzün sonunda gösterilmelidirCBL-Mariner/Linux.
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

Ayarlamak OSSKU=AzureLinuxiçin mevcut şablonlarınızı güncelleştirin. ARM şablonlarında agentPoolProfile bölümünde kullanırsınız"OSSKU: "AzureLinux". Bicep'te agentPoolProfile bölümünde kullanırsınızosSku: "AzureLinux". Son olarak Terraform için bölümünde kullanırsınız "os_sku = "AzureLinux" default_node_pool . veya apiVersion daha sonra olarak ayarlandığından 2023-07-01 emin olun.
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, işletim sistemi SKU Mariner'a 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.
```
az aks nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name mynodepool --os-sku Ubuntu
```

Sonraki adımlar

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

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

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

Telemetriyi ve izlemeyi etkinleştirme

Aracılığıyla paylaş

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

Önkoşullar

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

Yerinde işletim sistemi SKU geçişi

Sınırlamalar

Önkoşullar

Ubuntu düğüm havuzunuzun işletim sistemi SKU'su geçirme

Örnek ARM şablonları

0base.json

1mcupdate.json

2apupdate.json

Test kümesi dağıtma

Örnek Terraform şablonu

providers.tf

base.tf

update.tf

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

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

Geri alma

Sonraki adımlar

Geri Bildirim

Ek kaynaklar