Set-AksHciConfig
Sinopse
Define ou atualiza as configurações do host Serviço de Kubernetes do Azure.
Sintaxe
Definir a configuração do host
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]
Descrição
Define as configurações do host Serviço de Kubernetes do Azure. Se você estiver implantando em um cluster do Azure Stack HCI de 2 a 4 nós ou em um cluster de failover do Datacenter do Windows Server 2019, especifique os -workingDir
parâmetros e -cloudConfigLocation
. Para um Datacenter do Windows Server 2019 de nó único, todos os parâmetros são opcionais e definidos como seus valores padrão. No entanto, para obter o desempenho ideal, recomendamos usar uma implantação de cluster do Azure Stack HCI de 2 a 4 nós.
Exemplos
Para implantar em um cluster de nós de 2 a 4 com rede 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"
Para implantar com rede IP estática
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"
Para implantar com um servidor proxy
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"
Parâmetros
-imageDir
O caminho para o diretório no qual o AKS híbrido armazena suas imagens VHD. Este parâmetro é necessário. O caminho deve apontar para um caminho de armazenamento compartilhado, como C:\ClusterStorage\Volume2\ImageStore
ou um compartilhamento SMB, como \\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
Um diretório de trabalho para o módulo a ser usado para armazenar arquivos pequenos. Este parâmetro é necessário. O caminho deve apontar para um caminho de armazenamento compartilhado, como 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
O local no qual o agente de nuvem armazena sua configuração. Este parâmetro é necessário. O caminho deve apontar para um caminho de armazenamento compartilhado, como C:\ClusterStorage\Volume2\ImageStore
ou um compartilhamento SMB, como \\FileShare\ImageStore
. O local precisa estar em um compartilhamento altamente disponível para que o armazenamento esteja sempre acessível.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False
-vnet
O nome do objeto AksHciNetworkSetting criado com o New-AksHciNetworkSetting
comando .
Type: VirtualNetwork
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-createAutoConfigContainers
Permite desabilitar a distribuição automática de dados de VM em seu CSV (volumes compartilhados de cluster). Para desabilitar a distribuição automática, use false
como o argumento para esse parâmetro. Se a distribuição automática estiver desabilitada, somente o CSV para o qual você selecionou imageDir
será usado. O valor padrão é true
.
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-offlineBaixar
Invoca o download offline durante Install-AksHci. Você também deve executar Enable-AksHciOfflineDownload. Esse sinalizador é usado em conjunto com o -stagingShare
parâmetro .
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-offsiteTransferCompleted
Define a implantação para usar artefatos baixados fora do local e transferidos para o servidor de implantação durante Install-AksHci. Esse sinalizador é usado em conjunto com o -offlineDownload
parâmetro e -stagingShare
.
-Modo
O modo de download que você deseja usar para download offline. Use minimum
se desejar as imagens mínimas para implantação híbrida do AKS. Essa opção inclui as imagens necessárias do Linux e apenas a imagem necessária do Kubernetes. Use full
se quiser todas as imagens para implantação híbrida do AKS. Essa opção inclui todas as imagens do Linux e do Windows e todas as imagens do Kubernetes com suporte. Use esse parâmetro em conjunto com o -offlineDownload
parâmetro . O padrão é full
.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: full
Accept pipeline input: False
Accept wildcard characters: False
-stagingShare
O caminho local para onde você deseja que as imagens sejam baixadas. Use em conjunto com o offlineDownload
parâmetro .
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-nodeConfigLocation
O local no qual os agentes do nó armazenam sua configuração. Cada nó tem um agente de nó, portanto, sua configuração é local para esse nó. Esse local deve ser um caminho local. O padrão é para %systemdrive%\programdata\wssdagent
todas as implantações.
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
O tamanho da VM a ser criada para o plano de controle. Para obter uma lista de tamanhos de VM disponíveis, execute 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
Caminho para um arquivo de chave pública SSH. Usando essa chave pública, você pode fazer logon em qualquer uma das VMs criadas pela implantação híbrida do AKS. Se você tiver sua própria chave pública SSH, passe sua localização aqui. Se nenhuma chave for fornecida, procuraremos uma %systemdrive%\akshci\.ssh\akshci_rsa
em .pub. Se o arquivo não existir, um par de chaves SSH será gerado nesse local e usado.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolStart
Especifica o início do endereço MAC do pool de MAC que você deseja usar para a VM do host Serviço de Kubernetes do Azure. A sintaxe do endereço MAC requer que o bit menos significativo do primeiro byte sempre seja 0 e o primeiro byte sempre deve ser um número par (ou seja, 00, 02, 04, 06...). Um endereço MAC típico pode ter esta aparência: 02:1E:2B:78:00:00. Use pools de MAC para implantações de longa duração para que os endereços MAC atribuídos sejam consistentes. Os pools de MAC serão úteis se você tiver um requisito de que as VMs tenham endereços MAC específicos. O padrão é None
.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolEnd
Especifica o final do endereço MAC do pool mac que você deseja usar para a VM do host Serviço de Kubernetes do Azure. A sintaxe do endereço MAC requer que o bit menos significativo do primeiro byte sempre seja 0 e o primeiro byte sempre deve ser um número par (ou seja, 00, 02, 04, 06...). O primeiro byte do endereço passado como deve -macPoolEnd
ser o mesmo que o primeiro byte do endereço passado como o -macPoolStart
. Use pools de MAC para implantações de longa duração para que os endereços MAC atribuídos sejam consistentes. Os pools de MAC serão úteis se você tiver um requisito de que as VMs tenham endereços MAC específicos. O padrão é None
.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-proxySettings
O objeto proxy criado usando 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
Fornece um prefixo de IP/rede estático a ser atribuído ao serviço MOC CloudAgent. Esse valor deve ser fornecido usando o formato CIDR; por exemplo, 192.168.1.2/16. Talvez você queira especificar esse parâmetro para garantir que qualquer coisa importante na rede seja sempre acessível, pois o endereço IP não é alterado. O padrão é None
.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-version
A versão do AKS híbrido que você deseja implantar. O padrão é a última versão. Não recomendamos alterar o padrão.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Latest version
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentPort
O número da porta TCP/IP no qual os agentes de nó devem escutar, que usa como padrão 45000. Não recomendamos alterar o padrão.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45000
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentAuthorizerPort
O número da porta TCP/IP que os agentes de nó devem usar para a porta de autorização. O padrão é 45001. Não recomendamos alterar o padrão.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45001
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentPort
O número da porta TCP/IP em que o agente de nuvem deve escutar. O padrão é 55000. Não recomendamos alterar o padrão.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 55000
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentAuthorizerPort
O número da porta TCP/IP que o agente de nuvem deve usar para sua porta de autorização. O padrão é 65000. Não recomendamos alterar o padrão.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 65000
Accept pipeline input: False
Accept wildcard characters: False
-clusterRoleName
Especifica o nome a ser usado ao criar o agente de nuvem como um serviço genérico dentro do cluster. Esse parâmetro usa como padrão um nome exclusivo com um prefixo de ca- e um sufixo GUID. Não recomendamos alterar o padrão.
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
Fornece um nome de local personalizado da Nuvem Operada da Microsoft. O nome padrão é MocLocation. Não recomendamos alterar o padrão.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: MocLocation
Accept pipeline input: False
Accept wildcard characters: False
-skipHostLimitChecks
Solicita que o script ignore todas as verificações para confirmar se a memória e o espaço em disco estão disponíveis antes de permitir que a implantação prossiga. Não recomendamos usar essa configuração.
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
Solicita que o script ignore todas as verificações para confirmar os recursos de comunicação remota para nós locais e remotos. Não recomendamos usar essa configuração.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Inseguro
Implanta componentes híbridos do AKS, como agente de nuvem e agentes de nó, no modo inseguro (sem conexões protegidas por TLS). Não recomendamos usar o modo inseguro em ambientes de produção.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipUpdates
Use esse sinalizador se quiser ignorar as atualizações disponíveis. Não recomendamos usar essa configuração.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-forceDnsReplication
A replicação de DNS pode levar até uma hora em alguns sistemas. Isso faz com que a implantação seja lenta. Se você enfrentar esse problema, verá que Install-AksHci
está preso em um loop. Para superar esse problema, tente usar esse sinalizador. O -forceDnsReplication
sinalizador não é uma correção garantida. Se a lógica por trás do sinalizador falhar, o erro ficará oculto e o comando continuará como se o sinalizador não fosse fornecido.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipValidationChecks
Use esse sinalizador se quiser ignorar as verificações de validação da infraestrutura de ambiente e da entrada de configuração do usuário. Essas verificações realçam possíveis problemas a serem resolvidos antes de prosseguir com a instalação. Não recomendamos usar essa configuração.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False