Instalar o mecanismo do AKS no Linux Azure Stack Hub

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

Preparar a VM 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 em seu Azure Stack Hub. Nesse computador, você executará o mecanismo do AKS para implantar os recursos e o software iaaS 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 o computador cliente, considere:

  1. Se o computador cliente deve ser recuperável em caso de desastre.
  2. Como você se conectará ao computador cliente e como o computador interagirá com o cluster.

Instalar em um ambiente conectado

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

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

  2. Conexão à sua 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 CLI do Azure. Pacotes para CLI do Azure estão disponíveis para a maioria das distribuições. Você pode encontrar instruções em Instalar o CLI do Azure no Linux.

  5. Encontre a versão do mecanismo do AKS no mecanismo do AKS e Azure Stack tabela de mapeamento de versão . A Imagem Base do AKS deve estar disponível em 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 no marketplace.

    Observação

    Você pode encontrar o mapeamento de 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 seguinte comando:

    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
    

    Observação

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

    Observação

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

Instalar em um ambiente desconectado

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

  1. Em um computador com acesso à Internet, acesse GitHub Azure/aks-engine. Baixe um arquivo (*.tar.gz) para um computador Linux, por exemplo, aks-engine-v0.xx.x-linux-amd64.tar.gz. Encontre a versão do mecanismo do AKS na tabela Versões do Kubernetes com suporte.

  2. Crie uma conta de armazenamento em sua 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 Gerenciador de Armazenamento do Azure, consulte Gerenciador de Armazenamento do Azure com Azure Stack Hub.

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

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

  5. Conexão à sua VM.

  6. Execute o seguinte comando:

    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
    

Verificar a instalação

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

  1. Conexão à VM do cliente.

  2. Execute o seguinte comando:

    aks-engine version
    
  3. Se Azure Resource Manager ponto de extremidade estiver usando um certificado auto-assinado, você precisará adicionar explicitamente o certificado raiz ao armazenamento 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, confira Solucionar problemas de instalação do mecanismo do AKS

Instalação do ASDK

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

Quando você estiver usando um ASDK, Azure Resource Manager ponto de extremidade de Azure Resource Manager estiver usando um certificado auto-assinado, precisará adicionar explicitamente esse certificado ao armazenamento 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