البرنامج التعليمي: ترحيل العقد إلى Azure Linux

النشر والاستكشاف

في هذا البرنامج التعليمي، الجزء الثالث من خمسة، تقوم بترحيل العقد الموجودة إلى Azure Linux. يمكنك ترحيل العقد الموجودة إلى Azure Linux باستخدام إحدى الطرق التالية:

• قم بإزالة تجمعات العقد الموجودة وإضافة تجمعات عقد Azure Linux جديدة.
• ترحيل SKU لنظام التشغيل الموضعي.

إذا لم يكن لديك أي عقد موجودة لترحيلها إلى Azure Linux، فانتقل إلى البرنامج التعليمي التالي. في البرامج التعليمية اللاحقة، ستتعلم كيفية تمكين القياس عن بعد والمراقبة في مجموعاتك وترقية عقد Azure Linux.

هام

اعتبارا من 30 نوفمبر 2025، لم تعد خدمة Azure Kubernetes Service (AKS) تدعم أو توفر تحديثات أمان ل Azure Linux 2.0. صورة عقدة Azure Linux 2.0 مجمدة عند إصدار 202512.06.0. ابتداء من 31 مارس 2026، سيتم إزالة صور العقد، ولن تتمكن من توسيع مجموعات العقد الخاصة بك. انتقل إلى نسخة Azure Linux المدعومة عن طريق ترقية مجموعات العقد إلى نسخة Kubernetes مدعومة أو الانتقال إلى osSku AzureLinux3. لمزيد من المعلومات، راجع التقاعد: تجمعات عقد Azure Linux 2.0 على AKS.

المتطلبات الأساسية

• في البرامج التعليمية السابقة، قمت بإنشاء ونشر مضيف حاوية Azure Linux لمجموعة AKS. لإكمال هذا البرنامج التعليمي، تحتاج إلى إضافة تجمع عقدة Azure Linux إلى نظام المجموعة الحالي. إذا لم تكن قد فعلت هذه الخطوة وترغب في المتابعة، فابدأ بالبرنامج التعليمي 2: إضافة تجمع عقدة Azure Linux إلى مجموعة AKS الحالية.

  إشعار

  عند إضافة تجمع عقدة Azure Linux جديد، تحتاج إلى إضافة واحدة على الأقل ك --mode System. وإلا، لن تسمح لك AKS بحذف تجمع العقدة الحالي.

• تحتاج إلى أحدث إصدار من Azure CLI. قم بتشغيل az --version للعثور على الإصدار. إذا كنت بحاجة إلى التثبيت أو الترقية، فراجع تثبيت Azure CLI.

إضافة تجمعات عقد Azure Linux وإزالة تجمعات العقد الموجودة

1. إضافة تجمع عقدة Azure Linux جديد باستخدام az aks nodepool add الأمر . يضيف هذا الأمر تجمع عقدة جديد إلى نظام المجموعة الخاص بك مع العلامة --mode System ، مما يجعله تجمع عقدة نظام. تجمعات عقد النظام مطلوبة لمجموعات Azure Linux.

# 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

النتائج:

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

2. قم بإزالة العقد الموجودة باستخدام az aks nodepool delete الأمر .

ترحيل نظام التشغيل SKU الموضعي

يمكنك الآن ترحيل تجمعات عقدة Ubuntu الحالية إلى Azure Linux عن طريق تغيير نظام التشغيل SKU لتجمع العقدة، والذي يقوم بتدحرج نظام المجموعة من خلال عملية ترقية صورة العقدة القياسية. لا تتطلب هذه الميزة الجديدة إنشاء تجمعات عقد جديدة.

القيود

هناك العديد من الإعدادات التي يمكن أن تمنع طلب ترحيل SKU لنظام التشغيل. لضمان نجاح الترحيل، راجع الإرشادات والقيود التالية:

