Início rápido: configurar um host do serviço kubernetes do Azure em Azure Stack HCI usando o PowerShellQuickstart: Set up an Azure Kubernetes Service host on Azure Stack HCI using PowerShell

Aplica-se a: Azure Stack HCIApplies to: Azure Stack HCI

Neste guia de início rápido, você aprenderá a configurar um host do serviço kubernetes do Azure em Azure Stack HCI usando o PowerShell.In this quickstart, you'll learn how to set up an Azure Kubernetes Service host on Azure Stack HCI using PowerShell. Para usar o centro de administração do Windows, consulte configurar com o centro de administração do Windows.To instead use Windows Admin Center, see Set up with Windows Admin Center.

Antes de começarBefore you begin

Antes de começar, verifique se você tem um nó 2-4 Azure Stack cluster de HCI ou um único nó Azure Stack HCI.Before you begin, make sure you have a 2-4 node Azure Stack HCI cluster or a single node Azure Stack HCI. É recomendável ter um nó 2-4 Azure Stack cluster HCI.We recommend having a 2-4 node Azure Stack HCI cluster. Caso contrário, siga as instruções na página de registro Azure Stack HCI.If you don't, follow instructions on the Azure Stack HCI registration page.

Etapa 1: baixar e instalar o módulo do PowerShell do AksHciStep 1: Download and install the AksHci PowerShell module

Baixe o AKS-HCI-Public=Preview-Oct-2020 do serviço kubernetes do Azure na página de registro Azure Stack HCI.Download the AKS-HCI-Public=Preview-Oct-2020 from the Azure Kubernetes Service on Azure Stack HCI registration page. O arquivo zip AksHci.Powershell.zip contém o módulo do PowerShell.The zip file AksHci.Powershell.zip contains the PowerShell module.

Se você já tiver instalado o serviço kubernetes do Azure em Azure Stack HCI usando o PowerShell ou o centro de administração do Windows, execute o comando a seguir antes de continuar.If you have previously installed Azure Kubernetes Service on Azure Stack HCI using PowerShell or Windows Admin Center, run the following command before proceeding.

Uninstall-AksHci

Feche todas as janelas do PowerShell.Close all PowerShell windows. Exclua todos os diretórios existentes para AksHci, AksHci. Day2 e MSK8sDownloadAgent localizados no caminho %systemdrive%\program files\windowspowershell\modules .Delete any existing directories for AksHci, AksHci.Day2, and MSK8sDownloadAgent located in the path %systemdrive%\program files\windowspowershell\modules. Quando isso for feito, você poderá extrair o conteúdo do novo arquivo zip.Once this is done, you can extract the contents of the new zip file. Certifique-se de extrair o arquivo zip no local correto ( %systemdrive%\program files\windowspowershell\modules ).Make sure to extract the zip file in the correct location (%systemdrive%\program files\windowspowershell\modules).

Import-Module AksHci

Depois de executar o comando acima, feche todas as janelas do PowerShell e reabra uma sessão administrativa para executar os comandos nas etapas a seguir.After running the above command, close all PowerShell windows and reopen an administrative session to run the commands in the following steps.

Etapa 2: preparar seu (s) computador (es) para implantaçãoStep 2: Prepare your machine(s) for deployment

Execute verificações em cada nó físico para ver se todos os requisitos estão satisfeitos em instalar o serviço kubernetes do Azure em Azure Stack HCI.Run checks on every physical node to see if all the requirements are satisfied to install Azure Kubernetes Service on Azure Stack HCI.

Abra o PowerShell como administrador e execute o comando a seguir.Open PowerShell as an administrator and run the following command.

Initialize-AksHciNode

Quando as verificações forem concluídas, você verá "concluído" exibido em texto verde.When the checks are finished, you'll see "Done" displayed in green text.

Etapa 3: configurar sua implantaçãoStep 3: Configure your deployment

Defina as definições de configuração para o host do serviço kubernetes do Azure.Set the configuration settings for the Azure Kubernetes Service host. Para um nó 2-4 Azure Stack cluster HCI, você deve especificar MultiNode nos -deploymentType wssdImageDir cloudConfigLocation parâmetros e.For a 2-4 node Azure Stack HCI cluster, you must specify MultiNode in the -deploymentType, the wssdImageDir and cloudConfigLocation parameters. Para um nó Azure Stack o cluster HCI, todos os parâmetros são opcionais e definidos com seus valores padrão.For a 1 node Azure Stack HCI cluster, all parameters are optional and set to their default values. No entanto, para um desempenho ideal, é recomendável usar um nó 2-4 Azure Stack implantação de cluster de HCI.However, for optimal performance, we recommend using a 2-4 node Azure Stack HCI cluster deployment.

Configure sua implantação com o comando a seguir.Configure your deployment with the following command.

