Partager via

Préparer vos machines pour AKS Edge Essentials

  • Article

Cet article explique comment configurer une machine de nœud Azure Kubernetes Service (AKS) Edge Essentials.

Prérequis

Remarque

Si vous effectuez une installation hors connexion ou que votre ordinateur s’exécute sur un environnement d’entreprise avec des stratégies de sécurité en place qui peuvent limiter la connexion Internet, veillez à vérifier l’installation hors connexion AKS Edge Essentials.

Télécharger AKS Edge Essentials

Vous pouvez déployer un cluster AKS Edge Essentials sur une seule machine ou sur plusieurs ordinateurs. Dans un déploiement à plusieurs machines, l’une des machines est la machine principale avec un nœud de contrôle Kubernetes, et les autres machines sont des machines secondaires qui sont des nœuds de contrôle ou des nœuds Worker. Vous devez installer AKS Edge Essentials sur les machines primaires et secondaires comme suit. Une fois AKS Edge Essentials installé, lorsque vous créez votre cluster Kubernetes, vous identifiez un ordinateur comme principal et le reste en tant que machines secondaires.

  1. Sur votre ordinateur, téléchargez le fichier AksEdge-k3s.msi ou AksEdge-k8s.msi , selon la distribution Kubernetes que vous souhaitez utiliser. En outre, si vous créez un nœud Worker Windows, vous avez besoin des fichiers de nœud Windows.

    File Lien
    Programme d’installation de K8s (1.28.3) aka.ms/aks-edge/k8s-msi
    Programme d’installation de K3s (1.28.3) aka.ms/aks-edge/k3s-msi
    Programme d’installation de K8s (1.27.6) aka.ms/aks-edge/k8s-msi-1.27
    Programme d’installation de K3s (1.27.6) aka.ms/aks-edge/k3s-msi-1.27
    Programme d’installation de K8s (1.26.6) aka.ms/aks-edge/k8s-msi-1.26
    Programme d’installation de K3s (1.26.10) aka.ms/aks-edge/k3s-msi-1.26
    Fichiers de nœud Windows aka.ms/aks-edge/windows-node-zip

  2. En plus de la MSI, Microsoft fournit des exemples et des outils que vous pouvez télécharger à partir du dépôt GitHub AKS Edge. Accédez à l’onglet Code , puis cliquez sur le bouton Télécharger le fichier Zip pour télécharger le référentiel sous la forme d’un fichier .zip . Extrayez le fichier .zip GitHub dans un dossier local.

  3. Avant d’installer, veillez à désinstaller toutes les installations de préversion privée et à redémarrer votre système avant de continuer.

Dans cette version, les K8 et K3 sont pris en charge. Nous avons fourni deux programmes d’installation MSI distincts pour chaque distribution Kubernetes. N’installez pas les K8 et K3 en même temps. Si vous souhaitez installer une autre distribution Kubernetes, désinstallez d’abord celle existante, puis redémarrez.

Important

Une fois qu’une version de Kubernetes n’est plus prise en charge, les téléchargements pour les versions AKS Edge Essentials associées sont soumis à une interruption.

Remarque

Vous devez extraire les fichiers de nœud Windows de l’archive zip dans le même dossier que les MSIs d’installation si vous souhaitez utiliser la fonctionnalité de nœud Windows. Avant d’installer le MSI, vous pouvez consulter la matrice de prise en charge des fonctionnalités pour comprendre les différentes options disponibles.

Installer AKS Edge Essentials

  1. Ouvrez PowerShell en tant qu’administrateur (powerShell avec élévation de privilèges) et accédez au répertoire de dossiers avec les fichiers du programme d’installation.

  2. Exécutez la commande suivante, puis remplacez kXs-x.x.xxx.x par la distribution/version Kubernetes que vous avez téléchargée et exécutée :

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

    Si vous le souhaitez, vous pouvez spécifier le répertoire d’installation et le répertoire vhdx (répertoire où les fichiers vhdx pour les machines virtuelles sont stockés) à l’aide INSTALLDIR et VHDXDIR. Par défaut, il s’agit des éléments suivants C:\Program Files\AksEdge:

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

    Vous pouvez également double-cliquer sur le fichier AksEdge-k8s-x.x.xxx.x.msi ou AksEdge-k3s-x.x.xxx.x.msi pour installer la dernière version.

  3. Pour inclure des nœuds Windows, vérifiez que vous disposez du programme d’installation MSI avec votre distribution Kubernetes de votre choix et les fichiers AksEdgeWindows-v1 décompressés dans le même dossier. Dans la commande suivante, remplacez kXs-x.x.xxx.x par la distribution/version Kubernetes que vous avez téléchargée et exécutée :

    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

    Vous êtes maintenant prêt à effectuer un déploiement mixte.

  4. Ouvrez une autre fenêtre PowerShell avec élévation de privilèges et passez à l’étape suivante.

Vérifier les modules AKS Edge Essentials

Une fois l’installation terminée, vérifiez qu’elle a réussi en exécutant la commande suivante dans une instance PowerShell avec élévation de privilèges :

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

Cette commande affiche une sortie similaire à la liste suivante :

Capture d’écran des modules PowerShell installés.

Consultez la référence des applets de commande PowerShell AKS Edge Essentials pour obtenir la liste complète des commandes prises en charge.

Vérifier les paramètres de l’appareil

Vous pouvez exécuter la Install-AksEdgeHostFeatures commande pour valider les paramètres Hyper-V, SSH et Power sur l’ordinateur. Cela peut nécessiter un redémarrage du système :

Install-AksEdgeHostFeatures

Cette commande affiche une sortie similaire à la liste suivante :

Capture d’écran montrant les vérifications effectuées.

Étapes suivantes