• لا تتوفر ميزة ترحيل نظام التشغيل SKU من خلال PowerShell أو مدخل Microsoft Azure.
• لا تتمكن ميزة ترحيل نظام التشغيل SKU من إعادة تسمية تجمعات العقد الموجودة.
• Ubuntu وAzure Linux وAzure Linux مع OS Guard هي أهداف ترحيل SKU لنظام التشغيل Linux OS الوحيدة المدعومة.
• التشغيل الموثوق به مطلوب افتراضيا ل Azure Linux مع OS Guard، ويحتاج العملاء إلى تمكين التشغيل الموثوق به ليتمكنوا من الترحيل إلى Azure Linux باستخدام OS Guard. نظرا لأنه لا يمكن تمكين التشغيل الموثوق به على تجمعات العقد الموجودة، فقد يتطلب ذلك إنشاء تجمع عقد جديد.
• لن يتمكن العملاء الذين يستخدمون أحجام الأجهزة الظاهرية Gen 1 فقط من الترحيل إلى Azure Linux باستخدام OS Guard نظرا لعدم وجود صورة Gen 1 مدعومة. سيحتاجون إلى إنشاء تجمعات عقد جديدة بحجم جهاز ظاهري يدعم الجيل 2.
• لا يمكن ل Ubuntu OS SKU مع UseGPUDedicatedVHD تمكين إجراء ترحيل SKU لنظام التشغيل.
• لا يمكن ل Ubuntu OS SKU مع تمكين CVM 20.04 إجراء ترحيل SKU لنظام التشغيل.
• لا يمكن لتجمعات العقد مع تمكين Kata إجراء ترحيل SKU لنظام التشغيل.
• ترحيل Windows OS SKU غير مدعوم.
• يتم دعم ترحيل OS SKU من Mariner إلى Azure Linux، ولكن التراجع إلى Mariner غير مدعوم.

المتطلبات الأساسية

• مجموعة AKS موجودة مع تجمع عقدة Ubuntu واحد على الأقل.
• نوصي بالتأكد من تكوين أحمال العمل الخاصة بك وتشغيلها بنجاح على مضيف حاوية Azure Linux قبل محاولة استخدام ميزة ترحيل SKU لنظام التشغيل عن طريق نشر نظام مجموعة Azure Linux في dev/prod والتحقق من أن الخدمة الخاصة بك لا تزال سليمة.
• تأكد من أن ميزة الترحيل تعمل لك في الاختبار/التطوير قبل استخدام العملية على مجموعة إنتاج.
• تأكد من أن pods الخاصة بك لديها موازنة تعطيل Pod كافية للسماح ل AKS بنقل القرون بين الأجهزة الظاهرية أثناء الترقية.
• تحتاج إلى الإصدار 2.61.0 من Azure CLI أو أعلى. قم بتشغيل az --version للعثور على الإصدار. إذا كنت بحاجة إلى التثبيت أو الترقية، فراجع تثبيت Azure CLI.
• إذا كنت تستخدم Terraform، يجب أن يكون لديك الإصدار 3.111.0 أو أحدث من الوحدة النمطية AzureRM Terraform.

Azure CLI

ترحيل نظام التشغيل SKU لتجمع عقدة Ubuntu

• قم بترحيل OS SKU لتجمع العقدة إلى Azure Linux باستخدام az aks nodepool update الأمر . يحدث هذا الأمر نظام التشغيل SKU لتجمع العقدة من Ubuntu إلى Azure Linux. يؤدي تغيير نظام التشغيل SKU إلى تشغيل عملية ترقية فورية، والتي تستغرق عدة دقائق لإكمالها.

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

النتائج:

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

إشعار

إذا واجهت مشكلات أثناء ترحيل نظام التشغيل SKU، يمكنك العودة إلى نظام التشغيل SKU السابق.

قالب ARM

مثال على قوالب 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"
      }
    }
  ]
}

نشر نظام مجموعة اختبار

1. إنشاء مجموعة موارد لمجموعة الاختبار باستخدام az group create الأمر .

   az group create --name testRG --location eastus
   

2. انشر نظام مجموعة SKU لنظام التشغيل Ubuntu الأساسي مع ثلاث عقد باستخدام az deployment group create الأمر ونموذج ARM 0base.json المثال.

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

3. ترحيل نظام التشغيل SKU لتجمع عقدة النظام الخاص بك إلى Azure Linux باستخدام az deployment group create الأمر .

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

4. ترحيل نظام التشغيل SKU لتجمع عقدة النظام الخاص بك مرة أخرى إلى Ubuntu باستخدام az deployment group create الأمر .

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

