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

Makale
02/06/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 (önizleme).

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 (önizleme)

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 Terraform, 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.
Geçiş sırasında AgentPool count alanı değişmemelidir.
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.

Önkoşullar

Uzantıyı aks-previewyükleyin.
Özellik bayrağını OSSKUMigrationPreview aboneliğinize kaydedin.
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 0.5.172 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.

Azure CLI
ARM şablonu

Uzantıyı `aks-preview` yükleme

Önemli

AKS önizleme özellikleri self servis ve kabul temelinde kullanılabilir. Önizlemeler "olduğu gibi" ve "kullanılabilir" olarak sağlanır ve hizmet düzeyi sözleşmelerinin ve sınırlı garantinin dışında tutulur. AKS önizlemeleri, müşteri desteği tarafından kısmen en iyi çaba temelinde 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 komutunu kullanarak uzantıyı az extension add yükleyin.
```
az extension add --name aks-preview
```
komutunu kullanarak en son sürüme sahip olduğunuzdan emin olmak için uzantıyı güncelleştirin az extension update .
```
az extension update --name aks-preview
```

Özellik bayrağını `OSSKUMigrationPreview` kaydetme

OSSKUMigrationPreview komutunu kullanarak aboneliğinizde özellik bayrağını az feature register kaydedin.
```
az feature register --namespace Microsoft.ContainerService --name OSSKUMigrationPreview
```

komutunu kullanarak az feature list kayıt durumunu denetleyin.

az feature list -o table --query "[?contains(name, 'Microsoft.ContainerService/OSSKUMigrationPreview')].{Name:name,State:properties.state}"

Çıkışınız aşağıdaki örnek çıkışa benzer olmalıdır:

Name                                            State
----------------------------------------------  -------
Microsoft.ContainerService/OSSKUMigrationPreview  Registered

komutunu kullanarak az provider register özellik bayrağının OSSKUMigrationPreview kaydını yenileyin.
```
az provider register --namespace Microsoft.ContainerService
```

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
```
1mcupdate.json örnek ARM şablonunda komutunu ve ManagedClusters API'sini az deployment group create kullanarak sistem düğümü havuzunuzun işletim sistemi SKU'sunu Azure Linux'a geçirin.
```
az deployment group create --resource-group testRG --template-file 1mcupdate.json
```
2apupdate.json örnek ARM şablonunda komutunu ve AgentPools API'sini az deployment group create kullanarak sistem düğümü havuzunuzun işletim sistemi SKU'sunu Ubuntu'ya geri geçirin.
```
az deployment group create --resource-group testRG --template-file 2apupdate.json
```

İş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". veya apiVersion daha sonra olarak ayarlandığından 2023-07-01 emin olun.
Yeni OSSKU ayarı uygulamak için ARM ş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.

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 (önizleme).

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

Telemetriyi ve izlemeyi etkinleştirme

Öğ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 (önizleme)

Sınırlamalar

Önkoşullar

Uzantıyı aks-preview yükleme

Özellik bayrağını OSSKUMigrationPreview kaydetme

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

İş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

Ek kaynaklar

Uzantıyı `aks-preview` yükleme

Özellik bayrağını `OSSKUMigrationPreview` kaydetme