Set-AksHciConfig

Краткий обзор

Задает или обновляет параметры конфигурации для узла Служба Azure Kubernetes.

Синтаксис

Настройка конфигурации для узла

Set-AksHciConfig  -imageDir <String>
                  -workingDir <String>
                  -cloudConfigLocation <String>
                  -vnet <Virtual Network>
                 [-createAutoConfigContainers {true, false}]
                 [-offlineDownload]
                 [-offsiteTransferCompleted]
                 [-mode {minimum, full}]
                 [-stagingShare <String>]
                 [-nodeConfigLocation <String>]
                 [-controlPlaneVmSize <VmSize>]
                 [-sshPublicKey <String>]
                 [-macPoolStart <String>]
                 [-macPoolEnd <String>]       
                 [-proxySettings <ProxySettings>]
                 [-cloudServiceCidr <String>]
                 [-version <String>]
                 [-nodeAgentPort <int>]
                 [-nodeAgentAuthorizerPort <int>]
                 [-cloudAgentPort <int>]
                 [-cloudAgentAuthorizerPort <int>]
                 [-clusterRoleName <String>]
                 [-cloudLocation <String>]
                 [-concurrentDownloads <int>]
                 [-skipHostLimitChecks]
                 [-skipRemotingChecks]
                 [-skipValidationChecks]
                 [-insecure]
                 [-skipUpdates]
                 [-forceDnsReplication]   

Описание

Задает параметры конфигурации для узла Служба Azure Kubernetes. При развертывании на 2–4 узлах кластера Azure Stack HCI или отказоустойчивом кластере Windows Server 2019 Datacenter необходимо указать -workingDir параметры и -cloudConfigLocation . Для windows Server 2019 Datacenter с одним узлом все параметры являются необязательными и имеют значения по умолчанию. Однако для оптимальной производительности рекомендуется использовать развертывание кластера Azure Stack HCI на 2–4 узла.

Примеры

Развертывание в кластере с 2-4 узлами с сетью DHCP

PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" 

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Развертывание со статическими IP-сетями

PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -k8snodeippoolstart "172.16.10.0" -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" 

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Развертывание с помощью прокси-сервера

PS C:\> $proxySettings = New-AksHciProxySetting -name "corpProxy" -http http://contosoproxy:8080 -https https://contosoproxy:8443 -noProxy localhost,127.0.0.1,.svc,10.96.0.0/12,10.244.0.0/16 -credential $proxyCredential

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -proxySetting $proxySettings -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Параметры

-imageDir

Путь к каталогу, в котором гибрид AKS хранит свои образы VHD. Это обязательный параметр. Путь должен указывать на общий путь к хранилищу, например C:\ClusterStorage\Volume2\ImageStore, или общую папку SMB, например \\FileShare\ImageStore.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: %systemdrive%\AksHciImageStore
Accept pipeline input: False
Accept wildcard characters: False

-workingDir

Рабочий каталог модуля, используемый для хранения небольших файлов. Это обязательный параметр. Путь должен указывать на общий путь к хранилищу, например c:\ClusterStorage\Volume2\ImageStore.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: %systemdrive%\AksHci
Accept pipeline input: False
Accept wildcard characters: False

-cloudConfigLocation

Расположение, в котором облачный агент хранит свою конфигурацию. Это обязательный параметр. Путь должен указывать на общий путь к хранилищу, например C:\ClusterStorage\Volume2\ImageStore, или общую папку SMB, например \\FileShare\ImageStore. Расположение должно находиться в общей папке с высоким уровнем доступности, чтобы хранилище всегда было доступным.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False

-Vnet

Имя объекта AksHciNetworkSetting , созданного New-AksHciNetworkSetting с помощью команды .

Type: VirtualNetwork
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-createAutoConfigContainers

Позволяет отключить автоматическое распространение данных виртуальных машин на общих томах кластера (CSV). Чтобы отключить автоматическое распределение, используйте false в качестве аргумента для этого параметра. Если автоматическое распространение отключено, используется только выбранный csv-файл imageDir . Значение по умолчанию — true.

Type: System.Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False

-offlineСкачать

Вызывает автономную загрузку во время install-AksHci. Также необходимо выполнить команду Enable-AksHciOfflineDownload. Этот флаг используется в тандеме с параметром -stagingShare .

Type: System.Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-offsiteTransferCompleted

Задает развертывание для использования артефактов, загруженных вне сайта и переданных на сервер развертывания во время install-AksHci. Этот флаг используется в тандеме с параметром -offlineDownload и -stagingShare .

-Режим

Режим скачивания, который вы хотите использовать для автономной загрузки. Используйте, minimum если требуется минимальное количество образов для гибридного развертывания AKS. Этот параметр включает в себя необходимые образы Linux и только необходимый образ Kubernetes. Используйте, full если требуется использовать все образы для гибридного развертывания AKS. Этот параметр включает все образы Linux и Windows, а также все поддерживаемые образы Kubernetes. Используйте этот параметр в сочетании с параметром -offlineDownload . Значение по умолчанию — full.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: full
Accept pipeline input: False
Accept wildcard characters: False

-stagingShare

Локальный путь к месту загрузки образов. Используйте в тандеме с параметром offlineDownload .

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False

-nodeConfigLocation

Расположение, в котором агенты узла хранят свою конфигурацию. Каждый узел имеет агент узла, поэтому его конфигурация является локальной для этого узла. Это расположение должно быть локальным путем. По умолчанию используется значение %systemdrive%\programdata\wssdagent для всех развертываний.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: %systemdrive%\programdata\wssdagent
Accept pipeline input: False
Accept wildcard characters: False

