Partilhar via

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

  • Artigo

Este guia de início rápido descreve como configurar um cluster K3S somente Linux de máquina única do Serviço Kubernetes do Azure (AKS) Edge Essentials.

Nota

O objetivo deste script de início rápido é facilitar o processo de avaliação. Esse script requer credenciais de nível superior para uma configuração única da assinatura do Azure. Este não se destina a utilização em produção.

Pré-requisitos

  • Consulte os requisitos do sistema. Para este início rápido, certifique-se de que tem um mínimo de 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. Recomendamos usar a versão mais recente do cliente 22H2 (compilação do sistema operacional 19045) ou o servidor 2022 (compilação do sistema operacional 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 AksEdgeQuickStart script, você aceita os Termos de Licença para Software Microsoft e o AcceptEULA sinalizador é definido para true indicar a aceitação dos termos de licença.
  • Obtenha seus parâmetros de assinatura do Azure: para conectar seu cluster ao Azure Arc, você deve fornecer esses parâmetros. Se você ignorar esses parâmetros, a conexão Arc será ignorada, mas o cluster ainda será implantado:
    • Suas credenciais de logon: necessárias para o logon interativo no Azure usando a CLI do Azure. Sua conta deve ter uma dessas funções Owner ou Contributor 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).
    • Sua ID <tenant-id>de Locatário : No portal do Azure, procure por ID do Microsoft Entra, que deve levá-lo à página 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 por Azure Arc enabled servers e Azure Arc enabled Kubernetes serviços. 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 configuração da política em sua máquina, talvez seja necessário desbloquear o arquivo 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 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, isso baixa a ramificação principal atual.
  • Usa o script AksEdgeAzureSetup para solicitar que o usuário entre no portal do Azure usando suas credenciais do Azure e executa as seguintes tarefas:
    • Instala a CLI do Azure.
    • Cria um grupo de recursos aksedge-rp.
    • Cria uma entidade 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 sua senha. Essa entidade de serviço é usada 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 MSI do AKS Edge Essentials.
    • 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.

Gorjeta

Você pode modificar o $aksedgeConfig conteúdo json no AksEdgeQuickStart script para quaisquer opções adicionais. Para obter as opções disponíveis, consulte Configuração JSON de implantação.

Etapa 2: Implantar o AKS Edge Essentials

Em um prompt do PowerShell com privilégios elevados, execute o AksEdgeQuickStart.ps1 script. Isso traz 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 conecta seu cluster ao Azure usando o Azure Arc.

Gorjeta

Se o Hyper-V não estiver habilitado em sua máquina, o script de início rápido habilitará o Hyper-V e reiniciará sua máquina. Execute o AksEdgeQuickStart script novamente após a reinicialização.

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:

    Captura de tela mostrando todos os pods em execução.

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

    Captura de ecrã a mostrar o cluster no portal azure

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

    Captura de tela dos recursos do Kubernetes.

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

    Captura de tela mostrando a página necessária do token do portador.

  5. Você pode executar Get-AksEdgeManagedServiceToken para recuperar seu token de serviço:

    Captura de tela mostrando onde colar token no portal.

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

    kubectl get pods --all-namespaces

    Captura de tela mostrando todos os pods no Arc.

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.

Gorjeta

Se você não forneceu os detalhes da assinatura do Azure durante a execução do AksEdgeQuickStart.ps1 script, ainda poderá se conectar ao Azure Arc seguindo as etapas neste artigo.

Próximos passos