Terraform

مثال على قالب Terraform

1. تأكد من تحديث الملف الخاص بك providers.tf لالتقاط الإصدار المطلوب من موفر 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. للإيجاز، يتم عرض مقتطف قالب Terraform الذي يهمك فقط أدناه. في هذا التكوين الأولي، يتم نشر مجموعة AKS مع nodepool من os_sku مع 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. لتشغيل ترحيل SKU لنظام التشغيل الموضعي، ما عليك سوى استبدال os_sku ب AzureLinux وإعادة تطبيق خطة 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
  }
}

تحقق من ترحيل نظام التشغيل SKU

بمجرد اكتمال الترحيل على مجموعات الاختبار الخاصة بك، يجب التحقق مما يلي لضمان نجاح الترحيل:

• إذا كان هدف الترحيل الخاص بك هو Azure Linux، فقم kubectl get nodes -o wide بتشغيل الأمر . يجب أن يظهر Microsoft Azure Linux 3.0 الإخراج كصورة نظام التشغيل الخاص بك وفي .azl3 نهاية إصدار kernel الخاص بك.
• kubectl get pods -o wide -A قم بتشغيل الأمر للتحقق من تشغيل كافة القرون و daemonsets على تجمع العقدة الجديد.
• kubectl get nodes --show-labels قم بتشغيل الأمر للتحقق من أن جميع تسميات العقدة في تجمع العقدة التي تمت ترقيتها هي ما تتوقعه.

تلميح

نوصي بمراقبة صحة الخدمة الخاصة بك لمدة أسبوعين قبل ترحيل مجموعات الإنتاج الخاصة بك.

تشغيل ترحيل OS SKU على مجموعات الإنتاج الخاصة بك

1. قم بتحديث القوالب الموجودة لتعيين OSSKU=AzureLinux. في قوالب ARM، يمكنك استخدام "OSSKU": "AzureLinux" في agentPoolProfile القسم . في Bicep، يمكنك استخدام osSku: "AzureLinux" في agentPoolProfile القسم . وأخيرا، بالنسبة إلى Terraform، يمكنك استخدام os_sku = "AzureLinux" في default_node_pool القسم . تأكد من تعيين apiVersion إلى 2023-07-01 أو إصدار أحدث.
2. أعد نشر قالب ARM أو Bicep أو Terraform لنظام المجموعة لتطبيق الإعداد الجديد OSSKU . أثناء هذا التوزيع، يتصرف نظام المجموعة كما لو أنه يأخذ ترقية صورة عقدة. يقوم نظام المجموعة الخاص بك بتكريس السعة، ثم إعادة تشغيل العقد الموجودة واحدا تلو الآخر في أحدث صورة AKS من نظام التشغيل SKU الجديد.

العودة إلى الحالة السابقة

إذا واجهت مشكلات أثناء ترحيل نظام التشغيل SKU، يمكنك العودة إلى نظام التشغيل SKU السابق. للقيام بذلك، تحتاج إلى تغيير حقل OS SKU في القالب الخاص بك وإعادة إرسال النشر، والذي يؤدي إلى عملية ترقية أخرى ويستعيد تجمع العقدة إلى وحدة SKU لنظام التشغيل السابقة الخاصة به.

إشعار

لا يدعم ترحيل نظام التشغيل SKU العودة إلى OS SKU Mariner.

• العودة إلى نظام التشغيل SKU السابق باستخدام az aks nodepool update الأمر . يقوم هذا الأمر بتحديث نظام التشغيل SKU لتجمع العقدة من Azure Linux مرة أخرى إلى Ubuntu.

الخطوات التالية

في هذا البرنامج التعليمي، قمت بترحيل العقد الموجودة إلى Azure Linux باستخدام إحدى الطرق التالية:

• قم بإزالة تجمعات العقد الموجودة وإضافة تجمعات عقد Azure Linux جديدة.
• ترحيل SKU لنظام التشغيل الموضعي.

في البرنامج التعليمي التالي، ستتعلم كيفية تمكين القياس عن بعد لمراقبة مجموعاتك.

تمكين القياس عن بعد والمراقبة