Instalar o motor do AKS no Linux no Azure Stack Hub

Artigo
12/01/2023

Pode utilizar um computador Linux no Azure Stack Hub para alojar o motor do AKS para implementar e gerir um cluster do Kubernetes. Neste artigo, vamos analisar a preparação da VM cliente para gerir o cluster para instâncias ligadas e desligadas do Azure Stack Hub, verificar a instalação e configurar a VM cliente no ASDK.

Preparar a VM do 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, vai utilizar 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 executar 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 o computador irá interagir com o cluster.

Instalar num ambiente ligado

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

Crie uma VM do Linux no Azure Stack Hub. Para obter instruções, veja Início Rápido: Criar uma VM do servidor Linux com o portal do Azure Stack Hub.
Ligue-se à VM.
Utilize o gestor de pacotes para verificar se tem as seguintes ferramentas instaladas:
- jq um processador JSON.
- curl - uma ferramenta para transferir ficheiros com vários protocolos de rede.
- openssh um cliente ssh.
- tar uma ferramenta utilizada para trabalhar com arquivos TAR.
Instale a CLI do Azure. Os pacotes da CLI do Azure estão disponíveis para a maioria das distribuições. Pode encontrar instruções em Instalar a CLI do Azure no Linux.
Localize a versão do motor AKS no motor do AKS e na tabela de tabela de mapeamento de versões do Azure Stack . A Imagem 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 irá instalar a versão mais recente, que poderá necessitar de uma imagem VHD que não esteja disponível no seu 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 do AKS.

Execute o seguinte comando:

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

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 Motor AKS:

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

Nota

Se o método de instalação falhar, experimente os passos no ambiente desligado.

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

Para as versões 0.73.0 e abaixo do Motor AKS, aceda a GitHub Azure/aks-engine. Transfira um arquivo (*.tar.gz) para um computador Linux, por exemplo, aks-engine-v0.xx.x-linux-amd64.tar.gz.

Para as versões 0.75.3 e superior do Motor AKS, aceda a GitHub Azure/aks-engine-azurestack. Transfira um arquivo (*.tar.gz) para um computador Linux, por exemplo,aks-engine-azurestack-v0.xx.x-linux-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 Linux no Azure Stack Hub. Para obter instruções, veja Início Rápido: Criar uma VM do servidor Linux com o portal do Azure Stack Hub.
A partir do 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 o diretório /usr/local/bin.
Ligue-se à VM.

Execute o seguinte comando:

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

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 Motor AKS:

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

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

Ligue-se à VM do 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 o ponto final Resource Manager do Azure estiver a utilizar um certificado autoassinado, terá de adicionar explicitamente o certificado de raiz ao arquivo de certificados fidedigno do computador. Pode encontrar o certificado de raiz na VM neste diretório: /var/lib/waagent/Certificates.pem. Copie o ficheiro 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 do AKS na VM cliente, veja Resolver problemas de instalação do motor do AKS

Instalação do ASDK

Terá de adicionar um certificado ao executar a VM cliente do motor do AKS no ASDK.

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. Por exemplo, numa VM do Ubuntu, irá encontrá-la neste diretório /var/lib/waagent/Certificates.pem.

Copie o ficheiro de certificado com o seguinte comando:

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

sudo update-ca-certificates

Passos seguintes

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