Развертывание узла Служба Azure Kubernetes с предварительно подготовленными объектами службы кластера и записями DNS с помощью PowerShell
Область применения: AKS в Azure Stack HCI 22H2, AKS на Windows Server
В этом руководстве описывается, как использовать PowerShell для настройки развертывания узла AKS, если предварительно подготовленные объекты службы кластеров и записи DNS в AKS, включенные Azure Arc.
Подготовка к работе
- Убедитесь, что выполнены все необходимые условия в системных требованиях.
- Скачайте и установите модуль PowerShell AksHci.
Шаг 1. Подготовка сервера Active Directory и DNS для развертывания
Если вы не можете включить динамические обновления DNS в среде DNS, чтобы разрешить AKS, включенную Arc, зарегистрировать имя универсального кластера облачного агента в Active Directory и системе DNS для обнаружения, необходимо предварительно создать соответствующие записи в Active Directory и DNS.
Создайте универсальную службу кластера в Active Directory с именем (или именем ca-cloudagent , которое не превышает 32 символов). Кроме того, создайте связанную запись DNS, указывающую на полное доменное имя универсальной службы кластера с указанным cloudservicecidr адресом. Дополнительные сведения о шагах в этом процессе см. в документации по отказоустойчивой кластеризации.
Развертывание AKS пытается найти указанный clusterRoleName в Active Directory, прежде чем продолжить развертывание.
Примечание.
После развертывания AKS эти сведения нельзя изменить.
Шаг 2. Подготовка компьютеров к развертыванию
Выполните проверку на каждом физическом узле, чтобы узнать, соответствуют ли все требования для установки AKS Arc. Откройте PowerShell от имени администратора и выполните следующую команду Initialize-AksHciNode :
Initialize-AksHciNode
Шаг 3. Создание виртуальной сети
Чтобы создать виртуальную сеть для узлов в развертывании, создайте переменную среды с New-AksHciNetworkSetting помощью команды PowerShell. Эта переменная используется позже для настройки развертывания, использующего статический IP-адрес. Если вы хотите настроить развертывание AKS с помощью DHCP, см . примеры New-AksHciNetworkSetting . Вы также можете просмотреть некоторые понятия сетевых узлов.
# static IP
$vnet = New-AksHciNetworkSetting -name mgmt-vnet -vSwitchName "extSwitch" -k8sNodeIpPoolStart "172.16.10.1" -k8sNodeIpPoolEnd "172.16.10.255" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -ipAddressPrefix "172.16.0.0/16" -gateway "172.16.0.1" -dnsServers "172.16.0.1"
Примечание.
Необходимо настроить значения, отображаемые в этом примере команды для вашей среды.
Шаг 4. Настройка развертывания с помощью предварительно подготовленных объектов службы кластера и записей DNS
Задайте параметры конфигурации для узла AKS с помощью команды Set-AksHciConfig . Необходимо указать workingDirпараметры , cloudServiceCidrcloudConfigLocationи clusterRoleName параметры. Если вы хотите сбросить сведения о конфигурации, выполните команду еще раз с новыми параметрами.
Настройте развертывание с помощью следующей команды:
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"
Примечание.
Настройте значения, отображаемые в этом примере команды для вашей среды.
Шаг 5. Вход в Azure и настройка параметров регистрации
Выполните следующую команду Set-AksHciRegistration PowerShell с именем подписки и группы ресурсов, чтобы войти в Azure. Для продолжения необходимо иметь подписку Azure и существующую группу ресурсов Azure в восточной части США, юго-восточной Азии или регионах Azure Западной Европы:
Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"
Шаг 6. Запуск нового развертывания
После настройки развертывания необходимо запустить его. При запуске развертывания устанавливаются агенты и службы AKS и узел AKS. Чтобы начать развертывание, выполните следующую команду:
Install-AksHci
Предупреждение
Во время установки узла AKS в группе ресурсов, заданной во время регистрации, создается тип ресурса Kubernetes — Azure Arc . Не удаляйте этот ресурс, так как он представляет узел Служба Azure Kubernetes. Вы можете определить ресурс, проверив его поле распространения для aks_management значения. Удаление этого ресурса приводит к развертыванию вне политики.