Tutorial: Memigrasikan simpul ke Azure Linux

Artikel
10/17/2024

Dalam tutorial ini, bagian tiga dari lima, Anda memigrasikan simpul yang ada ke Azure Linux. Anda dapat memigrasikan simpul yang ada ke Azure Linux menggunakan salah satu metode berikut:

Hapus kumpulan simpul yang ada dan tambahkan kumpulan simpul Azure Linux baru.
Migrasi SKU OS di tempat.

Jika Anda tidak memiliki simpul yang ada untuk bermigrasi ke Azure Linux, lewati ke tutorial berikutnya. Dalam tutorial selanjutnya, Anda mempelajari cara mengaktifkan telemetri dan pemantauan di kluster Anda dan meningkatkan simpul Azure Linux.

Prasyarat

Dalam tutorial sebelumnya, Anda membuat dan menyebarkan Azure Linux Container Host untuk kluster AKS. Untuk menyelesaikan tutorial ini, Anda perlu menambahkan kumpulan simpul Linux Azure ke kluster yang ada. Jika Anda belum melakukan langkah ini dan ingin mengikutinya, mulailah dengan Tutorial 2: Tambahkan kumpulan simpul Linux Azure ke kluster AKS yang ada.

Catatan

Saat menambahkan kumpulan simpul Linux Azure baru, Anda perlu menambahkan setidaknya satu sebagai --mode System. Jika tidak, AKS tidak akan memungkinkan Anda menghapus kumpulan simpul yang ada.
Anda memerlukan versi terbaru Azure CLI. Jalankan az --version untuk menemukan versinya. Jika Anda perlu memasang atau meningkatkan, lihat Memasang Azure CLI.

Menambahkan kumpulan simpul Azure Linux dan menghapus kumpulan simpul yang ada

Tambahkan kumpulan simpul Linux Azure baru menggunakan az aks nodepool add perintah . Perintah ini menambahkan kumpulan simpul baru ke kluster Anda dengan --mode System bendera , yang menjadikannya kumpulan simpul sistem. Kumpulan simpul sistem diperlukan untuk kluster Azure Linux.
```
az aks nodepool add --resource-group <resource-group-name> --cluster-name <cluster-name> --name <node-pool-name> --mode System --os-sku AzureLinux
```

Hapus simpul yang ada menggunakan az aks nodepool delete perintah .

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

Migrasi SKU OS di tempat

Anda sekarang dapat memigrasikan kumpulan simpul Ubuntu yang ada ke Azure Linux dengan mengubah SKU OS kumpulan simpul, yang menggulung kluster melalui proses peningkatan gambar simpul standar. Fitur baru ini tidak memerlukan pembuatan kumpulan simpul baru.

Batasan

Ada beberapa pengaturan yang dapat memblokir permintaan migrasi SKU OS. Untuk memastikan keberhasilan migrasi, tinjau panduan dan batasan berikut:

Fitur migrasi SKU OS tidak tersedia melalui PowerShell atau portal Azure.
Fitur migrasi SKU OS tidak dapat mengganti nama kumpulan simpul yang ada.
Ubuntu dan Azure Linux adalah satu-satunya target migrasi SKU OS Linux yang didukung.
SKU OS Ubuntu dengan UseGPUDedicatedVHD diaktifkan tidak dapat melakukan migrasi SKU OS.
SKU OS Ubuntu dengan CVM 20.04 diaktifkan tidak dapat melakukan migrasi SKU OS.
Kumpulan simpul dengan Kata diaktifkan tidak dapat melakukan migrasi SKU OS.
Migrasi SKU OS Windows tidak didukung.
Migrasi SKU OS dari Mariner ke Azure Linux didukung, tetapi mengembalikan ke Mariner tidak didukung.

Prasyarat

Kluster AKS yang ada dengan setidaknya satu kumpulan simpul Ubuntu.
Kami menyarankan agar Anda memastikan beban kerja Anda mengonfigurasi dan berjalan dengan sukses pada host kontainer Azure Linux sebelum mencoba menggunakan fitur migrasi SKU OS dengan menyebarkan kluster Azure Linux di dev/prod dan memverifikasi layanan Anda tetap sehat.
Pastikan fitur migrasi berfungsi untuk Anda dalam pengujian/dev sebelum menggunakan proses pada kluster produksi.
Pastikan pod Anda memiliki Anggaran Gangguan Pod yang cukup untuk memungkinkan AKS memindahkan pod antar VM selama peningkatan.
Anda memerlukan Azure CLI versi 2.61.0 atau yang lebih tinggi. Jalankan az --version untuk menemukan versinya. Jika Anda perlu memasang atau meningkatkan, lihat Memasang Azure CLI.
Jika Anda menggunakan Terraform, Anda harus memiliki v3.111.0 atau yang lebih besar dari modul Terraform AzureRM.

Memigrasikan SKU OS kumpulan simpul Ubuntu Anda

Migrasikan SKU OS kumpulan simpul Anda ke Azure Linux menggunakan az aks nodepool update perintah . Perintah ini memperbarui SKU OS untuk kumpulan simpul Anda dari Ubuntu ke Azure Linux. Perubahan SKU OS memicu operasi peningkatan segera, yang membutuhkan waktu beberapa menit untuk diselesaikan.
```
az aks nodepool update --resource-group <resource-group-name> --cluster-name <cluster-name> --name <node-pool-name> --os-sku AzureLinux
```
Catatan