Set-AksHciConfig [-deploymentType {SingleNode, MultiNode}]
                 [-wssdImageDir]
                 [-cloudConfigLocation]
                 [-nodeConfigLocation]
                 [-vnetName]
                 [-controlPlaneVmSize]
                 [-loadBalancerVmSize]
                 [-sshPublicKey]
                 [-vipPoolStartIp]
                 [-vipPoolEndIp]
                 [-macPoolStart]
                 [-macPoolEnd]
                 [-vlanID]
                 [-cloudServiceCidr]
                 [-wssdDir]
                 [-akshciVersion]
                 [-vnetType]
                 [-nodeAgentPort]
                 [-nodeAgentAuthorizerPort]
                 [-clusterRoleName]
                 [-skipHostLimitChecks]
                 [-insecure]
                 [-skipUpdates]
                 [-forceDnsReplication]

Parâmetros opcionaisOptional parameters

-deploymentType

O tipo de implantação.The deployment type. Valores aceitos: SingleNode, vários node.Accepted values: SingleNode, MultiNode. O padrão é SingleNode.Defaults to SingleNode.

-wssdImageDir

O caminho para o diretório em que o serviço kubernetes do Azure em Azure Stack HCI armazenará suas imagens VHD.The path to the directory where Azure Kubernetes Service on Azure Stack HCI will store its VHD images. O padrão é para %systemdrive%\wssdimagestore implantações de nó único.Defaults to %systemdrive%\wssdimagestore for single node deployments. Para implantações de vários nós, esse parâmetro deve ser especificado.For multi-node deployments, this parameter must be specified. O caminho deve apontar para um caminho de armazenamento compartilhado, como  C:\ClusterStorage\Volume2\ImageStore   ou um compartilhamento SMB, como  \\FileShare\ImageStore .The path must point to a shared storage path such as C:\ClusterStorage\Volume2\ImageStore or an SMB share such as \\FileShare\ImageStore.

-cloudConfigLocation

O local em que o Cloud Agent armazenará sua configuração.The location where the cloud agent will store its configuration. O padrão é para %systemdrive%\wssdimagestore implantações de nó único.Defaults to %systemdrive%\wssdimagestore for single node deployments. O local pode ser o mesmo que o caminho  -wssdImageDir acima.The location can be the same as the path of -wssdImageDir above.Para implantações de vários nós, esse parâmetro deve ser especificado. For *multi-node deployments, this parameter must be specified*.

-nodeConfigLocation

O local em que os agentes de nó armazenarão sua configuração.The location where the node agents will store their configuration. Esse deve ser um caminho local.This must be a local path.

-vnetName

O nome do comutador virtual ao qual conectar as máquinas virtuais.The name of the virtual switch to connect the virtual machines to. O padrão é o nome "externo".Defaults to “External” name. A opção será criada se não existir.The switch will be created if it does not exist.

-controlPlaneVmSize

O tamanho da VM a ser criada para o plano de controle.The size of the VM to create for the control plane. Para obter uma lista de tamanhos de VM disponíveis, execute Get-AksHciVmSize .To get a list of available VM sizes, run Get-AksHciVmSize.

-loadBalancerVmSize

O tamanho da VM a ser criada para as VMs Load Balancer.The size of the VM to create for the Load Balancer VMs. Para obter uma lista de tamanhos de VM disponíveis, execute Get-AksHciVmSize .To get a list of available VM sizes, run Get-AksHciVmSize.

-sshPublicKey

Caminho para um arquivo de chave pública SSH.Path to an SSH public key file. Usando essa chave pública, você poderá fazer logon em qualquer uma das VMs criadas pelo serviço kubernetes do Azure na implantação Azure Stack HCI.Using this public key, you will be able to log in to any of the VMs created by the Azure Kubernetes Service on Azure Stack HCI deployment. Se nenhuma chave for fornecida, procuraremos uma em  %systemdrive%\Users\<username>\.ssh\id_rsa.pub .If no key is provided, we will look for one under %systemdrive%\Users\<username>\.ssh\id_rsa.pub. Se o arquivo não existir, um par de chaves SSH no local acima será gerado e usado.If file does not exist, an SSH key pair in the above location will be generated and used.

-vipPoolStartIp

Ao usar pools VIP para sua implantação, esse parâmetro especifica o início da rede do pool.When using VIP pools for your deployment, this parameter specifies the network start of the pool. O padrão é nenhum.Default is none.

-vipPoolEndIp

Ao usar pools VIP para sua implantação, esse parâmetro especifica a extremidade da rede do pool.When using VIP pools for your deployment, this parameter specifies the network end of the pool. O padrão é nenhum.Default is none.

-macPoolStart

