Instalar o motor AKS no Linux no Azure Stack Hub

Artigo
03/22/2025

Você pode usar uma máquina Linux em seu Azure Stack Hub para hospedar o mecanismo AKS para implantar e gerenciar um cluster Kubernetes. Neste artigo, examinamos a preparação da VM cliente para gerenciar seu cluster para instâncias do Azure Stack Hub conectadas e desconectadas, verificamos a instalação e configuramos a VM cliente no ASDK.

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, você usa 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 para o seu cliente, considere:

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

Instalar em um ambiente conectado

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

Crie uma VM Linux no seu Azure Stack Hub. Para obter instruções, consulte Guia de início rápido : criar uma VM de servidor Linux usando o portal do Azure Stack Hub.
Conecte-se à sua VM.
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.
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.
Encontre a versão do mecanismo AKS na tabela de mapeamento de versão do mecanismo AKS e do Azure Stack na tabela . A Imagem Base do AKS 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.

Observação

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.

Execute o seguinte comando:

Para as versões 0.73.0 e inferiores do AKS Engine:

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 as versões 0.75.3 e superiores do AKS Engine:

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 seguir as etapas no ambiente isolado.

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

A partir de uma máquina com acesso à internet:

Para as versões 0.73.0 e inferiores do AKS Engine, vá para GitHub Azure/aks-engine. Faça o download de um arquivo (*.tar.gz) para uma máquina Linux, por exemplo, aks-engine-v0.xx.x-linux-amd64.tar.gz.

Para as versões 0.75.3 e superiores do AKS Engine, vá para GitHub Azure/aks-engine-azurestack. Faça o download de um arquivo (*.tar.gz) para uma máquina Linux, por exemplo,aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz.

Encontre a versão do mecanismo AKS na tabela Versões Suportadas do Kubernetes.
Crie uma conta de armazenamento na sua instância do Azure Stack Hub para transferir o arquivo (*.tar.gz) com o binário do motor 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 Linux no seu Azure Stack Hub. Para obter instruções, consulte Guia de início rápido : criar uma VM de servidor Linux usando o portal do Azure Stack Hub.
Na URL de blob da conta de armazenamento do Azure Stack Hub onde carregou o arquivo de arquivo (*.tar.gz), baixe o ficheiro para a sua máquina virtual de gestão. Extraia o arquivo para o diretório /usr/local/bin.
Conecte-se à sua VM.

Execute o seguinte comando:

Para as versões 0.73.0 e inferiores do AKS Engine:

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 as versões 0.75.3 e superiores do AKS Engine:

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

Verifique a instalação

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

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

Observação

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 o ponto de extremidade do Azure Resource Manager estiver usando um certificado autoassinado, você precisará adicionar explicitamente o certificado raiz ao armazenamento de certificados confiáveis da máquina. 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 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ê precisará adicionar um certificado ao executar a VM 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 armazenamento de certificados confiáveis da máquina. Você pode encontrar o certificado raiz ASDK em qualquer VM implantada no ASDK. Por exemplo, em uma VM do Ubuntu você vai encontrá-lo 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óximos passos

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

Partilhar via