Set-AksHciConfig

Sinopse

Defina ou atualize as definições de configuração para o anfitrião do Serviço Azure Kubernetes.

Syntax

Configuração definida para anfitrião

Set-AksHciConfig  -imageDir <String>
                  -workingDir <String>
                  -cloudConfigLocation <String>
                  -vnet <Virtual Network>
                 [-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>]
                 [-skipHostLimitChecks]
                 [-skipRemotingChecks]
                 [-insecure]
                 [-skipUpdates]
                 [-forceDnsReplication]   

Description

Defina as definições de configuração para o anfitrião do Serviço Azure Kubernetes. Se estiver a implantar um cluster HCI do nó 2-4 ou um cluster de failover do Datacenter 2019 do Windows Server 2019, tem de especificar os parâmetros de funcionamento do Dir e da cloudConfigLocation. Para um único nó Windows Datacenter Do Servidor 2019, todos os parâmetros são opcionais e definidos para os seus valores predefinidos. No entanto, para um melhor desempenho, recomendamos a utilização de um cluster HCI de 2-4 no nó Azure Stack.

Exemplos

Para implantar num aglomerado de nó 2-4 com rede DHCP e um VLAN

PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -vlanID 7

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Para implantar num cluster de nó 2-4 com rede DHCP sem um VLAN

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\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Para implementar com rede IP estática e um VLAN

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" -vlanID 7

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Para implementar com rede IP estática sem um VLAN

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\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Para implementar com um servidor proxy

PS C:\> $proxySetting = 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\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -proxySetting $proxySettings -vnet $vnet -cloudservicecidr "172.16.10.10/16"

Para implementar com um serviço de cluster de agente de nuvem pré-configurado e um registo DNS

Antes de executar este exemplo, você precisa de obter um serviço de cluster genérico em Ative Direy com o nome ca-cloudagent (ou um nome à sua escolha), mas não exceder 32 caracteres de comprimento. Também precisa de criar um registo de DNS associado que indique o FQDN do serviço genérico de cluster com o cloudservicecidr endereço fornecido.

A implantação de HCI AKS on Azure Stack tentará localizar o especificado clusterRoleName no Ative Directory antes de prosseguir com a implantação.

Nota

Uma vez implementada a AKS no Azure Stack HCI, esta informação não pode ser alterada.

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" -vlanID 7

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"

Parâmetros

-imagemDir

O caminho para o diretório onde o Serviço Azure Kubernetes na Azure Stack HCI irá armazenar as suas imagens VHD. Este parâmetro é obrigatório. O caminho deve apontar para um caminho de armazenamento compartilhado, C:\ClusterStorage\Volume2\ImageStore como, ou uma quota 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

Este é um diretório de trabalho para o módulo a utilizar para armazenar pequenos ficheiros. Este parâmetro é obrigatório. O caminho deve apontar para um caminho de armazenamento compartilhado, como c:\ClusterStorage\Volume2\ImageStore ou uma quota SMB, tais como \\FileShare\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 onde o agente de nuvem irá armazenar a sua configuração. Este parâmetro é obrigatório. O caminho deve apontar para um caminho de armazenamento compartilhado, C:\ClusterStorage\Volume2\ImageStore como, ou uma quota SMB, como \\FileShare\ImageStore . A localização precisa estar numa parte altamente disponível para que o armazenamento seja 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 comando.

Type: VirtualNetwork
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-nodeConfigLocation

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. Este local deve ser um caminho local. Predefinições %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

-controlePlaneVmSize

O tamanho do VM para criar para o plano de controlo. Para obter uma lista de tamanhos VM disponíveis, corra Get-AksHciVmSize .

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: Standard_A2_V2
Accept pipeline input: False
Accept wildcard characters: False

-sshPublicKey