Isso é usado para especificar o início do endereço MAC do pool de MAC que você deseja usar para a VM do host do serviço kubernetes do Azure.This is used to specify the start of the MAC address of the MAC pool that you wish to use for the Azure Kubernetes Service host VM. A sintaxe para o 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 ser semelhante A: 02:1E: 2B: 78:00:00.The syntax for the MAC address requires that the least significant bit of the first byte should always be 0, and the first byte should always be an even number (i.e. 00, 02, 04, 06...). A typical MAC address can look like: 02:1E:2B:78:00:00. O padrão é nenhum.Default is none.

-macPoolEnd

Isso é usado para especificar o fim do endereço MAC do pool de MAC que você deseja usar para a VM do host do serviço kubernetes do Azure.This is used to specify the end of the MAC address of the MAC pool that you wish to use for the Azure Kubernetes Service host VM. A sintaxe para o 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 -macPoolEnd deve ser o mesmo que o primeiro byte do endereço passado como o -macPoolStart .The syntax for the MAC address requires that the least significant bit of the first byte should always be 0, and the first byte should always be an even number (i.e. 00, 02, 04, 06...). The first byte of the address passed as the -macPoolEnd should be the same as the first byte of the address passed as the -macPoolStart. O padrão é nenhum.Default is none.

-vlandID

Isso pode ser usado para especificar uma ID de VLAN de rede.This can be used to specify a network VLAN ID. Os adaptadores de rede do host do serviço kubernetes do Azure e da VM do cluster kubernetes serão marcados com a ID de VLAN fornecida.Azure Kubernetes Service host and Kubernetes cluster VM network adapters will be tagged with the provided VLAN ID. O padrão é nenhum.Default is none.

cloudServiceCidr

Isso pode ser usado para fornecer um prefixo de IP/rede estático a ser atribuído ao serviço CloudAgent do MOC.This can be used to provide a static IP/network prefix to be assigned to the MOC CloudAgent service. Esse valor deve ser fornecido usando o formato CIDR.This value should be provided using the CIDR format. (Exemplo: 192.168.1.2/16).(Example: 192.168.1.2/16). O padrão é nenhum.Default is none.

-wssdDir

Esse é um diretório de trabalho para o módulo usar para armazenar arquivos pequenos.This is a working directory for the module to use for storing small files. O padrão é %PROGRAMFILES%\AksHci   e não deve ser alterado para a maioria das implantações.Defaults to %PROGRAMFILES%\AksHci and should not be changed for most deployments.

-akshciVersion

A versão do serviço kubernetes do Azure em Azure Stack HCI que você deseja implantar.The version of Azure Kubernetes Service on Azure Stack HCI that you want to deploy. O padrão é a última versão.The default is the latest version.

-vnetType

O tipo de comutador virtual ao qual se conectar ou criar.The type of virtual switch to connect to or create. O padrão é o tipo de comutador "external".This defaults to “External” switch type.

-nodeAgentPort

O número da porta TCP/IP em que nodeagents deve escutar.The TCP/IP port number that nodeagents should listen on. O padrão é 45000.Defaults to 45000.

-nodeAgentAuthorizerPort

O número da porta TCP/IP que nodeagents deve usar para sua porta de autorização.The TCP/IP port number that nodeagents should use for their authorization port. O padrão é 45001.Defaults to 45001.

-clusterRoleName

Isso especifica o nome a ser usado ao criar cloudagent como um serviço genérico dentro do cluster.This specifies the name to use when creating cloudagent as a generic service within the cluster. O padrão é um nome exclusivo com um prefixo de CA-e um sufixo GUID (por exemplo: "CA-9e6eb299-bc0b-4F00-9fd7-942843820c26")This defaults to a unique name with a prefix of ca- and a guid suffix (for example: “ca-9e6eb299-bc0b-4f00-9fd7-942843820c26”)

-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.Requests the script to skip any checks it does to confirm memory and disk space is available before allowing the deployment to proceed.

-insecure

Implanta o serviço kubernetes do Azure em Azure Stack componentes do HCI, como cloudagent e nodeagent (s) no modo inseguro (sem conexões TLS protegidas).Deploys Azure Kubernetes Service on Azure Stack HCI components such as cloudagent and nodeagent(s) in insecure mode (no TLS secured connections).Não é recomendável usar o modo inseguro em ambientes de produção.  It is not recommended to use insecure mode in production environments.

-skipUpdates

Use esse sinalizador se desejar ignorar todas as atualizações disponíveis.Use this flag if you want to skip any updates available.

-forceDnsReplication

