Samouczek: migrowanie węzłów do platformy Azure z systemem Linux

W tym samouczku, część trzecia z pięciu, przeprowadzisz migrację istniejących węzłów do systemu Azure Linux. Istniejące węzły można migrować do systemu Azure Linux przy użyciu jednej z następujących metod:

• Usuń istniejące pule węzłów i dodaj nowe pule węzłów systemu Linux platformy Azure.
• Migracja jednostki SKU systemu operacyjnego w miejscu.

Jeśli nie masz żadnych istniejących węzłów do migracji do systemu Azure Linux, przejdź do następnego samouczka. W kolejnych samouczkach dowiesz się, jak włączyć telemetrię i monitorowanie w klastrach oraz uaktualnić węzły systemu Linux platformy Azure.

Wymagania wstępne

• W poprzednich samouczkach utworzono i wdrożono hosta kontenera systemu Linux platformy Azure dla klastra usługi AKS. Aby ukończyć ten samouczek, musisz dodać pulę węzłów systemu Linux platformy Azure do istniejącego klastra. Jeśli nie wykonano tego kroku i chcesz wykonać te czynności, zacznij od samouczka 2: Dodawanie puli węzłów systemu Linux platformy Azure do istniejącego klastra usługi AKS.

  Uwaga

  Podczas dodawania nowej puli węzłów systemu Linux platformy Azure należy dodać co najmniej jedną pulę węzłów jako --mode System. W przeciwnym razie usługa AKS nie umożliwi usunięcia istniejącej puli węzłów.

• Potrzebna jest najnowsza wersja interfejsu wiersza polecenia platformy Azure. Uruchom polecenie az --version, aby dowiedzieć się, jaka wersja jest używana. Jeśli konieczna będzie instalacja lub uaktualnienie, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.

Dodawanie pul węzłów systemu Linux platformy Azure i usuwanie istniejących pul węzłów

1. Dodaj nową pulę węzłów systemu Linux platformy Azure przy użyciu az aks nodepool add polecenia . To polecenie dodaje nową pulę węzłów do klastra z --mode System flagą , co sprawia, że jest to pula węzłów systemowych. Pule węzłów systemowych są wymagane dla klastrów systemu Linux platformy Azure.

   az aks nodepool add --resource-group <resource-group-name> --cluster-name <cluster-name> --name <node-pool-name> --mode System --os-sku AzureLinux
   

2. Usuń istniejące węzły przy użyciu az aks nodepool delete polecenia .

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

Migracja jednostki SKU systemu operacyjnego w miejscu

Teraz można migrować istniejące pule węzłów systemu Ubuntu do systemu Linux platformy Azure, zmieniając jednostkę SKU systemu operacyjnego puli węzłów, która przenosi klaster za pomocą standardowego procesu uaktualniania obrazu węzła. Ta nowa funkcja nie wymaga tworzenia nowych pul węzłów.

Ograniczenia

Istnieje kilka ustawień, które mogą blokować żądanie migracji jednostki SKU systemu operacyjnego. Aby zapewnić pomyślną migrację, zapoznaj się z następującymi wytycznymi i ograniczeniami:

• Funkcja migracji jednostki SKU systemu operacyjnego nie jest dostępna za pośrednictwem programu PowerShell ani witryny Azure Portal.
• Funkcja migracji jednostki SKU systemu operacyjnego nie może zmienić nazwy istniejących pul węzłów.
• Systemy Ubuntu i Azure Linux są jedynymi obsługiwanymi celami migracji jednostek SKU systemu operacyjnego Linux.
• Jednostka SKU systemu operacyjnego Ubuntu z włączoną UseGPUDedicatedVHD obsługą nie może przeprowadzić migracji jednostki SKU systemu operacyjnego.
• Jednostka SKU systemu operacyjnego Ubuntu z włączoną funkcją CVM 20.04 nie może przeprowadzić migracji jednostki SKU systemu operacyjnego.
• Pule węzłów z włączonym programem Kata nie mogą przeprowadzić migracji jednostki SKU systemu operacyjnego.
• Migracja jednostek SKU systemu operacyjnego Windows nie jest obsługiwana.
• Migracja jednostki SKU systemu operacyjnego z platformy Mariner do platformy Azure z systemem Linux jest obsługiwana, ale wycofywanie z platformy Mariner nie jest obsługiwane.

Wymagania wstępne

• Istniejący klaster usługi AKS z co najmniej jedną pulą węzłów systemu Ubuntu.
• Zalecamy upewnienie się, że obciążenia zostały skonfigurowane i uruchomione pomyślnie na hoście kontenera systemu Linux platformy Azure przed podjęciem próby użycia funkcji migracji jednostki SKU systemu operacyjnego przez wdrożenie klastra systemu Linux platformy Azure w środowisku deweloperskim/prod i sprawdzenie, czy usługa pozostaje w dobrej kondycji.
• Przed użyciem procesu w klastrze produkcyjnym upewnij się, że funkcja migracji działa dla Ciebie w środowisku testowym/deweloperskim.
• Upewnij się, że zasobniki mają wystarczający budżet zakłóceń zasobników, aby umożliwić usłudze AKS przenoszenie zasobników między maszynami wirtualnymi podczas uaktualniania.
• Potrzebujesz interfejsu wiersza polecenia platformy Azure w wersji 2.61.0 lub nowszej. Uruchom polecenie az --version, aby dowiedzieć się, jaka wersja jest używana. Jeśli konieczna będzie instalacja lub uaktualnienie, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.
• Jeśli używasz narzędzia Terraform, musisz mieć moduł Terraform w wersji 3.111.0 lub nowszej.

Interfejs wiersza polecenia platformy Azure

Migrowanie jednostki SKU systemu operacyjnego puli węzłów systemu Ubuntu

