Настройка узла службы Azure Kubernetes в Windows Server и развертывание кластера рабочей нагрузки с помощью PowerShell

Область применения: Windows Server Datacenter

В этом кратком руководстве описано, как настроить кластер Azure Kubernetes Service (AKS). Кластеры Kubernetes создаются в Windows Server с помощью PowerShell. Чтобы использовать Центр администрирования Windows, см. статью "Настройка с помощью Центра администрирования Windows".

• Убедитесь, что выполнены все необходимые условия в системных требованиях.
• Используйте учетную запись Azure для регистрации узла AKS для выставления счетов. Дополнительные сведения см. в статье о требованиях Azure.

Выполните следующие действия на всех узлах в кластере Windows Server:

1. Закройте все открытые окна PowerShell, откройте новый сеанс PowerShell от имени администратора и выполните следующую команду на всех узлах в кластере Windows Server:

   Install-PackageProvider -Name NuGet -Force 
   Install-Module -Name PowershellGet -Force -Confirm:$false
   

   Необходимо снова закрыть все существующие окна PowerShell, чтобы убедиться, что загруженные модули обновляются. Не продолжайте переходить к следующему шагу, пока не закройте все открытые окна PowerShell.

2. Установите модуль PowerShell AksHci , выполнив следующую команду на всех узлах в кластере Windows Server:

   Install-Module -Name AksHci -Repository PSGallery -Force -AcceptLicense
   

   Необходимо снова закрыть все существующие окна PowerShell, чтобы убедиться, что загруженные модули обновляются. Не продолжайте переходить к следующему шагу, пока не закройте все открытые окна PowerShell.

Вспомогательный скрипт можно использовать для удаления старых модулей PowerShell AKS-HCI, чтобы избежать проблем, связанных с версиями PowerShell в развертывании AKS.

Get-Command -Module AksHci

Полный список команд AksHci PowerShell см. в статье AksHci PowerShell.

Перед процессом регистрации включите соответствующего поставщика ресурсов в Azure для регистрации в AKS. Для этого выполните следующие команды PowerShell:

Чтобы войти в Azure, выполните команду Connect-AzAccount PowerShell:

Connect-AzAccount

Если вы хотите переключиться на другую подписку, выполните команду Set-AzContext PowerShell:

Set-AzContext -Subscription "xxxx-xxxx-xxxx-xxxx"

Выполните следующие команды, чтобы зарегистрировать вашу подписку Azure в ресурсных провайдерах Kubernetes, совместимых с Azure Arc. Этот процесс регистрации может занять до 10 минут, но его необходимо выполнить только один раз в определенной подписке:

Register-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
Register-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Register-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation

Чтобы проверить процесс регистрации, выполните следующие команды PowerShell:

Get-AzResourceProvider -ProviderNamespace Microsoft.Kubernetes
Get-AzResourceProvider -ProviderNamespace Microsoft.KubernetesConfiguration
Get-AzResourceProvider -ProviderNamespace Microsoft.ExtendedLocation

Выполните проверки на каждом физическом узле, чтобы узнать, соответствуют ли все требования для установки AKS. Откройте PowerShell от имени администратора и выполните следующую команду Initialize-AksHciNode на всех узлах в кластере Windows Server:

Initialize-AksHciNode

Выполните следующие команды на любом узле в кластере Windows Server.

Чтобы получить имена доступных коммутаторов, выполните следующую команду. Убедитесь, SwitchType что переключатель виртуальной машины является внешним:

Get-VMSwitch

Образец вывода:

Name        SwitchType     NetAdapterInterfaceDescription
----        ----------     ------------------------------
extSwitch   External       Mellanox ConnectX-3 Pro Ethernet Adapter

Чтобы создать виртуальную сеть для узлов в развертывании, создайте переменную среды командой PowerShell New-AksHciNetworkSetting. Эта виртуальная сеть используется позже для настройки развертывания, использующего статический IP-адрес. Если вы хотите настроить развертывание AKS с помощью DHCP, см. New-AksHciNetworkSetting для примеров. Вы также можете просмотреть некоторые понятия сетевых узлов.

# static IP
$vnet = New-AksHciNetworkSetting -name myvnet -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" -vlanId 9

Выполните следующие команды на любом узле в кластере Windows Server.

Чтобы создать параметры конфигурации для узла AKS, используйте команду Set-AksHciConfig . Необходимо указать imageDirи workingDircloudConfigLocation параметры. Если вы хотите сбросить сведения о конфигурации, повторно выполните команду с новыми параметрами.

Настройте развертывание с помощью следующей команды:

$csvPath = 'C:\clusterstorage\volume01' # Specify your preferred CSV path
Set-AksHciConfig -imageDir $csvPath\Images -workingDir $csvPath\ImageStore -cloudConfigLocation $csvPath\Config -vnet $vnet

Выполните следующую команду Set-AksHciRegistration PowerShell с именем подписки и группы ресурсов, чтобы войти в Azure. У вас должна быть подписка Azure и существующая группа ресурсов Azure на востоке Австралии, восточной части США, юго-восточной Азии или регионах Azure Западной Европы:

Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"

Если у вас нет доступа к подписке, в которой вы являетесь владельцем, вы можете зарегистрировать узел AKS в Azure для учета с использованием корпоративного приложения. Дополнительные сведения об использовании служебной учетной записи см. в разделе регистрация AKS на Windows Server с помощью служебной учетной записи.

Выполните следующую команду на любом узле в кластере Windows Server.

После настройки развертывания необходимо запустить его, чтобы установить агенты и службы AKS, а также хост AKS. Чтобы начать развертывание, выполните следующую команду:

Install-AksHci

После установки узла AKS можно развернуть кластер Kubernetes. Откройте PowerShell от имени администратора и выполните следующую команду New-AksHciCluster . В этом примере команда создает новый кластер Kubernetes с одним пулом linuxnodepool узлов Linux с числом узлов 1.

Дополнительные сведения о пулах узлов см. в статье "Использование пулов узлов" в AKS.

New-AksHciCluster -name mycluster -nodePoolName linuxnodepool -nodeCount 1 -osType Linux

Чтобы получить список развернутых кластеров Kubernetes, выполните следующую команду Get-AksHciCluster PowerShell:

Get-AksHciCluster

ProvisioningState     : provisioned
KubernetesVersion     : v1.20.7
NodePools             : linuxnodepool
WindowsNodeCount      : 0
LinuxNodeCount        : 0
ControlPlaneNodeCount : 1
Name                  : mycluster

Чтобы получить список пулов узлов в кластере, выполните следующую команду Get-AksHciNodePool PowerShell:

Get-AksHciNodePool -clusterName mycluster

ClusterName  : mycluster
NodePoolName : linuxnodepool
Version      : v1.20.7
OsType       : Linux
NodeCount    : 1
VmSize       : Standard_K8S3_v1
Phase        : Deployed

Подключите кластер к Kubernetes с поддержкой Arc, выполнив команду Enable-AksHciArcConnection . В следующем примере кластер Kubernetes подключается к Arc с помощью сведений о подписке и группе ресурсов, переданных в команде Set-AksHciRegistration :

Connect-AzAccount
Enable-AksHciArcConnection -name mycluster

Если необходимо увеличить или уменьшить масштаб кластера, можно изменить количество узлов плоскости управления с помощью команды Set-AksHciCluster . Чтобы изменить количество рабочих узлов Linux или Windows в пуле узлов, используйте команду Set-AksHciNodePool .

Чтобы масштабировать узлы плоскости управления, выполните следующую команду:

Set-AksHciCluster -name mycluster -controlPlaneNodeCount 3

Чтобы масштабировать рабочие узлы в пуле узлов, выполните следующую команду:

Set-AksHciNodePool -clusterName mycluster -name linuxnodepool -count 3

Чтобы масштабировать рабочие узлы в узле, используйте команду Set-AksHciNodePool .

Чтобы получить доступ к кластерам Kubernetes с помощью kubectl, выполните команду Get-AksHciCredential PowerShell. Эта команда использует файл kubeconfig указанного кластера в качестве файла kubeconfig по умолчанию для kubectl. Вы также можете использовать kubectl для развертывания приложений с помощью Helm:

Get-AksHciCredential -name mycluster

Чтобы удалить кластер Kubernetes, выполните следующую команду:

Remove-AksHciCluster -name mycluster

Чтобы получить журналы из всех модулей pod, выполните команду Get-AksHciLogs . Эта команда создает выходную архивную папку, вызванную akshcilogs.zip в рабочем каталоге. Полный путь к папке akshcilogs.zip — это выходные данные после выполнения следующей команды:

Get-AksHciLogs

В этом кратком руководстве вы узнали, как настроить хост AKS и создать кластеры Kubernetes с помощью PowerShell. Вы также узнали, как использовать PowerShell для масштабирования кластера Kubernetes и доступа к кластерам с помощью kubectl.

• Подготовка приложения
• Развертывание приложения Windows в кластере Kubernetes
• Настройка нескольких администраторов