A replicação do DNS pode levar até uma hora em alguns sistemas.DNS replication can take up to an hour on some systems. Isso fará com que a implantação seja lenta.This will cause the deployment to be slow. Se você atingir esse problema, verá que o Install-AksHci ficará preso em um loop.If you hit this issue, you'll see that the Install-AksHci will be stuck in a loop. Para passar por esse problema, tente usar esse sinalizador.To get past this issue, try to use this flag. O -forceDnsReplication sinalizador não é uma correção garantida.The -forceDnsReplication flag is not a guaranteed fix. 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.If the logic behind the flag fails, the error will be hidden, and the command will carry on as if the flag was not provided.

Redefinir o serviço kubernetes do Azure na configuração do HCI Azure StackReset the Azure Kubernetes Service on Azure Stack HCI configuration

Para redefinir o serviço kubernetes do Azure na configuração do HCI Azure Stack, execute o comando a seguir.To reset the Azure Kubernetes Service on Azure Stack HCI configuration, run the following command. Executar esse comando por conta própria redefinirá a configuração para os valores padrão.Running this command on its own will reset the configuration to default values.

Set-AksHciConfig

Etapa 4: iniciar uma nova implantaçãoStep 4: Start a new deployment

Depois de configurar a implantação, você deve iniciar a implantação.After you've configured your deployment, you must start deployment. Isso instalará o serviço kubernetes do Azure em Azure Stack agentes/serviços do HCI e o host do serviço kubernetes do Azure.This will install the Azure Kubernetes Service on Azure Stack HCI agents/services and the Azure Kubernetes Service host.

Para iniciar a implantação, execute o comando a seguir.To begin deployment, run the following command.

Install-AksHci

Verifique seu host do serviço de kubernetes do Azure implantadoVerify your deployed Azure Kubernetes Service host

Para garantir que o host do serviço kubernetes do Azure foi implantado, execute o comando a seguir.To ensure that your Azure Kubernetes Service host was deployed, run the following command. Você também poderá obter clusters kubernetes usando o mesmo comando depois de implantá-los.You will also be able to get Kubernetes clusters using the same command after deploying them.

Get-AksHciCluster

Etapa 5: acessar seus clusters usando o kubectlStep 5: Access your clusters using kubectl

Para acessar o host do serviço kubernetes do Azure ou o cluster kubernetes usando o kubectl, execute o comando a seguir.To access your Azure Kubernetes Service host or Kubernetes cluster using kubectl, run the following command. Isso usará o arquivo kubeconfig do cluster especificado como o arquivo kubeconfig padrão para kubectl.This will use the specified cluster's kubeconfig file as the default kubeconfig file for kubectl.

Get-AksHciCredential -clusterName
                     [-outputLocation]

Parâmetros ExigidosRequired Parameters

clusterName

O nome do cluster.The name of the cluster.

Parâmetros OpcionaisOptional Parameters

outputLocation

A localização era que o kubeconfig foi baixado.The location were you want the kubeconfig downloaded. O padrão é %USERPROFILE%\.kube.Default is %USERPROFILE%\.kube.

Obter logsGet logs

Para obter logs de todos os seus pods, execute o comando a seguir.To get logs from your all your pods, run the following command. Esse comando criará uma pasta compactada de saída chamada akshcilogs no caminho C:\wssd\akshcilogs .This command will create an output zipped folder called akshcilogs in the path C:\wssd\akshcilogs.

Get-AksHciLogs

Reinstalar o serviço kubernetes do Azure no HCI Azure StackReinstall Azure Kubernetes Service on Azure Stack HCI

Reinstalar o serviço kubernetes do Azure no Azure Stack HCI removerá todos os seus clusters kubernetes, se houver, e o host do serviço Azure kubernetes.Reinstalling Azure Kubernetes Service on Azure Stack HCI will remove all of your Kubernetes clusters if any, and the Azure Kubernetes Service host. Ele também desinstalará o serviço kubernetes do Azure em Azure Stack agentes e serviços do HCI dos nós.It will also uninstall the Azure Kubernetes Service on Azure Stack HCI agents and services from the nodes. Em seguida, ele voltará pelas etapas do processo de instalação original até que o host seja recriado.It will then go back through the original install process steps until the host is recreated. O serviço kubernetes do Azure em Azure Stack configuração do HCI que você configurou por meio Set-AksHciConfig do e as imagens VHDX baixadas são preservadas.The Azure Kubernetes Service on Azure Stack HCI configuration that you configured via Set-AksHciConfig and the downloaded VHDX images are preserved.

Para reinstalar o serviço kubernetes do Azure em Azure Stack HCI, execute o comando a seguir.To reinstall Azure Kubernetes Service on Azure Stack HCI, run the following command.

Restart-AksHci

Remover o serviço kubernetes do Azure no HCI Azure StackRemove Azure Kubernetes Service on Azure Stack HCI

Para remover o serviço kubernetes do Azure em Azure Stack HCI, execute o comando a seguir.To remove Azure Kubernetes Service on Azure Stack HCI, run the following command.

Uninstall-AksHci

Próximas etapasNext steps