Instalar o mecanismo AKS no Windows no Azure Stack Hub

Downloads binários para a versão mais recente do AKS Engine 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 inferiores do AKS Engine. Para as versões 0.75.3 e superiores do AKS Engine, extraia o arquivo aks-engine-azurestack (e, opcionalmente, adicione-o à sua $PATH variável de ambiente para um uso mais conveniente da CLI).

Preparar a VM do cliente

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

Ao escolher a máquina do seu cliente, considere:

1. Se a máquina cliente deve ser recuperável em um desastre.
2. Como você se conecta à máquina cliente e como a máquina interage com seu cluster?

Instale o AKS Engine em um ambiente conectado

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

Motor AKS 0.81.1 ou posterior

Para instalar o AKS Engine versão 0.81.1 ou posterior:

1. Crie uma VM do Windows no seu Azure Stack Hub. Para obter instruções, consulte Guia de início rápido: criar uma VM do servidor Windows usando o portal do Azure Stack Hub.
2. Conecte-se à sua VM.
3. Vá para GitHub Azure/aks-engine-azurestack. Baixe um arquivo (*.tar.gz) para uma máquina Windows, por exemplo, aks-engine-azurestack-v0.xx.x-windows-amd64.tar.gz. Encontre a versão do AKS Engine na tabela Versões suportadas do Kubernetes.

Motor AKS 0.80.2 ou anterior

Para instalar o AKS Engine versão 0.80.2 ou anterior:

1. Instale o Chocolatey usando as instruções do PowerShell.

2. Instalar a CLI do Azure. Selecione o link de download e escolha "Executar". Escolha as etapas de configuração conforme necessário.

3. Encontre a versão do mecanismo AKS no mecanismo AKS e na tabela de tabela de mapeamento de versão do Azure Stack. O AKS Base Engine deve estar disponível no seu Azure Stack Hub Marketplace. 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 está disponível em seu mercado.

   Nota

   Você pode encontrar o mapeamento do Azure Stack Hub para o número da versão do mecanismo AKS nas notas de versão do mecanismo AKS.

4. Execute o seguinte comando a partir de um prompt elevado e inclua o número da versão:

   Nota

   Para AKSe versão 0.75.3 e superior, o comando para instalar o motor AKS é choco install aks-engine-azurestack.

       choco install aks-engine --version 0.xx.x -y
   

   Nota

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

Instalar o AKS Engine em um ambiente desconectado

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

1. Em uma máquina com acesso à Internet, vá para GitHub Azure/aks-engine-azurestack. Baixe um arquivo (*.tar.gz) para uma máquina Windows, por exemplo, aks-engine-azurestack-v0.xx.x-windows-amd64.tar.gz. Encontre a versão do mecanismo AKS na tabela Versões suportadas do Kubernetes.

2. 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 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.

3. Crie uma VM do Windows no seu Azure Stack Hub. Para obter instruções, consulte Guia de início rápido: criar uma VM do servidor Windows usando o portal do Azure Stack Hub

4. Conecte-se à sua VM.

5. Na URL de blob da conta de armazenamento do Azure Stack Hub onde você carregou o arquivo morto (*.tar.gz), baixe o arquivo para sua VM de gerenciamento. Extraia o arquivo para um diretório ao qual você tenha acesso a partir do prompt de comando.

Verificar a instalação

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

1. Conecte-se à VM do cliente.

2. Execute o seguinte comando:

   Nota

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

   aks-engine version
   

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

Instalação ASDK

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

Quando você estiver usando um ASDK, seu ponto de extremidade do Azure Resource Manager estiver usando um certificado autoassinado, você precisará adicionar explicitamente esse certificado ao armazenamento de certificados confiáveis da máquina. Você pode encontrar o certificado raiz ASDK em qualquer VM implantada no ASDK.

1. Exporte o certificado raiz da autoridade de certificação. Para obter instruções, consulte Exportar o certificado raiz da CA do Azure Stack Hub.
2. Confie no certificado raiz da CA do Azure Stack Hub. Para obter instruções, consulte Confiar no certificado raiz da CA do Azure Stack Hub.

Próximos passos

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