Jika Anda mengalami masalah selama migrasi SKU OS, Anda dapat kembali ke SKU OS Anda sebelumnya.

Contoh templat ARM

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

Menyebarkan kluster pengujian

Buat grup sumber daya untuk kluster pengujian menggunakan az group create perintah .
```
az group create --name testRG --location eastus
```
Sebarkan kluster SKU OS Ubuntu dasar dengan tiga simpul menggunakan az deployment group create perintah dan contoh 0base.json templat ARM.
```
az deployment group create --resource-group testRG --template-file 0base.json
```
Migrasikan SKU OS kumpulan simpul sistem Anda ke Azure Linux menggunakan az deployment group create perintah .
```
az deployment group create --resource-group testRG --template-file 1mcupdate.json
```
Migrasikan SKU OS kumpulan simpul sistem Anda kembali ke Ubuntu menggunakan az deployment group create perintah .
```
az deployment group create --resource-group testRG --template-file 2apupdate.json
```

Contoh templat Terraform

Konfirmasikan bahwa file Anda providers.tf diperbarui untuk mengambil versi penyedia Azure yang diperlukan.

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

Untuk brevity, hanya cuplikan templat Terraform yang menarik yang ditampilkan di bawah ini. Dalam konfigurasi awal ini, kluster AKS dengan nodepool os_sku dengan Ubuntu disebarkan.

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

Untuk menjalankan migrasi SKU OS di tempat, cukup ganti os_sku ke AzureLinux dan terapkan kembali paket Terraform.

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

Memverifikasi migrasi SKU OS

Setelah migrasi selesai pada kluster pengujian, Anda harus memverifikasi hal berikut untuk memastikan keberhasilan migrasi:

Jika target migrasi Anda adalah Azure Linux, jalankan kubectl get nodes -o wide perintah . Output akan ditampilkan CBL-Mariner/Linux sebagai gambar OS Anda dan .cm2 di akhir versi kernel Anda.
Jalankan kubectl get pods -o wide -A perintah untuk memverifikasi bahwa semua pod dan daemonset Anda berjalan pada kumpulan simpul baru.
Jalankan kubectl get nodes --show-labels perintah untuk memverifikasi bahwa semua label simpul di kumpulan simpul yang ditingkatkan adalah apa yang Anda harapkan.

Tip

Sebaiknya pantau kesehatan layanan Anda selama beberapa minggu sebelum memigrasikan kluster produksi Anda.

Menjalankan migrasi SKU OS pada kluster produksi Anda

Perbarui templat yang sudah ada untuk mengatur OSSKU=AzureLinux. Di templat ARM, Anda menggunakan "OSSKU: "AzureLinux" di bagian .agentPoolProfile Di Bicep, Anda menggunakan osSku: "AzureLinux" di bagian .agentPoolProfile Terakhir, untuk Terraform, Anda gunakan "os_sku = "AzureLinux" di bagian .default_node_pool Pastikan Anda apiVersion diatur ke 2023-07-01 atau yang lebih baru.
Sebarkan ulang templat ARM, Bicep, atau Terraform Anda agar kluster menerapkan pengaturan baru OSSKU . Selama penyebaran ini, kluster Anda bertingkah seolah-olah mengambil peningkatan gambar simpul. Kluster Anda melonjak kapasitas, lalu me-reboot simpul yang ada satu per satu ke gambar AKS terbaru dari SKU OS baru Anda.

Pemulihan

Jika Anda mengalami masalah selama migrasi SKU OS, Anda dapat kembali ke SKU OS Anda sebelumnya. Untuk melakukan ini, Anda perlu mengubah bidang SKU OS di templat Anda dan mengirim ulang penyebaran, yang memicu operasi peningkatan lain dan memulihkan kumpulan simpul ke SKU OS sebelumnya.

Catatan

Migrasi SKU OS tidak mendukung pengguliran kembali ke OS SKU Mariner.

Kembali ke SKU OS Anda sebelumnya menggunakan az aks nodepool update perintah . Perintah ini memperbarui SKU OS untuk kumpulan simpul Anda dari Azure Linux kembali ke Ubuntu.
```
az aks nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name mynodepool --os-sku Ubuntu
```

Langkah berikutnya

Dalam tutorial ini, Anda memigrasikan simpul yang ada ke Azure Linux menggunakan salah satu metode berikut:

Hapus kumpulan simpul yang ada dan tambahkan kumpulan simpul Azure Linux baru.
Migrasi SKU OS di tempat.

Dalam tutorial berikutnya, Anda mempelajari cara mengaktifkan telemetri untuk memantau kluster Anda.

Mengaktifkan telemetri dan pemantauan

Bagikan melalui

Tutorial: Memigrasikan simpul ke Azure Linux

Prasyarat

Menambahkan kumpulan simpul Azure Linux dan menghapus kumpulan simpul yang ada

Migrasi SKU OS di tempat

Batasan

Prasyarat

Memigrasikan SKU OS kumpulan simpul Ubuntu Anda

Contoh templat ARM

0base.json

1mcupdate.json

2apupdate.json

Menyebarkan kluster pengujian

Contoh templat Terraform

providers.tf

base.tf

update.tf

Memverifikasi migrasi SKU OS

Menjalankan migrasi SKU OS pada kluster produksi Anda

Pemulihan

Langkah berikutnya

Saran dan Komentar

Sumber Daya Tambahan: