Instalar o motor do AKS no Windows no Azure Stack Hub

Artigo
12/01/2023

As transferências binárias para a versão mais recente do Motor AKS estão disponíveis no Github. Transfira o pacote para o seu sistema operativo e extraia o ficheiro aks-engine para as versões 0.73.0 e abaixo do Motor AKS. Para as versões 0.75.3 e superiores do Motor AKS, extraia o ficheiro aks-engine-azurestack (e, opcionalmente, adicione-o à variável $PATH de ambiente para uma utilização mais conveniente da CLI).

Preparar a VM cliente

O motor do AKS é uma ferramenta de linha de comandos utilizada para implementar e gerir o cluster do Kubernetes. Pode executar o motor num computador no Azure Stack Hub. A partir deste computador, execute o motor do AKS para implementar os recursos e software IaaS necessários para executar o cluster. Em seguida, pode utilizar o computador que executa o motor para realizar tarefas de gestão no cluster.

Ao escolher o computador cliente, considere:

Se o computador cliente deve ser recuperável num desastre.
Como se ligará ao computador cliente e como a máquina irá interagir com o cluster?

Instalar o Motor AKS num ambiente ligado

Pode instalar a VM cliente para gerir o cluster do Kubernetes num Azure Stack Hub ligado à Internet.

Crie uma VM do Windows no Azure Stack Hub. Para obter instruções, veja Início Rápido: Criar uma VM do Windows Server com o portal do Azure Stack Hub.
Ligue-se à sua VM.
Instale o Chocolatey com as instruções do PowerShell.

De acordo com o site chocolatey: Chocolatey é um gestor de pacotes para Windows, como apt-get ou yum, mas para Windows. Foi concebido para ser uma arquitetura descentralizada para instalar rapidamente aplicações e ferramentas de que precisa. Baseia-se na infraestrutura NuGet que está atualmente a utilizar o PowerShell como foco para entregar pacotes das distribuições à sua porta, err, computador.
Instalar a CLI do Azure. Selecione a ligação de transferência e escolha "Executar". Escolha os passos de configuração conforme necessário.
Localize a versão do motor do AKS no motor do AKS e na tabela de tabela de mapeamento de versões do Azure Stack . O Motor Base do AKS tem de estar disponível no Marketplace do Azure Stack Hub. Ao executar o comando, tem de especificar a versão --version v0.xx.x. Se não especificar a versão, o comando instala a versão mais recente, que poderá necessitar de uma imagem VHD que não esteja disponível no marketplace.

Nota

Pode encontrar o mapeamento do Azure Stack Hub para o número da versão do motor do AKS nas notas de versão do motor AKS.
Execute o seguinte comando a partir de uma linha de comandos elevada e inclua o número da versão:

Nota

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

Se este método de instalação falhar, pode experimentar os passos para um ambiente desligado abaixo.

Instalar o Motor AKS num ambiente desligado

Pode instalar a VM cliente para gerir o cluster do Kubernetes num Azure Stack Hub desligado da Internet.

A partir de um computador com acesso à Internet, aceda a GitHub Azure/aks-engine. Transfira um arquivo (*.tar.gz) para um computador Windows, por exemplo, aks-engine-v0.xx.x-windows-amd64.tar.gz. Localize a versão do motor do AKS na tabela Versões do Kubernetes Suportadas.
Crie uma conta de armazenamento na instância do Azure Stack Hub para carregar o ficheiro de arquivo (*.tar.gz) com o binário do motor do AKS. Para obter instruções sobre como utilizar o Explorador de Armazenamento do Azure, veja Explorador de Armazenamento do Azure com o Azure Stack Hub.
Crie uma VM do Windows no Azure Stack Hub. Para obter instruções, veja Início Rápido: Criar uma VM do Windows Server com o portal do Azure Stack Hub
No URL do blob da conta de armazenamento do Azure Stack Hub, onde carregou o ficheiro de arquivo (*.tar.gz), transfira o ficheiro para a VM de gestão. Extraia o arquivo para um diretório ao qual tem acesso a partir da sua linha de comandos.
Ligue-se à sua VM.
Instale o Chocolatey com as instruções do PowerShell.
Execute o seguinte comando a partir de uma linha de comandos elevada. Inclua o número de versão correto:

Nota

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

Verificar a instalação

Assim que a VM cliente estiver configurada, verifique se instalou o motor do AKS.

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

Nota

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

Se não conseguir verificar se instalou o motor do AKS na VM cliente, veja Resolver problemas de instalação do motor do AKS.

Instalação do ASDK

Tem de adicionar um certificado ao executar a VM cliente do motor do AKS no ASDK num computador fora do ASDK. Se estiver a utilizar uma VM do Windows no próprio ambiente do ASDK, o computador já confia no certificado ASDK. Se o computador cliente estiver fora do ASDK, terá de extrair o certificado do ASDK e adicioná-lo ao seu computador Windows.

Quando estiver a utilizar um ASDK, o ponto final do Azure Resource Manager está a utilizar um certificado autoassinado, tem de adicionar explicitamente este certificado ao arquivo de certificados fidedigno do computador. Pode encontrar o certificado de raiz do ASDK em qualquer VM que implementar no ASDK.

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

Passos seguintes

Implementar um cluster do Kubernetes com o motor do AKS no Azure Stack Hub