Prepare as suas máquinas para o AKS Edge Essentials

  • Artigo

Este artigo descreve como configurar uma máquina de nó do Azure Kubernetes Service (AKS) Edge Essentials.

Pré-requisitos

Nota

Se você estiver fazendo uma instalação off-line ou se sua máquina estiver sendo executada em um ambiente corporativo com políticas de segurança em vigor que podem limitar a conexão com a Internet, verifique a instalação offline do AKS Edge Essentials.

Baixar AKS Edge Essentials

Você pode implantar um cluster do AKS Edge Essentials em uma única máquina ou em várias máquinas. Em uma implantação de várias máquinas, uma das máquinas é a máquina primária com um nó de controle do Kubernetes, e as outras máquinas são máquinas secundárias que são nós de controle ou nós de trabalho. Você deve instalar o AKS Edge Essentials nas máquinas primária e secundária da seguinte maneira. Depois que o AKS Edge Essentials é instalado, quando você cria seu cluster Kubernetes, identifica uma máquina como a principal e o restante como máquinas secundárias.

  1. Em sua máquina, baixe o arquivo AksEdge-k3s.msi ou AksEdge-k8s.msi , dependendo de qual distribuição do Kubernetes você deseja usar. Além disso, se você estiver criando um nó de trabalho do Windows, precisará dos arquivos do nó do Windows.

    Ficheiro Ligação
    Instalador K8s (1.29.4) aka.ms/aks-edge/k8s-msi
    Instalador K3s (1.29.6) aka.ms/aks-edge/k3s-msi
    Instalador K8s (1.28.9) aka.ms/aks-edge/k8s-msi-1.28
    Instalador K3s (1.28.5) aka.ms/aks-edge/k3s-msi-1.28
    Instalador K8s (1.27.6) aka.ms/aks-edge/k8s-msi-1.27
    Instalador K3s (1.27.6) aka.ms/aks-edge/k3s-msi-1.27
    Arquivos de nó do Windows aka.ms/aks-edge/windows-node-zip

  2. Além do MSI, a Microsoft fornece exemplos e ferramentas que você pode baixar do repositório AKS Edge GitHub. Navegue até a guia Código e clique no botão Download Zip para baixar o repositório como um arquivo .zip . Extraia o arquivo .zip do GitHub para uma pasta local.

  3. Antes de instalar, certifique-se de desinstalar todas as instalações de visualização privada e reinicie o sistema antes de prosseguir.

Nesta versão, tanto o K8s como o K3s são suportados. Nós fornecemos dois instaladores MSI separados para cada distribuição do Kubernetes. Não instale o K8s e o K3s ao mesmo tempo. Se você quiser instalar uma distribuição Kubernetes diferente, desinstale a existente primeiro e, em seguida, reinicie.

Importante

Quando uma versão do Kubernetes não é mais suportada, os downloads para versões associadas do AKS Edge Essentials estão sujeitos a descontinuação.

Nota

Você deve extrair os arquivos do nó do Windows do arquivo zip para a mesma pasta que os MSIs do instalador se quiser usar o recurso de nó do Windows. Antes de instalar o MSI, você pode revisar a matriz de suporte ao recurso para entender as diferentes opções disponíveis.

Instalar o AKS Edge Essentials

  1. Abra o PowerShell como administrador (um PowerShell elevado) e navegue até o diretório da pasta com os arquivos do instalador.

  2. Execute o seguinte comando e substitua kXs-x.x.xxx.x pela distribuição/versão do Kubernetes que você baixou e executou:

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi

    Opcionalmente, você pode especificar o diretório de instalação e o diretório vhdx (diretório onde os arquivos vhdx para as máquinas virtuais são armazenados) usando INSTALLDIR e VHDXDIR. Por padrão, eles estão em C:\Program Files\AksEdge:

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi INSTALLDIR=C:\Programs\AksEdge VHDXDIR=C:\vhdx

    Como alternativa, você pode clicar duas vezes no arquivo AksEdge-k8s-x.x.xxx.x.msi ou AksEdge-k3s-x.x.xxx.x.msi para instalar a versão mais recente.

  3. Para incluir nós do Windows, certifique-se de ter o instalador MSI com sua distribuição Kubernetes de escolha e os arquivos AksEdgeWindows-v1 descompactados na mesma pasta. No comando a seguir, substitua kXs-x.x.xxx.x pela distribuição/versão do Kubernetes que você baixou e executou:

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi ADDLOCAL=CoreFeature,WindowsNodeFeature

    OU

    msiexec.exe /i AksEdge-kXs-x.x.xxx.x.msi ADDLOCAL=CoreFeature,WindowsNodeFeature INSTALLDIR=C:\Programs\AksEdge VHDXDIR=C:\vhdx

    Agora você está pronto para fazer a implantação mista.

  4. Abra outra janela elevada do PowerShell e continue com a próxima etapa.

Verifique os módulos do AKS Edge Essentials

Quando a instalação estiver concluída, certifique-se de que foi bem-sucedida executando o seguinte comando em um PowerShell elevado:

Set-ExecutionPolicy RemoteSigned -Scope Process -Force
Import-Module AksEdge
Get-Command -Module AKSEdge | Format-Table Name, Version

Este comando exibe uma saída semelhante à lista a seguir:

Captura de tela dos módulos do PowerShell instalados.

Consulte a referência de cmdlets do AKS Edge Essentials PowerShell para obter uma lista completa dos comandos suportados.

Verificar as configurações do dispositivo

Você pode executar o Install-AksEdgeHostFeatures comando para validar as configurações de Hyper-V, SSH e Energia na máquina. Isso pode exigir uma reinicialização do sistema:

Install-AksEdgeHostFeatures

Este comando exibe uma saída semelhante à lista a seguir:

Captura de tela mostrando as verificações que foram feitas.

Próximos passos