Служба Azure Kubernetes (AKS) для расширенных зон (предварительная версия)

Для указания желаемой зоны Azure Extended в шаблоне ARM, используйте параметр extendedLocation.

"extendedLocation": {
    "name": "<extended-zone-id>",
    "type": "EdgeZone",
},

Следующий шаблон ARM развертывает новый кластер в расширенной зоне Azure.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.9.1.41621",
      "templateHash": "2637152180661081755"
    }
  },
  "parameters": {
    "clusterName": {
      "type": "string",
      "defaultValue": "myAKSCluster",
      "metadata": {
        "description": "The name of the Managed Cluster resource."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "The location of the Managed Cluster resource."
      }
    },
    "edgeZoneName": {
      "type": "String",
      "metadata": {
        "description": "The name of the Azure Extended Zone"
      }
    },
    "dnsPrefix": {
      "type": "string",
      "metadata": {
        "description": "Optional DNS prefix to use with hosted Kubernetes API server FQDN."
      }
    },
    "osDiskSizeGB": {
      "type": "int",
      "defaultValue": 0,
      "maxValue": 1023,
      "minValue": 0,
      "metadata": {
        "description": "Disk size (in GB) to provision for each of the agent pool nodes. This value ranges from 0 to 1023. Specifying 0 will apply the default disk size for that agentVMSize."
      }
    },
    "agentCount": {
      "type": "int",
      "defaultValue": 3,
      "maxValue": 50,
      "minValue": 1,
      "metadata": {
        "description": "The number of nodes for the cluster."
      }
    },
    "agentVMSize": {
      "type": "string",
      "defaultValue": "standard_d2s_v3",
      "metadata": {
        "description": "The size of the Virtual Machine."
      }
    },
    "linuxAdminUsername": {
      "type": "string",
      "metadata": {
        "description": "User name for the Linux Virtual Machines."
      }
    },
    "sshRSAPublicKey": {
      "type": "string",
      "metadata": {
        "description": "Configure all linux machines with the SSH RSA public key string. Your key should include three parts, for example 'ssh-rsa AAAAB...snip...UcyupgH azureuser@linuxvm'"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.ContainerService/managedClusters",
      "apiVersion": "2022-05-02-preview",
      "name": "[parameters('clusterName')]",
      "location": "[parameters('location')]",
      "extendedLocation": {
        "name": "[parameters('edgeZoneName')]",
        "type": "EdgeZone"
      }
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "dnsPrefix": "[parameters('dnsPrefix')]",
        "agentPoolProfiles": [
          {
            "name": "agentpool",
            "osDiskSizeGB": "[parameters('osDiskSizeGB')]",
            "count": "[parameters('agentCount')]",
            "vmSize": "[parameters('agentVMSize')]",
            "osType": "Linux",
            "mode": "System"
          }
        ],
        "linuxProfile": {
          "adminUsername": "[parameters('linuxAdminUsername')]",
          "ssh": {
            "publicKeys": [
              {
                "keyData": "[parameters('sshRSAPublicKey')]"
              }
            ]
          }
        }
      }
    }
  ],
  "outputs": {
    "controlPlaneFQDN": {
      "type": "string",
      "value": "[reference(resourceId('Microsoft.ContainerService/managedClusters', parameters('clusterName'))).fqdn]"
    }
  }
}

Если вы не знакомы с шаблонами ARM, ознакомьтесь с руководством по развертыванию локального шаблона ARM.

Подготовьте следующие переменные для развертывания кластера AKS в расширенной зоне Azure с помощью Azure CLI:

SUBSCRIPTION="<your-subscription>"
RG_NAME="<your-resource-group>"
CLUSTER_NAME="<your-cluster>"
EXTENDED_ZONE_NAME="<extended-zone-id>"
LOCATION="<parent-region>" # Ensure this location corresponds to the parent region for your targeted Azure Extended Zone