-controlPlaneVmSize

Размер виртуальной машины, создаваемой для уровня управления. Чтобы получить список доступных размеров виртуальных машин, выполните команду Get-AksHciVmSize.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Standard_A4_V2
Accept pipeline input: False
Accept wildcard characters: False

-sshPublicKey

Путь к файлу открытого ключа SSH. С помощью этого открытого ключа можно войти в любую из виртуальных машин, созданных гибридным развертыванием AKS. Если у вас есть собственный открытый ключ SSH, передайте его расположение здесь. Если ключ не указан, мы ищем его в . %systemdrive%\akshci\.ssh\akshci_rsapub. Если файл не существует, в этом расположении создается пара ключей SSH и используется.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-macPoolStart

Указывает начало MAC-адреса пула MAC, который будет использоваться для виртуальной машины узла Служба Azure Kubernetes. Синтаксис MAC-адреса требует, чтобы наименьший значимый бит первого байта всегда был равен 0, а первый байт всегда должен быть четным числом (то есть 00, 02, 04, 06...). Типичный MAC-адрес может выглядеть следующим образом: 02:1E:2B:78:00:00. Используйте пулы MAC для длительных развертываний, чтобы обеспечить согласованность назначенных MAC-адресов. Пулы MAC полезны, если требуется, чтобы у виртуальных машин были определенные MAC-адреса. Значение по умолчанию — None.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-macPoolEnd

Указывает конец MAC-адреса пула MAC, который вы хотите использовать для виртуальной машины узла Служба Azure Kubernetes. Синтаксис MAC-адреса требует, чтобы наименьший значимый бит первого байта всегда был равен 0, а первый байт всегда должен быть четным числом (то есть 00, 02, 04, 06...). Первый байт адреса, переданного как -macPoolEnd , должен совпадать с первым байтом адреса, переданного в -macPoolStartкачестве . Используйте пулы MAC для длительных развертываний, чтобы обеспечить согласованность назначенных MAC-адресов. Пулы MAC полезны, если требуется, чтобы у виртуальных машин были определенные MAC-адреса. Значение по умолчанию — None.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-proxySettings

Прокси-объект, созданный с помощью New-AksHciProxySetting.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-cloudServiceCidr

Предоставляет статический IP-адрес или сетевой префикс для назначения службе MOC CloudAgent. Это значение должно быть указано в формате CIDR; например, 192.168.1.2/16. Этот параметр может потребоваться указать, чтобы все важные сведения в сети всегда были доступны, так как IP-адрес не изменяется. Значение по умолчанию — None.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-version

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

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Latest version
Accept pipeline input: False
Accept wildcard characters: False

-nodeAgentPort

Номер порта TCP/IP, на котором агенты узла должны ожидать передачи данных, по умолчанию — 45000. Не рекомендуется изменять значение по умолчанию.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 45000
Accept pipeline input: False
Accept wildcard characters: False

-nodeAgentAuthorizerPort

Номер порта TCP/IP, который агенты узла должны использовать для порта авторизации. Значение по умолчанию — 45001. Не рекомендуется изменять значение по умолчанию.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 45001
Accept pipeline input: False
Accept wildcard characters: False

-cloudAgentPort

Номер порта TCP/IP, который должен прослушивать облачный агент. Значение по умолчанию — 55000. Не рекомендуется изменять значение по умолчанию.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 55000
Accept pipeline input: False
Accept wildcard characters: False

-cloudAgentAuthorizerPort

Номер порта TCP/IP, который облачный агент должен использовать для порта авторизации. Значение по умолчанию — 65000. Не рекомендуется изменять значение по умолчанию.

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 65000
Accept pipeline input: False
Accept wildcard characters: False

-clusterRoleName

Указывает имя, используемое при создании облачного агента в качестве универсальной службы в кластере. Этот параметр по умолчанию имеет уникальное имя с префиксом ca- и суффиксОМ GUID. Не рекомендуется изменять значение по умолчанию.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: A unique name with a prefix of ca- and a guid suffix
Accept pipeline input: False
Accept wildcard characters: False

-cloudLocation

Предоставляет пользовательское имя расположения Microsoft Operated Cloud. Имя по умолчанию — MocLocation. Не рекомендуется изменять значение по умолчанию.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: MocLocation
Accept pipeline input: False
Accept wildcard characters: False

-skipHostLimitChecks

Запрашивает, чтобы скрипт пропускал все проверки, чтобы убедиться, что память и место на диске доступны, прежде чем разрешить развертывание. Мы не рекомендуем использовать этот параметр.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-skipRemotingChecks

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

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Небезопасных

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

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-skipUpdates

Используйте этот флаг, если хотите пропустить доступные обновления. Мы не рекомендуем использовать этот параметр.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-forceDnsReplication

Репликация DNS в некоторых системах может занять до часа. Это приводит к медленному развертыванию. При возникновении этой проблемы вы увидите, что Install-AksHci зависает в цикле. Чтобы устранить эту проблему, попробуйте использовать этот флаг. Флаг -forceDnsReplication не является гарантированным исправлением. Если логика флага завершается сбоем, ошибка скрывается, а команда выполняется так, как если бы флаг не был указан.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-skipValidationChecks

Используйте этот флаг, если вы хотите пропустить проверки инфраструктуры среды и входных данных пользовательской конфигурации. Эти проверки подчеркивают потенциальные проблемы, которые необходимо устранить перед продолжением установки. Мы не рекомендуем использовать этот параметр.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Дальнейшие действия

Справочник по PowerShell для AksHci