Caminho para um ficheiro chave público SSH. Utilizando esta chave pública, poderá iniciar sessão em qualquer um dos VMs criados pelo Serviço Azure Kubernetes na implementação do HCI Azure Stack. Se tiver a sua própria chave pública SSH, passará a sua localização aqui. Se não for fornecida nenhuma chave, procuraremos uma em %systemdrive%\akshci\.ssh\akshci_rsa .pub. Se o ficheiro não existir, será gerado e utilizado um par de chaves SSH na localização acima.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-macPoolStart

Isto é usado para especificar o início do endereço MAC da piscina MAC que deseja utilizar para o VM anfitrião do Serviço Azure Kubernetes. A sintaxe para o endereço MAC requer que a parte menos significativa do primeiro byte deve ser 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 parecer: 02:1E:2B:78:00:00. Utilize piscinas MAC para implementações de longa duração para que os endereços MAC atribuídos sejam consistentes. As piscinas MAC são úteis se você tiver um requisito de que os VMs têm endereços MAC específicos. A predefinição é nenhum.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-macPoolEnd

Isto é usado para especificar o fim do endereço MAC da piscina MAC que deseja usar para o VM anfitrião do Serviço Azure Kubernetes. A sintaxe para o endereço MAC requer que a parte menos significativa do primeiro byte deve ser 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 passado como -macPoolEnd deve ser o mesmo que o primeiro byte do endereço passado como o -macPoolStart. Utilize piscinas MAC para implementações de longa duração para que os endereços MAC atribuídos sejam consistentes. As piscinas MAC são úteis se você tiver um requisito de que os VMs têm endereços MAC específicos. A predefinição é nenhum.

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

Isto pode ser usado para fornecer um prefixo IP/rede estático para ser atribuído ao serviço MOC CloudAgent. Este valor deve ser fornecido utilizando o formato CIDR. (Exemplo: 192.168.1.2/16). Pode querer especificar isto para garantir que qualquer coisa importante na rede esteja sempre acessível porque o endereço IP não será alterado. A predefinição é nenhum.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-versão

A versão do Serviço Azure Kubernetes no Azure Stack HCI que pretende implementar. O padrão é a versão mais recente. Não recomendamos a alteração do 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 que os agentes de nó devem ouvir, o que é padrão para 45000. Não recomendamos a alteração do 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 utilizar para a sua porta de autorização. Incumprimentos para 45001. Não recomendamos a alteração do 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 de nuvem deve ouvir. Incumprimentos para 55000. Não recomendamos a alteração do 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 utilizar para a sua porta de autorização. Incumprimentos para 65000. Não recomendamos a alteração do 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

Isto especifica o nome a utilizar ao criar um agente de nuvem como um serviço genérico dentro do cluster. Isto é um defeito para um nome único com um prefixo de ca- e um sufixo guia (por exemplo: "ca-9e6eb299-bc0b-4f00-9fd7-942843820c26"). Não recomendamos a alteração do 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

Este parâmetro fornece um nome de localização personalizado da Microsoft Operated Cloud. O nome padrão é "MocLocation". Não recomendamos a alteração do 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 ao script que ignore quaisquer verificações que faça para confirmar que o espaço de memória e disco está disponível 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 ao script que ignore quaisquer verificações que faça para confirmar capacidades de remoing 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

-insegura

Implementa o Serviço Azure Kubernetes em componentes HCI Azure Stack, tais como agentes de nuvem e agentes de nó, em modo inseguro (sem ligações seguras TLS).  Não recomendamos a utilização de modos inseguros 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 esta bandeira se pretender 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

-forceDnsReplicação

A replicação do DNS pode demorar até uma hora em alguns sistemas. Isto fará com que a implantação seja lenta. Se chegares a este assunto, verás que o Install-AksHci vai ficar preso num ciclo. Para ultrapassar esta questão, tente usar esta bandeira. A bandeira de "força Respirção" não é uma correção garantida. Se a lógica por trás da bandeira falhar, o erro será escondido, e o comando continuará como se a bandeira 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

Passos seguintes

Referência AksHci PowerShell