Set-AksHciConfig

Sinopse

Definir ou atualizar as definições de configuração para o host Serviço de Kubernetes do Azure aplicativo.

Syntax

Definir a configuração para o host

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

Definir as definições de configuração para o host Serviço de Kubernetes do Azure aplicativo. Se você estiver implantando em um cluster de 2 a 4 nós Azure Stack HCI ou em um cluster de failover do datacenter do Windows Server 2019, especifique os parâmetros -workingDir e -cloudConfigLocation. Para um único nó Windows Server 2019 Datacenter, todos os parâmetros são opcionais e definidos com seus valores padrão. No entanto, para um desempenho ideal, recomendamos usar uma implantação de cluster de 2 a 4 nós Azure Stack HCI cluster.

Exemplos

Para implantar em um cluster de 2 a 4 nós com rede DHCP e uma 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 em um cluster de 2 a 4 nós com rede DHCP sem uma 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 implantar com rede IP estática e uma 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 implantar com a rede IP estática sem uma 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 implantar 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 implantar com um serviço de cluster de agente de nuvem pré-configurado e um registro DNS

Antes de executar este exemplo, você precisa pré-executar um serviço de cluster genérico no Active Directory com o nome (ou um nome de sua escolha), mas não exceder ca-cloudagent 32 caracteres de comprimento. Você também precisa criar um registro DNS associado apontando para o FQDN do serviço de cluster genérico com o endereço cloudservicecidr fornecido.

O AKS em Azure Stack HCI implantação tentará localizar o especificado no clusterRoleName Active Directory antes de prosseguir com a implantação.

Observação

Depois que o AKS Azure Stack HCI é implantado, essas informações não podem ser alteradas.

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

-imageDir

O caminho para o diretório em que Serviço de Kubernetes do Azure no Azure Stack HCI armazenará suas imagens VHD. Esse parâmetro é obrigató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

Este é um diretório de trabalho para o módulo a ser usado para armazenar arquivos pequenos. Este parâmetro é obrigató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: True
Position: Named
Default value: %systemdrive%\AksHci
Accept pipeline input: False
Accept wildcard characters: False

-cloudConfigLocation

O local em que o agente de nuvem armazenará sua configuração. Este parâmetro é obrigató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 sempre seja 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 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 em que os agentes do nó armazenarão sua configuração. Cada nó tem um agente de nó, portanto, sua configuração é local para ele. Esse local deve ser um caminho local. O padrão é %systemdrive%\programdata\wssdagent para 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 criado 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_A2_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ê poderá fazer logoff em qualquer uma das VMs criadas pela Serviço de Kubernetes do Azure no Azure Stack HCI implantação. Se você tiver sua própria chave pública SSH, passará seu local aqui. Se nenhuma chave for fornecida, procuraremos uma em %systemdrive%\akshci\.ssh\akshci_rsa .pub. Se o arquivo não existir, um par de chaves SSH no local acima será gerado 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

Isso é usado para especificar o início do endereço MAC do pool de MAC que você deseja usar para a VM Serviço de Kubernetes do Azure host. 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 de mesmo valor (ou seja, 00, 02, 04, 06...). Um endereço MAC típico pode ser parecido com: 02:1E:2B:78:00:00. Use pools mac para implantações de longa duração para que os endereços MAC atribuídos sejam consistentes. Os pools mac são úteis se você tiver um requisito de que as VMs tenham endereços MAC específicos. O padrã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

Isso é usado para especificar o fim do endereço MAC do pool de MAC que você deseja usar para a VM Serviço de Kubernetes do Azure host. 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 de mesmo valor (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 -macPoolStart. Use pools mac para implantações de longa duração para que os endereços MAC atribuídos sejam consistentes. Os pools mac são úteis se você tiver um requisito de que as VMs tenham endereços MAC específicos. O padrã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

Isso pode ser usado para fornecer um prefixo de IP/rede estático a ser atribuído ao serviço CloudAgent do MOC. Esse valor deve ser fornecido usando o formato CIDR. (Exemplo: 192.168.1.2/16). Talvez você queira especificar isso para garantir que qualquer coisa importante na rede seja sempre acessível porque o endereço IP não será alterado. O padrão é nenhum.

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 Serviço de Kubernetes do Azure no Azure Stack HCI 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 na qual os agentes de nó devem escutar, que assume 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 sua 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 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

Isso especifica o nome a ser usado ao criar um agente de nuvem como um serviço genérico dentro do cluster. Isso assume como padrão um nome exclusivo com um prefixo de ca- e um sufixo guid (por exemplo: "ca-9e6eb299-bc0b-4f00-9fd7-942843820c26"). 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

Esse parâmetro fornece um nome de local personalizado da Nuvem 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 todas as verificações que ele faz para confirmar se a memória e o espaço em disco estão disponíveis antes de permitir que a implantação continue. Não recomendamos o uso dessa 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 que faz para confirmar os recursos de comunicação remota para nós locais e remotos. Não recomendamos o uso dessa 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

-Não seguro

Implanta o serviço kubernetes do Azure em Azure Stack componentes do HCI, como agente de nuvem e agente (s) de nó, em modo inseguro (sem conexões TLS protegidas).  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 esse sinalizador se desejar ignorar todas as atualizações disponíveis. Não recomendamos o uso dessa 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 do DNS pode levar até uma hora em alguns sistemas. Isso fará com que a implantação seja lenta. Se você atingir esse problema, verá que o Install-AksHci ficará preso em um loop. Para passar por esse problema, tente usar esse sinalizador. O sinalizador-forceDnsReplication não é uma correção garantida. Se a lógica por trás do sinalizador falhar, o erro será ocultado e o comando será executado 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

Próximas etapas

Referência do PowerShell do AksHci