Configurar os pré-requisitos do motor do AKS no Azure Stack Hub

Pode instalar o motor do AKS numa máquina virtual (VMs) no seu ambiente ou em qualquer máquina cliente com acesso ao ponto final Resource Manager Azure Stack Hub. Tenha os seguintes itens antes de executar o motor: um servidor Ubuntu Base do AKS e uma extensão de script personalizado do Linux disponíveis na sua subscrição, uma identidade do principal de serviço que foi atribuída a uma função de contribuidor e um par de chaves privada/pública para acesso SSH ao seu servidor Ubuntu. Além disso, se estiver a utilizar o Development Kit do Azure Stack, tem de fazer com que o computador confie nos certificados adequados.

Se tiver os pré-requisitos, pode começar a definir o cluster.

Se for o operador de cloud do Azure Stack Hub e quiser oferecer um motor AKS, siga as instruções em Adicionar motor AKS ao Marketplace do Azure Stack Hub.

Pré-requisitos para o motor AKS

Para utilizar o motor do AKS, tem de ter os seguintes recursos disponíveis. Tenha em atenção que o motor do AKS deve ser utilizado pelos inquilinos do Azure Stack Hub para implementar clusters do Kubernetes na respetiva subscrição de inquilino. A única parte em que o envolvimento do operador do Azure Stack Hub pode ser necessário é a transferência de itens do Marketplace e a criação de uma identidade do principal de serviço. Pode encontrar detalhes na tabela seguinte.

O operador da cloud terá de ter os seguintes itens implementados.

Pré-requisito	Descrição	Obrigatório	Instruções
Azure Stack Hub 1910 ou superior	O motor AKS requer o Azure Stack Hub 1910 ou superior.	Necessário	Se não tiver a certeza da sua versão do Azure Stack Hub, contacte o operador da cloud.
Extensão de script personalizado do Linux	Extensão de Script Personalizado do Linux 2.0 Oferta: Script Personalizado para Linux 2.0 Versão: 2.0.6 (ou versão mais recente) Publicador: Microsoft Corp	Necessário	Se não tiver este item na sua subscrição, contacte o operador da cloud.
Imagens base do AKS	Imagem do Windows e Ubuntu Base do AKS Veja mais informações sobre a dependência da versão. Veja Matching engine to base image version (Motor correspondente à versão de imagem de base)	Necessário	Se não tiver este item na sua subscrição, contacte o operador da cloud. Se for o operador da cloud do Azure Stack Hub e quiser oferecer um motor AKS, siga as instruções em Adicionar motor AKS ao Marketplace do Azure Stack Hub.
Identidade do principal de serviço (SPN)	Uma aplicação que precisa de implementar ou configurar recursos através do Azure Resource Manager, tem de ser representada por um principal de serviço.	Necessário	Poderá ter de contactar o operador de cloud do Azure Stack Hub para obter um SPN e um segredo atual. Se for utilizada uma identidade do principal de serviço Microsoft Entra, o acesso à Internet é necessário a partir das VMs no cluster do Kubernetes para que o principal de serviço possa autenticar com Microsoft Entra ID. Também precisa de um segredo ativo. Quando o segredo expirar, o cluster não estará funcional. Se o seu ambiente não tiver acesso à Internet, o cluster do Kubernetes não estará funcional. Para obter instruções, veja Utilizar uma identidade de aplicação para aceder aos recursos
(SPN) função contribuidor atribuída	Para permitir que uma aplicação aceda a recursos na sua subscrição com o respetivo principal de serviço, tem de atribuir o principal de serviço a uma função para um recurso específico.	Necessário	Para obter instruções, veja Atribuir uma função

Pode definir os seguintes itens.

Pré-requisito	Descrição	Obrigatório	Instruções
Subscrição do Azure Stack Hub	Pode aceder a ofertas no Azure Stack Hub através de subscrições. A oferta contém os serviços que estão disponíveis para si.	Necessário	Para poder implementar cargas de trabalho de inquilinos no Azure Stack Hub, primeiro tem de obter uma Subscrição do Azure Stack Hub.
Grupo de recursos	Um grupo de recursos é um contentor que detém recursos relacionados para uma solução do Azure. Se não especificar um grupo de recursos existente, a ferramenta irá criar um para si.	Opcional	Gerir grupos de recursos do Azure Resource Manager com o portal do Azure
Chave pública privada	Para utilizar uma ligação SSH aberta do computador de desenvolvimento para a VM do servidor na instância do Azure Stack Hub que aloja a sua aplicação Web, tem de criar um par de chaves públicas e privadas secure Shell (SSH).	Necessário	Para obter instruções sobre como gerar uma chave, veja Geração de Chaves SSH.

Nota

Também pode criar os pré-requisitos para o motor do AKS com a CLI do Azure para o Azure Stack Hub ou o PowerShell do Azure Stack Hub.

Motor correspondente à versão de imagem de base

O motor do AKS implementa um SO personalizado do Ubuntu Server em cada imagem de nó de cluster, no Ubuntu Base do AKS e na Distribuição de Imagens do Windows. Qualquer versão do motor do AKS depende de uma versão de imagem específica disponibilizada no Azure Stack Hub pelo operador do Azure Stack Hub. Pode encontrar uma tabela com as versões do motor AKS e as versões do Kubernetes suportadas correspondentes em Versões do Kubernetes Suportadas. Por exemplo, a versão v0.55.0 do motor do AKS depende da versão 2020.08.24 do Ubuntu Base do AKS e da Distribuição de Imagens do Windows. Peça ao operador do Azure Stack Hub para transferir a versão de imagem específica do Azure Marketplace para o Marketplace do Azure Stack Hub.

Irá acionar um erro se a imagem não estiver disponível no Marketplace do Azure Stack Hub. Por exemplo, se estiver atualmente a utilizar a versão v0.55.0 do motor AKS e o Ubuntu Base do AKS e a versão da Distribuição 2020.08.24 de Imagens do Windows não estiver disponível, verá o seguinte erro ao executar o motor AKS:

The platform image 'microsoft-aks:aks:aks-ubuntu-1604-202003:2020.08.24' is not available. 
Verify that all fields in the storage profile are correct.

Pode verificar a versão atual do motor do AKS ao executar 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
Version: v0.55.0
GitCommit: 44a35c00c
GitTreeState: clean

Passos seguintes

Implementar o motor do AKS no Windows no Azure Stack Hub
Implementar o motor do AKS no Linux no Azure Stack Hub