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_rsa
pub. Если файл не существует, в этом расположении создается пара ключей 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