Instalar o mecanismo do AKS no Windows no Azure Stack Hub

Artigo
12/01/2023

Os downloads binários para a versão mais recente do Mecanismo do AKS estão disponíveis no Github. Baixe o pacote para seu sistema operacional e extraia o arquivo aks-engine para as versões 0.73.0 do Mecanismo do AKS e abaixo. Para as versões 0.75.3 do Mecanismo do AKS e superiores, extraia o arquivo aks-engine-azurestack (e, opcionalmente, adicione-o à variável $PATH de ambiente para uso mais conveniente da CLI).

Preparar a VM do cliente

O mecanismo do AKS é uma ferramenta de linha de comando usada para implantar e gerenciar o cluster do Kubernetes. Você pode executar o mecanismo em um computador no Azure Stack Hub. Neste computador, execute o mecanismo do AKS para implantar os recursos de IaaS e o software necessários para executar o cluster. Em seguida, você pode usar o computador que executa o mecanismo para executar tarefas de gerenciamento em seu cluster.

Ao escolher seu computador cliente, considere:

Se o computador cliente deve ser recuperável em um desastre.
Como você se conectará ao computador cliente e como o computador interagirá com seu cluster?

Instalar o Mecanismo do AKS em um ambiente conectado

Você pode instalar a VM cliente para gerenciar o cluster do Kubernetes em um Azure Stack Hub conectado à Internet.

Crie uma VM do Windows no Azure Stack Hub. Para obter instruções, confira Início Rápido: Criar uma VM do servidor Windows usando o portal do Azure Stack Hub.
Conecte-se à VM.
Instale o Chocolatey usando as instruções do PowerShell.

De acordo com o site chocolatey: Chocolatey é um gerente de pacotes para Windows, como apt-get ou yum, mas para Windows. Ele foi projetado para ser uma estrutura descentralizada para instalar rapidamente aplicativos e ferramentas de que você precisa. Ele é criado na infraestrutura do NuGet atualmente usando o PowerShell como foco para entregar pacotes das distribuições para seu computador, err, porta.
Instale a CLI do Azure. Selecione o link de download e escolha "Executar". Escolha as etapas de configuração conforme necessário.
Localize a versão do mecanismo do AKS na tabela de mapeamento de versão do mecanismo do AKS e no Azure Stack . O Mecanismo base do AKS deve estar disponível no Marketplace do Azure Stack Hub. Ao executar o comando, você deve especificar a versão --version v0.xx.x. Se você não especificar a versão, o comando instalará a versão mais recente, que pode precisar de uma imagem VHD que não esteja disponível no marketplace.

Observação

Você pode encontrar o mapeamento do número de versão do mecanismo do Azure Stack Hub para AKS nas notas de versão do mecanismo do AKS.
Execute o seguinte comando em um prompt com privilégios elevados e inclua o número de versão:

Observação

Para o AKSe versão 0.75.3 e superior, o comando para instalar o mecanismo do AKS é choco install aks-engine-azurestack.
```
    choco install aks-engine --version 0.xx.x -y
```
Observação

Se esse método de instalação falhar, você poderá tentar as etapas para um ambiente desconectado abaixo.

Instalar o Mecanismo do AKS em um ambiente desconectado

Você pode instalar a VM cliente para gerenciar o cluster do Kubernetes em um Azure Stack Hub desconectado da Internet.

Em um computador com acesso à Internet, acesse GitHub Azure/aks-engine. Baixe um arquivo morto (*.tar.gz) para um computador Windows, por exemplo, aks-engine-v0.xx.x-windows-amd64.tar.gz. Localize a versão do mecanismo do AKS na tabela Versões do Kubernetes com suporte.
Crie uma conta de armazenamento em sua instância do Azure Stack Hub para carregar o arquivo morto (*.tar.gz) com o binário do mecanismo do AKS. Para obter instruções sobre como usar o Gerenciador de Armazenamento do Azure, consulte Gerenciador de Armazenamento do Azure com o Azure Stack Hub.
Crie uma VM do Windows no Azure Stack Hub. Para obter instruções, confira Início Rápido: Criar uma VM do servidor Windows usando o portal do Azure Stack Hub
Na URL do blob da conta de armazenamento do Azure Stack Hub em que você carregou o arquivo morto (*.tar.gz), baixe o arquivo na VM de gerenciamento. Extraia o arquivo morto para um diretório ao qual você tem acesso no prompt de comando.
Conecte-se à VM.
Instale o Chocolatey usando as instruções do PowerShell.
Execute o comando a seguir em um prompt com privilégios elevados. Inclua o número de versão certo:

Observação

Para o AKSe versão 0.75.3 e superior, o comando para instalar o mecanismo do AKS é choco install aks-engine-azurestack.
```
    choco install aks-engine --version 0.xx.x -y
```

Verificar a instalação

Depois que a VM do cliente estiver configurada, marcar que você instalou o mecanismo do AKS.

Conecte-se à VM cliente.
Execute o seguinte comando:

Observação

Para o AKSe versão 0.75.3 e superior, o comando para marcar a versão atual do mecanismo do AKS é aks-engine-azurestack version.
```
aks-engine version
```

Se você não conseguir verificar se instalou o mecanismo do AKS na VM cliente, confira Solucionar problemas de instalação do mecanismo do AKS.

Instalação do ASDK

Você precisa adicionar um certificado ao executar a VM cliente para o mecanismo do AKS no ASDK em um computador fora do ASDK. Se você estiver usando uma VM do Windows dentro do próprio ambiente do ASDK, o computador já confiará no certificado ASDK. Se o computador cliente estiver fora do ASDK, você precisará extrair o certificado do ASDK e adicioná-lo ao computador Windows.

Quando você estiver usando um ASDK, seu ponto de extremidade Resource Manager do Azure estiver usando um certificado autoassinado, você precisará adicionar explicitamente esse certificado ao repositório de certificados confiável do computador. Você pode encontrar o certificado raiz do ASDK em qualquer VM implantada no ASDK.

Exportar o certificado raiz da AC. Para obter instruções, consulte Exportar o certificado raiz de AC do Azure Stack Hub.
Confie no certificado raiz da AC do Azure Stack Hub. Para obter instruções, confira Confiar no certificado raiz de AC do Azure Stack Hub.

Próximas etapas

Implantar um cluster do Kubernetes com o mecanismo do AKS no Azure Stack Hub