Guia de início rápido do AKS Edge Essentials

Este início rápido descreve como configurar um cluster só para Linux do Azure Kubernetes Service (AKS) Edge Essentials.

Pré-requisitos

• Veja os requisitos do sistema. Para este início rápido, certifique-se de que tem um mínimo de 4,5 GB sem RAM, 4 vCPUs e 20 GB de espaço livre em disco.
• Requisitos do SO: instale o Windows 10/11 IoT Enterprise/Enterprise/Pro no seu computador e ative o Windows. Recomendamos que utilize a versão de cliente 22H2 (compilação 19045 do SO) ou o Server 2022 (compilação 20348 do SO). Pode transferir uma versão do Windows 10 aqui ou Windows 11 aqui.
• Veja os Termos de Licenciamento para Software Microsoft à medida que se aplicam à sua utilização do software. Ao utilizar o AksEdgeQuickStart script, aceita os Termos de Licenciamento para Software Microsoft e o AcceptEULA sinalizador está definido para true indicar a aceitação dos termos de licenciamento.
• Obtenha os parâmetros de subscrição do Azure: para ligar o cluster ao Azure Arc, tem de fornecer estes parâmetros. Se ignorar estes parâmetros, a ligação do Arc é ignorada, mas o cluster ainda está implementado.
  • Credenciais de início de sessão: necessário para iniciar sessão interativo no Azure com a CLI do Azure. A sua conta deve ter uma destas funções Owner ou Contributor ou Administrator.
  • ID <subscription-id>da Subscrição: na portal do Azure, selecione a subscrição que está a utilizar e procure o ID da subscrição (GUID).
  • ID <tenant-id>do Inquilino: na portal do Azure, procure Microsoft Entra ID, que deve levá-lo para a página Diretório Predefinido. Procure o ID do inquilino (GUID).
  • A Localização (região do Azure)<location>: onde pretende que os seus recursos sejam criados. Veja Azure Arc por Region para obter as localizações suportadas por Azure Arc enabled servers e Azure Arc enabled Kubernetes os serviços. Escolha uma região na qual ambos são suportados.

Passo 1: transferir o script para uma implementação fácil

Transfira o AksEdgeQuickStart.ps1 script para uma pasta de trabalho. Dependendo da configuração da política no seu computador, poderá ter de desbloquear o ficheiro antes de executar e executar Set-ExecutionPolicy para permitir a execução do script.

Abra uma janela elevada do PowerShell e altere o diretório para uma pasta de trabalho:

$url = "https://raw.githubusercontent.com/Azure/AKS-Edge/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStart.ps1"
Invoke-WebRequest -Uri $url -OutFile .\AksEdgeQuickStart.ps1
Unblock-File .\AksEdgeQuickStart.ps1
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force

Este script automatiza os seguintes passos:

• Na pasta de trabalho, o script transfere o arquivo do GitHub do Azure/AKS-Edge e deszipa para uma pasta AKS-Edge-main (ou AKS-Edge-tag<>). Por predefinição, esta ação transfere o ramo principal atual.
• Utiliza o script AksEdgeAzureSetup para pedir ao utilizador para iniciar sessão no portal do Azure com as respetivas credenciais do Azure e executa as seguintes tarefas:
  • Instala a CLI do Azure.
  • Cria um grupo de recursos aksedge-rp.
  • Cria um principal de serviço aksedge-sp com a função Contribuidor restrita ao âmbito do grupo de recursos aksedge-rp . Se o principal de serviço já existir, repõe a palavra-passe. Este principal de serviço é utilizado para ligar ao Azure Arc.
  • Regista os fornecedores de recursos Microsoft.HybridCompute, Microsoft.GuestConfiguration, Microsoft.HybridConnectivity, Microsoft.Kubernetes, Microsoft.KubernetesConfiguration e Microsoft.ExtendedLocation.
• Invoca a Start-AideWorkflow função que executa as seguintes tarefas:
  • Transfere e instala o MSI do AKS Edge Essentials.
  • Instala as funcionalidades necessárias do SO anfitrião (Install-AksEdgeHostFeatures). O computador pode reiniciar quando o Hyper-V está ativado e tem de reiniciar o script novamente.
  • Implementa um cluster de máquina única com comutador interno (apenas nó Linux).
• Invoca a Connect-AideArc função se os parâmetros do Azure forem fornecidos. Esta função executa as seguintes tarefas:
  • Instala o Agente do Computador Ligado do Azure e liga o computador anfitrião ao Arc para Servidores.
  • Liga o cluster implementado ao Arc para Kubernetes ligado.

Passo 2: Implementar o AKS Edge Essentials

Numa linha de comandos elevada do PowerShell, execute o AksEdgeQuickStart.ps1 script. Isto apresenta um cluster K3s:

.\AksEdgeQuickStart.ps1 -SubscriptionId "<subscription-id>" -TenantId "<tenant-id>" -Location "<location>"

Para instalar a versão K8s, especifique o -UseK8s sinalizador:

.\AksEdgeQuickStart.ps1 -SubscriptionId "<subscription-id>" -TenantId "<tenant-id>" -Location "<location>" -UseK8s

O script instala o AKS Edge Essentials e liga o cluster ao Azure com o Azure Arc.

Dica

Se o Hyper-V não tiver sido ativado no computador, o script de início rápido ativa o Hyper-V e reinicia o computador. Execute o AksEdgeQuickStart script novamente após o reinício.

Passo 3: Verificar a implementação

1. Confirme que a implementação foi efetuada com êxito ao executar:

   kubectl get nodes -o wide
   kubectl get pods -A -o wide
   

   A imagem seguinte mostra pods num cluster K3S:

   

2. Pode ver o cluster no portal do Azure se navegar para o grupo de recursos:

   

3. No painel esquerdo, selecione os Espaços de Nomes em Recursos do Kubernetes (pré-visualização):

   

4. Para ver os recursos do Kubernetes, precisa de um token de portador:

   

5. Pode executar Get-AksEdgeManagedServiceToken para obter o token de serviço:

   

6. Agora pode ver recursos no cluster. As Cargas de Trabalho mostram os pods em execução no cluster.

   kubectl get pods --all-namespaces
   

   

Tem agora um cluster K3S do AKS Edge Essentials ligado ao Arc com um nó Linux. Pode explorar a implementação de uma aplicação Linux de exemplo neste cluster.

Dica

Se não forneceu os detalhes da sua subscrição do Azure durante a execução do AksEdgeQuickStart.ps1 script, ainda pode ligar ao Azure Arc ao seguir os passos neste artigo.

Passos seguintes

• Compreender as opções de implementação.
• Implementar uma aplicação Linux.
• Adicione um nó do Windows.
• Descrição geral
• Desinstalar o cluster do AKS