Убедившись, что вы вошли в систему и используете соответствующую подписку, используйте az aks create для развертывания кластера, указав целевую расширенную зону Azure со свойством --edge-zone .

# Log in to Azure
az login

# Set the subscription you want to create the cluster on
az account set --subscription $SUBSCRIPTION 

# Create the resource group
az group create --name $RG_NAME --location $LOCATION

# Deploy the cluster in your designated Azure Extended Zone
az aks create \
    --resource-group $RG_NAME \
    --name $CLUSTER_NAME \
    --edge-zone $EXTENDED_ZONE_NAME \
    --location $LOCATION \
    --generate-ssh-keys

После развертывания кластера AKS для расширенных зон можно проверить состояние и отслеживать метрики кластера с помощью портала Azure или Azure CLI.

Следующий код создает группу ресурсов и кластер Kubernetes в Azure с поддержкой автоматического масштабирования и определенными параметрами сети с помощью Terraform.

1. Создайте каталог, в котором необходимо протестировать и запустить пример кода Terraform и сделать его текущим каталогом.

2. Создайте файл с именем main.tfи вставьте следующий код:

   resource "random_pet" "rg_name" {
     prefix = var.resource_group_name_prefix
   }
   
   resource "azurerm_resource_group" "rg" {
     location = var.resource_group_location
     name     = random_pet.rg_name.id
   }
   
   resource "random_pet" "azurerm_kubernetes_cluster_name" {
     prefix = "cluster"
   }
   
   resource "random_pet" "azurerm_kubernetes_cluster_dns_prefix" {
     prefix = "dns"
   }
   
   resource "azapi_resource" "aks" {
     type      = "Microsoft.ContainerService/ManagedClusters@2024-05-01"
     name      = random_pet.azurerm_kubernetes_cluster_name.id
     parent_id = azurerm_resource_group.rg.id
     location  = azurerm_resource_group.rg.location
     identity {
       type = "SystemAssigned"
     }
     body = {
       extendedLocation = {
         name = replace(lower(var.aks_extended_zone), " ", "")
         type = "EdgeZone"
       }
       sku = {
         name = "Base"
         tier = "Free"
       }
       properties = {
         dnsPrefix         = random_pet.azurerm_kubernetes_cluster_dns_prefix.id
         kubernetesVersion = "1.29"
         agentPoolProfiles = [
           {
             name                   = "agentpool"
             count                  = var.aks_node_count
             vmSize                 = var.aks_node_vm_size
             osDiskSizeGB           = 128
             kubeletDiskType        = "OS"
             maxPods                = 30
             type                   = "VirtualMachineScaleSets"
             enableAutoScaling      = false,
             scaleDownMode          = "Delete",
             orchestratorVersion    = "1.29"
             enableNodePublicIP     = false
             mode                   = "System"
             enableEncryptionAtHost = false
             enableUltraSSD         = false
             osType                 = "Linux"
             osSKU                  = "Ubuntu"
             upgradeSettings = {
               maxSurge = "10%"
             }
             enableFIPS = false
           }
         ]
         windowsProfile = {
           adminUsername  = var.admin_username
           adminPassword  = var.admin_password
           licenseType    = "None"
           enableCSIProxy = true
         }
         servicePrincipalProfile = {
           clientId = "msi"
         }
         enableRBAC  = true
         supportPlan = "KubernetesOfficial"
         networkProfile = {
           networkPlugin    = "azure"
           networkPolicy    = "none"
           networkDataplane = "azure"
           loadBalancerSku  = "standard"
           loadBalancerProfile = {
             managedOutboundIPs = {
               count = 1
             }
             backendPoolType = "nodeIPConfiguration"
           }
           serviceCidr  = "10.0.0.0/16"
           dnsServiceIP = "10.0.0.10"
           outboundType = "loadBalancer"
           serviceCidrs = [
             "10.0.0.0/16",
           ]
           ipFamilies = ["IPv4"]
         }
         autoUpgradeProfile = {
           upgradeChannel       = "none"
           nodeOSUpgradeChannel = "NodeImage"
         }
         disableLocalAccounts = false
         storageProfile = {
           diskCSIDriver = {
             enabled = true
           }
           fileCSIDriver = {
             enabled = true
           }
           snapshotController = {
             enabled = true
           }
         }
         oidcIssuerProfile = {
           enabled = false
         }
         azureMonitorProfile = {
           metrics = {
             enabled = false
           }
         }
       }
     }
     timeouts {
       create = "6h"
     }
   }
   