• Przeprowadź migrację jednostki SKU systemu operacyjnego puli węzłów do systemu Linux platformy az aks nodepool update Azure przy użyciu polecenia . To polecenie aktualizuje jednostkę SKU systemu operacyjnego dla puli węzłów z systemu Ubuntu do systemu Linux. Zmiana jednostki SKU systemu operacyjnego wyzwala natychmiastową operację uaktualniania, która trwa kilka minut.

  az aks nodepool update --resource-group <resource-group-name> --cluster-name <cluster-name> --name <node-pool-name> --os-sku AzureLinux
  

  Uwaga

  Jeśli podczas migracji jednostki SKU systemu operacyjnego wystąpią problemy, możesz przywrócić poprzednią jednostkę SKU systemu operacyjnego.

Szablon usługi ARM

Przykładowe szablony usługi 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"
      }
    }
  ]
}

Wdrażanie klastra testowego

1. Utwórz grupę zasobów dla klastra testowego przy użyciu az group create polecenia .

   az group create --name testRG --location eastus
   

2. Wdróż bazowy klaster jednostki SKU systemu operacyjnego Ubuntu z trzema węzłami przy użyciu az deployment group create polecenia i przykładowego szablonu usługi ARM 0base.json.

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

3. Przeprowadź migrację jednostki SKU systemu operacyjnego puli węzłów systemu do systemu Linux platformy az deployment group create Azure przy użyciu polecenia .

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

4. Przeprowadź migrację jednostki SKU systemu operacyjnego puli węzłów systemu z powrotem do systemu Ubuntu przy użyciu az deployment group create polecenia .

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

Terraform

Przykładowy szablon narzędzia Terraform

1. Upewnij się, że providers.tf plik został zaktualizowany w celu pobrania wymaganej wersji dostawcy platformy Azure.

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. W przypadku zwięzłości poniżej jest wyświetlany tylko fragment kodu szablonu programu Terraform, który jest interesujący. W tej początkowej konfiguracji wdrożono klaster usługi AKS z pulą węzłów os_sku z systemem Ubuntu .

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. Aby uruchomić migrację jednostki SKU systemu operacyjnego w miejscu, zastąp os_sku usługą AzureLinux i ponownie zastosuj plan narzędzia 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
  }
}

Weryfikowanie migracji jednostki SKU systemu operacyjnego

Po zakończeniu migracji w klastrach testowych należy sprawdzić następujące elementy, aby zapewnić pomyślną migrację:

• Jeśli element docelowy migracji to Azure Linux, uruchom kubectl get nodes -o wide polecenie . Dane wyjściowe powinny być wyświetlane CBL-Mariner/Linux jako obraz systemu operacyjnego i .cm2 na końcu wersji jądra.
• Uruchom polecenie , kubectl get pods -o wide -A aby sprawdzić, czy wszystkie zasobniki i demony są uruchomione w nowej puli węzłów.
• Uruchom polecenie , kubectl get nodes --show-labels aby sprawdzić, czy wszystkie etykiety węzłów w uaktualnionej puli węzłów są oczekiwane.

Napiwek

Zalecamy monitorowanie kondycji usługi przez kilka tygodni przed migracją klastrów produkcyjnych.

Uruchamianie migracji jednostki SKU systemu operacyjnego w klastrach produkcyjnych

1. Zaktualizuj istniejące szablony, aby ustawić wartość OSSKU=AzureLinux. W szablonach usługi ARM użyjesz "OSSKU: "AzureLinux" w agentPoolProfile sekcji . W aplikacji Bicep użyjesz osSku: "AzureLinux" w agentPoolProfile sekcji . Na koniec w przypadku programu Terraform należy użyć "os_sku = "AzureLinux" polecenia default_node_pool w sekcji . Upewnij się, że ustawiono apiVersion 2023-07-01 wartość lub nowszą.
2. Ponownie wdróż szablon ARM, Bicep lub Terraform dla klastra, aby zastosować nowe OSSKU ustawienie. Podczas tego wdrażania klaster zachowuje się tak, jakby wykonuje uaktualnienie obrazu węzła. Pojemność klastra zwiększa się, a następnie ponownie uruchamia istniejące węzły po jednym do najnowszego obrazu usługi AKS z nowej jednostki SKU systemu operacyjnego.

Wycofywanie

Jeśli podczas migracji jednostki SKU systemu operacyjnego wystąpią problemy, możesz przywrócić poprzednią jednostkę SKU systemu operacyjnego. W tym celu należy zmienić pole jednostki SKU systemu operacyjnego w szablonie i ponownie przesłać wdrożenie, co spowoduje wyzwolenie kolejnej operacji uaktualniania i przywrócenie puli węzłów do poprzedniej jednostki SKU systemu operacyjnego.

Uwaga

Migracja jednostek SKU systemu operacyjnego nie obsługuje wycofywania do jednostek SKU systemu operacyjnego Mariner.

• Wróć do poprzedniej az aks nodepool update jednostki SKU systemu operacyjnego przy użyciu polecenia . To polecenie aktualizuje jednostkę SKU systemu operacyjnego dla puli węzłów z systemu Linux platformy Azure z powrotem do systemu Ubuntu.

  az aks nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name mynodepool --os-sku Ubuntu
  

Następne kroki

W tym samouczku przeprowadzono migrację istniejących węzłów do systemu Linux platformy Azure przy użyciu jednej z następujących metod:

• Usuń istniejące pule węzłów i dodaj nowe pule węzłów systemu Linux platformy Azure.
• Migracja jednostki SKU systemu operacyjnego w miejscu.

Z następnego samouczka dowiesz się, jak włączyć telemetrię do monitorowania klastrów.

Włączanie telemetrii i monitorowania