Set-AksHciConfig

Sinopse

Define ou atualiza as definições de configuração do anfitrião Azure Kubernetes Service.

Syntax

Definir a configuração do anfitrião

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 definições de configuração do anfitrião Azure Kubernetes Service. Se estiver a implementar num cluster do Azure Stack HCI de 2 a 4 nós ou num cluster de ativação pós-falha do Datacenter do Windows Server 2019, tem de especificar os -workingDir parâmetros e -cloudConfigLocation . Para um Datacenter do Windows Server 2019 de nó único, todos os parâmetros são opcionais e são definidos para os respetivos valores predefinidos. No entanto, para um desempenho ideal, recomendamos a utilização de uma implementação de cluster do Azure Stack HCI de 2 a 4 nós.

Exemplos

Para implementar num cluster de 2 a 4 nós com redes 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 redes IP estáticas

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"

Parâmetros

-imageDir

O caminho para o diretório no qual o AKS híbrido armazena as respetivas imagens VHD. Este parâmetro é obrigatório. O caminho tem de apontar para um caminho de armazenamento partilhado, como C:\ClusterStorage\Volume2\ImageStore, ou 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

-workingDir

Um diretório de trabalho para o módulo utilizar para armazenar ficheiros pequenos. Este parâmetro é obrigatório. O caminho tem de 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

-cloudConfigLocation

A localização na qual o agente da cloud armazena a respetiva configuração. Este parâmetro é obrigatório. O caminho tem de apontar para um caminho de armazenamento partilhado, como C:\ClusterStorage\Volume2\ImageStore, ou uma partilha SMB, como \\FileShare\ImageStore. A localização tem de estar numa partilha de elevada disponibilidade 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 de VM nos volumes partilhados do cluster (CSV). Para desativar a distribuição automática, utilize false como argumento para este parâmetro. Se a distribuição automática estiver desativada, é utilizado apenas o CSV que selecionou para imageDir . 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

-offlineTransferir

Invoca a transferência offline durante Install-AksHci. Também tem de executar Enable-AksHciOfflineDownload. Este sinalizador é utilizado 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 implementação para utilizar artefactos transferidos fora do local e transferidos para o servidor de implementação durante Install-AksHci. Este sinalizador é utilizado em conjunto com o -offlineDownload parâmetro e -stagingShare .

-mode

O modo de transferência que pretende utilizar para transferência offline. Utilize minimum se quiser as imagens mínimas para a implementação híbrida do AKS. Esta opção inclui as imagens do Linux necessárias e apenas a imagem do Kubernetes necessária. Utilize full se quiser todas as imagens para a implementação híbrida do AKS. Esta opção inclui todas as imagens do Linux e do Windows e todas as imagens do Kubernetes suportadas. Utilize 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

-stagingShare

O caminho local para onde pretende que as imagens sejam transferidas. Utilize 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

A localização na qual os agentes do nó armazenam a respetiva configuração. Cada nó tem um agente de nó, pelo que a respetiva configuração é local para esse nó. Esta localização tem de ser um caminho local. A predefinição é para %systemdrive%\programdata\wssdagent 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. Com 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 respetiva localização aqui. Se não for fornecida nenhuma chave, procuramos uma %systemdrive%\akshci\.ssh\akshci_rsaem .pub. Se o ficheiro não existir, é gerado um par de chaves SSH nesta localização 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 conjunto MAC que pretende utilizar para a VM do anfitrião Azure Kubernetes Service. A sintaxe do endereço MAC requer que o bit menos significativo do primeiro byte seja sempre 0 e o primeiro byte deve ser sempre um número par (ou seja, 00, 02, 04, 06...). Um endereço MAC típico pode ter o seguinte aspeto: 02:1E:2B:78:00:00. Utilize conjuntos MAC para implementações de longa duração para que os endereços MAC atribuídos sejam consistentes. Os conjuntos MAC são úteis se tiver um requisito de que as VMs têm 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 conjunto MAC que pretende utilizar para a VM do anfitrião Azure Kubernetes Service. A sintaxe do endereço MAC requer que o bit menos significativo do primeiro byte seja sempre 0 e o primeiro byte deve ser sempre um número par (ou seja, 00, 02, 04, 06...). O primeiro byte do endereço transmitido como -macPoolEnd deve ser o mesmo que o primeiro byte do endereço transmitido como .-macPoolStart Utilize conjuntos MAC para implementações de longa duração para que os endereços MAC atribuídos sejam consistentes. Os conjuntos MAC são úteis se tiver um requisito de que as VMs têm 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

-proxySettings

O objeto proxy criado com 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. Este valor deve ser fornecido com o formato CIDR; por exemplo, 192.168.1.2/16. Poderá 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 é alterado. 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 pretende implementar. A predefinição é a versão mais recente. Não recomendamos que altere a predefiniçã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 de porta TCP/IP no qual os agentes de nó devem escutar, que é predefinido para 45000. Não recomendamos que altere a predefiniçã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 de porta TCP/IP que os agentes de nós devem utilizar para a respetiva porta de autorização. A predefinição é 45001. Não recomendamos que altere a predefiniçã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 de porta TCP/IP em que o agente da cloud deve escutar. A predefinição é 55000. Não recomendamos que altere a predefiniçã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 de porta TCP/IP que o agente da cloud deve utilizar para a respetiva porta de autorização. A predefinição é 65000. Não recomendamos que altere a predefiniçã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 utilizar ao criar o agente da cloud como um serviço genérico no cluster. Este parâmetro é predefinido para um nome exclusivo com um prefixo de ca- e um sufixo GUID. Não recomendamos que altere a predefiniçã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 localização da Cloud Operado pela Microsoft personalizado. O nome predefinido é MocLocation. Não recomendamos que altere a predefiniçã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 a utilização desta definiçã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 as capacidades de remoting para nós locais e remotos. Não recomendamos a utilização desta definiçã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 do AKS, como o agente da cloud e os agentes de nós, no modo inseguro (sem ligações protegidas por TLS). Não recomendamos a utilização 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

Utilize este sinalizador se quiser ignorar quaisquer atualizações disponíveis. Não recomendamos a utilização desta definiçã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 ocorrer este problema, verá que Install-AksHci está bloqueado num ciclo. Para ultrapassar este problema, tente utilizar este sinalizador. O -forceDnsReplication sinalizador não é uma correção garantida. Se a lógica por trás do sinalizador falhar, o erro é ocultado e o comando continua 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

Utilize este sinalizador se quiser ignorar as verificações de validação da infraestrutura do ambiente e da entrada de configuração do utilizador. Estas verificações realçam potenciais problemas a resolver antes de prosseguir com a instalação. Não recomendamos a utilização desta definiçã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

Passos seguintes

Referência do PowerShell do AksHci