3. Создайте файл с именем outputs.tfи вставьте следующий код:

   output "resource_group_name" {
     value = azurerm_resource_group.rg.name
   }
   
   output "aks_cluster_name" {
     value = azapi_resource.aks.name
   }
   
   output "aks_extended_zone" {
     value = azapi_resource.aks.body.extendedLocation.name
   }
   

4. Создайте файл с именем providers.tfи вставьте следующий код:

   terraform {
     required_providers {
       azurerm = {
         source  = "hashicorp/azurerm"
         version = "~>3.0"
       }
       azapi = {
         source  = "Azure/azapi"
         version = "2.0.1"
       }
       random = {
         source  = "hashicorp/random"
         version = "~>3.0"
       }
     }
   }
   
   provider "azurerm" {
     features {}
   }
   

5. Создайте файл с именем variables.tfи вставьте следующий код:

   variable "resource_group_name_prefix" {
     type        = string
     default     = "rg"
     description = "Prefix of the resource group name that's combined with a random ID so name is unique in your Azure subscription."
   }
   
   variable "resource_group_location" {
     type        = string
     default     = "West US"
     description = "Location of the resource group."
   }
   
   variable "virtual_network_name" {
     type        = string
     description = "Virtual network names"
     default     = "example-vnet"
   }
   
   variable "aks_node_count" {
     type        = number
     description = "AKS node count"
     default     = 3
   }
   
   variable "aks_node_vm_size" {
     type        = string
     description = "AKS node VM size"
     default     = "Standard_D2_v2"
   }
   
   variable "admin_username" {
     type        = string
     description = "The admin username for the Windows node pool."
     default     = "azureuser"
   }
   
   variable "admin_password" {
     type        = string
     description = "The admin password for the Windows node pool."
     default     = "Passw0rd1234Us!"
   }
   
   variable "aks_extended_zone" {
     type        = string
     description = "AKS extended zone"
     default     = "Los Angeles"
   }
   

6. Инициализируйте Terraform.

   Запустите terraform init, чтобы инициализировать развертывание Terraform. Эта команда загружает поставщика Azure, необходимого для управления вашими ресурсами Azure.

   terraform init -upgrade
   

   Основные моменты:

   • Параметр -upgrade обновляет необходимые модули поставщика до новейшей версии, которая соответствует ограничениям версии конфигурации.

7. Создайте план выполнения для Terraform.

   Чтобы создать план выполнения, выполните terraform plan.

   terraform plan -out main.tfplan
   

   Основные моменты:

   • Команда terraform plan создает план выполнения, но не выполняет его. Вместо этого он определяет, какие действия необходимы для создания конфигурации, указанной в файлах конфигурации. Этот шаблон позволяет проверить соответствие плана выполнения ожиданиям перед внесением изменений в фактические ресурсы.
   • Необязательный параметр -out позволяет указать выходной файл для плана. Использование параметра -out гарантирует, что проверяемый план полностью соответствует применяемому.

8. Примените план выполнения Terraform.

   Выполните terraform apply, чтобы применить план выполнения к вашей облачной инфраструктуре.

   terraform apply main.tfplan
   

   Основные моменты:

   • Пример команды terraform apply предполагает, что вы ранее выполнили команду terraform plan -out main.tfplan.
   • Если для параметра -out указано другое имя файла, используйте то же имя в вызове к terraform apply.
   • Если вы не использовали параметр -out, вызовите terraform apply без параметров.