Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Synopsis
Define ou atualiza as configurações para o Azure Kubernetes Service host.
Sintaxe
Definir configuração para o 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]
Description
Define as configurações para o host Azure Kubernetes Service. Se estiveres a implementar num cluster Azure Local de 2-4 nós ou num cluster de failover para centros de dados Windows Server 2019, tens de especificar os -workingDir parâmetros and-cloudConfigLocation. Para um Windows Server 2019 Datacenter de nó único, todos os parâmetros são opcionais e definidos para os seus valores predefinidos. No entanto, para um desempenho ótimo, recomendamos usar uma implantação de cluster Azure Local com 2-4 nós.
Examples
Para implementar num cluster de 2-4 nós 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 implementar 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 implementar 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"
Parameters
-imageDir
O caminho para o diretório onde o AKS híbrido armazena as suas imagens VHD. Este parâmetro é obrigatório. O caminho deve apontar para um caminho de armazenamento partilhado, como C:\ClusterStorage\Volume2\ImageStore, ou para uma partilha 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
-A trabalharDir
Um diretório funcional para o módulo usar para armazenar pequenos ficheiros. Este parâmetro é obrigatório. O caminho deve apontar para um caminho de armazenamento partilhado, 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
-cloudConfigLocalização
O local onde o agente cloud armazena a sua configuração. Este parâmetro é obrigatório. O caminho deve apontar para um caminho de armazenamento partilhado, como C:\ClusterStorage\Volume2\ImageStore, ou para uma partilha SMB como \\FileShare\ImageStore. A localização deve estar numa partilha 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 desativar a distribuição automática de dados da VM nos volumes partilhados do seu cluster (CSV). Para desativar a distribuição automática, use false como argumento para este parâmetro. Se a distribuição automática estiver desativada, apenas o CSV que selecionaste imageDir é usado. O valor predefinido é true.
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-offlineDownload
Invoca o download offline durante o Install-AksHci. Também deve executar o Enable-AksHciOfflineDownload. Esta bandeira é usada 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
-offsiteTransferConcluído
Define a implementação para usar artefactos descarregados fora do local e transferidos para o servidor de implementação durante o Install-AksHci. Esta bandeira é usada em conjunto com o -offlineDownload parâmetro and -stagingShare .
-modo
O modo de download que queres usar para download offline. Use minimum se quiser o mínimo de imagens para a implementação híbrida do AKS. Esta opção inclui as imagens Linux necessárias e apenas a imagem Kubernetes obrigatória. Usa full se quiseres todas as imagens para implementação híbrida do AKS. Esta opção inclui todas as imagens Linux e Windows e todas as imagens Kubernetes suportadas. Use este parâmetro em conjunto com o -offlineDownload parâmetro. A predefinição é full.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: full
Accept pipeline input: False
Accept wildcard characters: False
-encenaçãoPartilhar
O caminho local para onde quer que as imagens sejam descarregadas. 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
-nodeConfigLocalização
O local onde os agentes de nó armazenam a sua configuração. Cada nó tem um agente de nó, por isso a sua configuração é local para esse nó. Este local deve ser um caminho local. Por defeito, %systemdrive%\programdata\wssdagent para todas as implementaçõ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 criar para o plano de controlo. Para obter uma lista dos 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 ficheiro de chave pública SSH. Usando esta chave pública, pode iniciar sessão em qualquer uma das VMs criadas pela implementação híbrida do AKS. Se tiver a sua própria chave pública SSH, passe a sua localização aqui. Se não for fornecida uma chave, procuramos uma em %systemdrive%\akshci\.ssh\akshci_rsa.pub. Se o ficheiro não existir, é gerado um par de chaves SSH neste local e utilizado.
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 MAC que pretende usar para a VM host do Azure Kubernetes Service. A sintaxe do endereço MAC exige que o bit menos significativo do primeiro byte seja sempre 0, e o primeiro byte seja sempre um número par (ou seja, 00, 02, 04, 06...). Um endereço MAC típico pode ser assim: 02:1E:2B:78:00:00. Use pools MAC para implementações de longa duração, de modo a que os endereços MAC atribuídos sejam consistentes. Pools MAC são úteis se tiveres um requisito de que as VMs tenham endereços MAC específicos. A predefiniçã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 fim do endereço MAC do pool MAC que pretende usar para a VM host do Azure Kubernetes Service. A sintaxe do endereço MAC exige que o bit menos significativo do primeiro byte seja sempre 0, e o primeiro byte seja sempre um número par (ou seja, 00, 02, 04, 06...). O primeiro byte do endereço passado como o -macPoolEnd deve ser igual ao primeiro byte do endereço passado como o -macPoolStart. Use pools MAC para implementações de longa duração, de modo a que os endereços MAC atribuídos sejam consistentes. Pools MAC são úteis se tiveres um requisito de que as VMs tenham endereços MAC específicos. A predefinição é None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-proxy Settings
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 IP/prefixo de rede estático a ser atribuído ao serviço MOC CloudAgent. Este valor deve ser fornecido usando o formato CIDR; por exemplo, 192.168.1.2/16. Pode querer especificar este parâmetro para garantir que tudo o que é importante na rede está sempre acessível, porque o endereço IP não muda. A predefiniçã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 queres implementar. O padrão é a versão mais recente. 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 em que os agentes de nó devem ouvir, que por defeito é 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ós devem usar para a sua porta de autorização. Por defeito é 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 que o agente cloud deve ouvir. 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 cloud deve usar para a sua porta de autorização. Por defeito é 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 usar ao criar o agente cloud como um serviço genérico dentro do cluster. Este parâmetro tem por defeito um nome único com o prefixo 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
-cloudLocalização
Fornece um nome de localização personalizado para a Cloud Operada pela 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 quaisquer verificações para confirmar que a memória e o espaço em disco estão disponíveis antes de permitir que a implementação prossiga. Não recomendamos o uso desta 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 quaisquer verificações para confirmar capacidades remotas tanto a nós locais como remotos. Não recomendamos o uso desta 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
Implementa componentes híbridos AKS, como agente cloud e agente(s) de nó, em modo inseguro (sem ligações seguras TLS). Não recomendamos o uso do 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 este flag se quiser saltar quaisquer atualizações disponíveis. Não recomendamos o uso desta 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 DNS pode demorar até uma hora em alguns sistemas. Isto faz com que a implementação seja lenta. Se tiver este problema, verá que está Install-AksHci preso num ciclo. Para ultrapassar este problema, tente usar esta bandeira. A -forceDnsReplication bandeira não é uma solução garantida. Se a lógica por trás da flag falhar, o erro fica oculto e o comando procede como se a flag não tivesse sido fornecida.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipValidationChecks
Use este flag se quiser saltar as verificações de validação da infraestrutura do ambiente e da entrada de configuração do utilizador. Estas verificações destacam potenciais problemas a resolver antes de avançar com a instalação. Não recomendamos o uso desta 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