Instalar o mecanismo do AKS no Linux no Azure Stack Hub

Você pode usar um computador Linux no Azure Stack Hub para hospedar o mecanismo do AKS para implantar e gerenciar um cluster do Kubernetes. Neste artigo, analisamos a preparação da VM do cliente para gerenciar o cluster para instâncias conectadas e desconectadas do Azure Stack Hub, verificar a instalação e configurar a VM cliente no ASDK.

Preparar a VM do cliente

O mecanismo do AKS é uma ferramenta de linha de comando usada para implantar e gerenciar seu cluster do Kubernetes. Você pode executar o mecanismo em um computador no Azure Stack Hub. Neste computador, você usa 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 no cluster.

Ao escolher sua máquina cliente, considere:

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

Instalar em um ambiente conectado

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

1. Crie uma VM linux no Azure Stack Hub. Para obter instruções, consulte Início Rápido: Criar uma VM do servidor Linux usando o portal do Azure Stack Hub.

2. Conecte-se à VM.

3. Use o gerenciador de pacotes para verificar se você tem as seguintes ferramentas instaladas:

   • jq um processador JSON.
   • curl – uma ferramenta para transferir arquivos usando uma variedade de protocolos de rede.
   • openssh um cliente ssh.
   • tar uma ferramenta usada para trabalhar com arquivos TAR.

4. Instale a CLI do Azure. Os pacotes para a CLI do Azure estão disponíveis para a maioria das distribuições. Você pode encontrar instruções em Instalar a CLI do Azure no Linux.

5. Localize a versão do mecanismo do AKS na tabela de tabela de mapeamento de versão do mecanismo do AKS e do Azure Stack. A imagem 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 em seu marketplace.

   Observação

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

6. Execute o comando a seguir:

   Para as versões do Mecanismo do AKS 0.73.0 e abaixo:

   sudo apt update
   sudo apt install jq
   curl -o get-akse.sh https://raw.githubusercontent.com/Azure/aks-engine/master/scripts/get-akse.sh
   chmod 700 get-akse.sh
   ./get-akse.sh --version v0.xx.x
   

   Para versões do Mecanismo do AKS 0.75.3 e superiores:

   sudo apt update
   sudo apt install jq
   curl -o get-akse.sh https://raw.githubusercontent.com/Azure/aks-engine-azurestack/master/scripts/get-akse.sh
   chmod 700 get-akse.sh
   ./get-akse.sh --version v0.xx.x
   

   Observação

   Se o método de instalação falhar, tente as etapas no ambiente desconectado.

Instalar em um ambiente desconectado

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

1. De um computador com acesso à Internet:

   Para versões 0.73.0 do Mecanismo do AKS e abaixo, acesse o GitHub Azure/aks-engine. Baixe um arquivo morto (*.tar.gz) para um computador Linux, por exemplo, aks-engine-v0.xx.x-linux-amd64.tar.gz.

   Para versões do Mecanismo do AKS 0.75.3 e posteriores, acesse o GitHub Azure/aks-engine-azurestack. Baixe um arquivo morto (*.tar.gz) para um computador Linux, por exemploaks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz,

   Localize a versão do mecanismo do AKS na tabela Versões do Kubernetes com suporte.

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

3. Crie uma VM linux no Azure Stack Hub. Para obter instruções, consulte Início Rápido: Criar uma VM do servidor Linux usando o portal do Azure Stack Hub.

4. Na URL do blob da conta de armazenamento do Azure Stack Hub em que você carregou o arquivo morto (*.tar.gz), baixe o arquivo para sua VM de gerenciamento. Extraia o arquivo morto para o diretório /usr/local/bin.

5. Conecte-se à VM.

6. Execute o comando a seguir:

   Para as versões do Mecanismo do AKS 0.73.0 e abaixo:

   curl -o aks-engine-v0.xx.x-linux-amd64.tar.gz <httpurl/aks-engine-v0.xx.x-linux-amd64.tar.gz>
   tar xvzf aks-engine-v0.xx.x-linux-amd64.tar.gz -C /usr/local/bin
   

   Para versões do Mecanismo do AKS 0.75.3 e superiores:

   curl -o aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz <httpurl/aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz>
   tar xvzf aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz -C /usr/local/bin
   

Verificar a instalação

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

1. Conecte-se à VM do cliente.
2. Execute o comando a seguir:

aks-engine version

3. Se o ponto de extremidade do Azure Resource Manager estiver usando um certificado autoassinado, você precisará adicionar explicitamente o certificado raiz ao repositório de certificados confiável do computador. Você pode encontrar o certificado raiz na VM neste diretório: /var/lib/waagent/Certificates.pem. Copie o arquivo de certificado com o seguinte comando:

   sudo cp /var/lib/waagent/Certificates.pem /usr/local/share/ca-certificates/azurestackca.crt 
   sudo update-ca-certificates
   

Se você não conseguir verificar se instalou o mecanismo do AKS em sua VM cliente, consulte Solucionar problemas de instalação do mecanismo do AKS

Instalação do ASDK

Você precisará adicionar um certificado ao executar a VM do cliente para o mecanismo AKS no ASDK.

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 repositório de certificados confiável do computador. Você pode encontrar o certificado raiz do ASDK em qualquer VM implantada no ASDK. Por exemplo, em uma VM do Ubuntu, você a encontrará neste diretório /var/lib/waagent/Certificates.pem.

Copie o arquivo de certificado com o seguinte comando:

sudo cp /var/lib/waagent/Certificates.pem /usr/local/share/ca-certificates/azurestackca.crt

sudo update-ca-certificates

Próximas etapas