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]
Description
Задает параметры конфигурации для узла Служба Azure Kubernetes. Если вы развертываете на локальном кластере Azure 2-4 или в отказоустойчивом кластере Windows Server 2019 Datacenter, необходимо указать -workingDir параметры и -cloudConfigLocation параметры. Для центра обработки данных с одним узлом Windows Server 2019 все параметры являются необязательными и задают значения по умолчанию. Однако для оптимальной производительности рекомендуется использовать развертывание локального кластера Azure с 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 в качестве аргумента для этого параметра. Если автоматическое распределение отключено, используется только выбранный imageDir CSV-файл. Значение по умолчанию — true.
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-offlineDownload
Вызывает автономную загрузку во время установки-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
Задает развертывание для использования артефактов, скачанных вне сайта и передаваемых на сервер развертывания во время установки-AksHci. Этот флаг используется в тандеме с параметром и -stagingShare параметром-offlineDownload.
-режим
Режим загрузки, который вы хотите использовать для автономного скачивания. Используйте, если требуется 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
Предоставляет пользовательское имя расположения в облаке, управляемое корпорацией Майкрософт. Имя по умолчанию — 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