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

Este guia de início rápido descreve como configurar um cluster K3S de máquina única e exclusivamente para Linux do Azure Kubernetes Service (AKS) Edge Essentials.

Pré-requisitos

• Consulte os requisitos do sistema. Para este quickstart, certifique-se de que tem pelo menos 4,5 GB de RAM livre, 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. Use a versão cliente mais recente 22H2 (versão OS 19045) ou Server 2022 (OS build 20348). Você pode baixar uma versão do Windows 10 aqui ou do Windows 11 aqui.
• Consulte os Termos de Licença para Software Microsoft à medida que se aplicam à sua utilização do software. Ao usar o script AksEdgeQuickStart, aceita os Termos de Licença de Software da Microsoft, e o indicador AcceptEULA é definido para true para indicar a aceitação dos termos da licença.
• Obtenha os parâmetros da subscrição Azure: para ligar o seu cluster ao Azure Arc, deve fornecer estes parâmetros. Se você ignorar esses parâmetros, a conexão Arc será ignorada, mas o cluster ainda será implantado:
  • As suas credenciais de login: Necessárias para autenticação interativa no Azure usando Azure CLI. A sua conta deve ter um destes papéis Owner, Contributor, ou Administrator.
  • Sua ID<subscription-id>de Assinatura: no portal do Azure, selecione a assinatura que você está usando e procure a ID da assinatura (GUID).
  • O seu ID <tenant-id>: No portal Azure, procure por Microsoft Entra ID, que o leva à página do Diretório Padrão. Procure o ID do locatário (GUID).
  • O Local (região do Azure):<location>onde você deseja que seus recursos sejam criados. Consulte Azure Arc por Região para obter os locais suportados pelos serviços Azure Arc enabled servers e Azure Arc enabled Kubernetes. Escolha uma região na qual ambos sejam suportados.

Etapa 1: Baixe o script para facilitar a implantação

Transfira o AksEdgeQuickStart.ps1 script para uma pasta de trabalho. Dependendo da política configurada na sua máquina, pode ser necessário desbloquear o ficheiro antes de o 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 as seguintes etapas:

• Na pasta de trabalho, o script baixa o arquivo GitHub do Azure/AKS-Edge e descompacta para uma pasta AKS-Edge-main (ou AKS-Edge-tag<>). Por padrão, este passo descarrega o ramo principal atual.
• Utiliza o script AksEdgeAzureSetup para pedir ao utilizador que inicie sessão no portal Azure com as suas credenciais Azure e realiza as seguintes tarefas:
  • Instala o Azure CLI.
  • Cria um grupo de recursos aksedge-rp.
  • Cria um principal de serviço aksedge-sp com a função de Colaborador restrita ao escopo do grupo de recursos aksedge-rp. Se a entidade de serviço já existir, ela redefine a sua senha. Este principal de serviço é utilizado para se conectar ao Azure Arc.
  • Registra os provedores 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:
  • Baixa e instala o AKS Edge Essentials através do MSI.
  • Instala os recursos necessários do sistema operacional host (Install-AksEdgeHostFeatures). A máquina pode reinicializar quando o Hyper-V está habilitado e você deve reiniciar o script novamente.
  • Implanta um cluster de máquina única com switch interno (somente 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 de Máquina Conectada do Azure e conecta a máquina host ao Arc for Servers.
  • Conecta o cluster implantado ao Arc para Kubernetes conectados.

Etapa 2: Implantar o AKS Edge Essentials

Em um prompt do PowerShell com privilégios elevados, execute o AksEdgeQuickStart.ps1 script. Este script inicia um cluster K3s:

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

Para instalar a versão Kubernetes, especifique a -UseK8s bandeira:

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

O script instala o AKS Edge Essentials e conecta seu cluster ao Azure usando o Azure Arc.

Etapa 3: Verificar a implantação

1. Confirme se a implantação foi bem-sucedida executando:

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

   A imagem a seguir mostra pods em um cluster K3S:

   

2. Você pode exibir seu cluster no portal do Azure se navegar até seu grupo de recursos:

   

3. No painel esquerdo, selecione Namespaces em Recursos do Kubernetes (visualização):

   

4. Para visualizar seus recursos do Kubernetes, você precisa de um token de portador:

   

5. Corra Get-AksEdgeManagedServiceToken para recuperar o seu token de serviço:

   

6. Agora você pode exibir recursos em seu cluster. Os Workloads mostram os pods em execução no seu cluster.

   kubectl get pods --all-namespaces
   

   

Agora você tem um cluster AKS Edge Essentials K3S conectado ao Arc com um nó Linux. Você pode explorar a implantação de um aplicativo Linux de exemplo neste cluster.

Próximos passos

• Entenda as opções de implantação.
• Implante um aplicativo Linux.
• Adicione um nó Windows.
• Descrição geral
• Desinstalar cluster AKS