Compartilhar via

Preparar seus computadores para o AKS Edge Essentials

  • Artigo

Este artigo descreve como configurar um computador de nó do Edge Essentials do AKS (Serviço de Kubernetes do Azure).

Pré-requisitos

Observação

Se você estiver fazendo uma instalação offline ou se seu computador estiver em execução 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 o AKS Edge Essentials

Você pode implantar um cluster do AKS Edge Essentials em um único computador ou em vários computadores. 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 nos computadores primário e secundário da seguinte maneira. Depois que o AKS Edge Essentials for instalado, ao criar o cluster do Kubernetes, você identificará um computador como o primário e o restante como o secundário.

  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 de nó do Windows.

    Arquivo Link
    Instalador do K8s (1.29.4) aka.ms/aks-edge/k8s-msi
    Instalador do K3s (1.29.6) aka.ms/aks-edge/k3s-msi
    Instalador do K8s (1.28.9) aka.ms/aks-edge/k8s-msi-1.28
    Instalador do K3s (1.28.5) aka.ms/aks-edge/k3s-msi-1.28
    Instalador do K8s (1.27.6) aka.ms/aks-edge/k8s-msi-1.27
    Instalador do 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 GitHub do AKS Edge. Navegue até a guia Código e clique no botão Baixar Zip para baixar o repositório como um arquivo .zip . Extraia o arquivo .zip GitHub para uma pasta local.

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

Nesta versão, há suporte para K8s e K3s. Fornecemos dois instaladores MSI separados para cada distribuição do Kubernetes. Não instale K8s e K3s ao mesmo tempo. Se você quiser instalar uma distribuição diferente do Kubernetes, desinstale a existente primeiro e depois reinicie.

Importante

Depois que uma versão do Kubernetes não tiver mais suporte, os downloads das versões associadas do AKS Edge Essentials estarão sujeitos à descontinuação.

Observação

Você deve extrair os arquivos de 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 examinar a matriz de suporte de recursos para entender as diferentes opções disponíveis.

Instalar o AKS Edge Essentials

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

  2. Emita 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 das 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, verifique se você tem o instalador MSI com a distribuição do Kubernetes de sua 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

    OR

    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 do PowerShell com privilégios elevados e continue com a próxima etapa.

Verificar os módulos do AKS Edge Essentials

Depois que a instalação for concluída, verifique se ela foi bem-sucedida executando o seguinte comando em um PowerShell com privilégios elevados:

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

Esse comando exibe uma saída semelhante à seguinte lista:

Captura de tela dos módulos do PowerShell instalados.

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

Verifique as configurações do dispositivo

Você pode executar o Install-AksEdgeHostFeatures comando para validar as configurações do Hyper-V, SSH e Power no computador. Isso pode exigir uma reinicialização do sistema:

Install-AksEdgeHostFeatures

Esse comando exibe uma saída semelhante à seguinte lista:

Captura de tela mostrando as verificações feitas.

Próximas etapas