Partager via

Préparer votre cluster Kubernetes avec Azure Arc

  • Article

Important

Opérations Azure IoT (préversion) – activé parc Azure Arc est actuellement en PRÉVERSION. Vous ne devez pas utiliser ce logiciel en préversion dans des environnements de production.

Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou plus généralement non encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.

Un cluster Kubernetes avec Azure Arc est un prérequis pour le déploiement d’Opérations Azure IoT (préversion). Cet article explique comment préparer un cluster Kubernetes avec Azure Arc avant de déployer des extensions Opérations Azure IoT (préversion) sur un cluster Kubernetes pour exécuter vos propres charges de travail. Cet article contient des conseils pour les environnements Ubuntu, Windows et cloud.

Conseil

Si vous voulez déployer Opérations Azure IoT et exécuter un exemple de charge de travail, consultez le Guide de démarrage rapide : Déployer Opérations Azure IoT (préversion) sur un cluster Kubernetes avec Arc.

Opérations Azure IoT est fourni en tant qu’ensemble de services Kubernetes compatibles avec Azure Arc et est destiné à être utilisé avec CNCFproduits partenaires conformes Arc validés. Actuellement, Microsoft a validé Opérations Azure IoT par rapport à l’ensemble fixe suivant d’infrastructures et d’environnements :

Environnement Version
AKS-EE sur Windows 11 IoT Entreprise
sur un AMD Ryzen-7 à nœud unique (8 cœurs, 3,3 GHz), 16 Go de RAM		 AksEdge-K3s-1.26.10-1.6.384.0
K3s sur Ubuntu 22.04.2
sur un AMD Ryzen-7 à nœud unique (8 cœurs, 3,3 GHz), 16 Go de RAM		 K3s version 1.28.5

Important

Les environnements répertoriés précédemment sont des environnements de type production que Microsoft a validés. Ce ne sont pas les seuls environnements sur lesquels Opérations Azure IoT peut s’exécuter. Opérations Azure IoT peut s’exécuter sur n’importe quel cluster Kubernetes avec Arc qui répond à la configuration système requise pour Kubernetes avec Azure Arc.

Prérequis

Pour préparer votre cluster Kubernetes avec Azure Arc, vous devez disposer des éléments suivants :

Créer un cluster

Cette section fournit des étapes pour préparer et activer des clusters avec Arc dans des environnements validés sur Linux et Windows, ainsi que sur GitHub Codespaces dans le cloud.

Azure Kubernetes Service Edge Essentials est une implémentation Kubernetes locale d’Azure Kubernetes Service (AKS), qui automatise l’exécution d’applications conteneurisées à grande échelle. AKS Edge Essentials inclut une plateforme Kubernetes prise en charge par Microsoft qui inclut une distribution Kubernetes légère avec une petite empreinte et une expérience d’installation simple, ce qui vous permet de déployer facilement Kubernetes sur un matériel de périphérie « léger » ou de classe PC.

Conseil

Vous pouvez utiliser le script AksEdgeQuickStartForAio.ps1 pour automatiser les étapes décrites dans cette section et connecter votre cluster.

Ouvrez une fenêtre PowerShell avec élévation de privilèges, remplacez le répertoire par un dossier de travail, puis exécutez les commandes suivantes :

$url = "https://raw.githubusercontent.com/Azure/AKS-Edge/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStartForAio.ps1"
Invoke-WebRequest -Uri $url -OutFile .\AksEdgeQuickStartForAio.ps1
Unblock-File .\AksEdgeQuickStartForAio.ps1
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
.\AksEdgeQuickStartForAio.ps1 -SubscriptionId "<SUBSCRIPTION_ID>" -TenantId "<TENANT_ID>" -ResourceGroupName "<RESOURCE_GROUP_NAME>"  -Location "<LOCATION>"  -ClusterName "<CLUSTER_NAME>"

Votre ordinateur peut redémarrer dans le cadre de ce processus. Si c’est le cas, réexécutez l’ensemble des commandes.

Préparez votre machine pour AKS Edge Essentials.

  1. Téléchargez la version du programme d’installation d’AKS Edge Essentials validée sur votre ordinateur local.

  2. Suivez les étapes décrites dans Préparer votre machine pour AKS Edge Essentials. Veillez à utiliser le programme d’installation validé que vous avez téléchargé à l’étape précédente et non la version la plus récente.

Configurez un cluster AKS Edge Essentials sur votre ordinateur.

  1. Effectuez les étapes dans Créer un déploiement d’ordinateur unique, mais à la fin de l’Étape 1 : Paramètres de configuration d’ordinateur unique, modifiez les valeurs suivantes dans le fichier aksedge-config.json :

    `Init.ServiceIPRangeSize` = 10
`LinuxNode.DataSizeInGB` = 30
`LinuxNode.MemoryInMB` = 8192

  2. Installez le stockage local-path dans le cluster en exécutant la commande suivante :

    kubectl apply -f https://raw.githubusercontent.com/Azure/AKS-Edge/main/samples/storage/local-path-provisioner/local-path-storage.yaml

Exécutez les commandes suivantes pour vérifier que le déploiement a réussi :

Import-Module AksEdge
Get-AksEdgeDeploymentInfo

Dans la sortie de la commande Get-AksEdgeDeploymentInfo, vous devez voir que l’état Arc du cluster est Connected.

Activer votre cluster avec Arc

Connectez votre cluster à Azure Arc afin qu’il puisse être géré à distance.

Pour connecter votre cluster à Azure Arc, effectuez les étapes décrites dans Connecter votre cluster AKS Edge Essentials à Arc.

Vérifier votre cluster

Pour vérifier que votre cluster est prêt pour le déploiement d’Opérations Azure IoT, vous pouvez utiliser la commande d’assistance verify-host dans l’extension Opérations Azure IoT pour Azure CLI. Lorsqu’elle est exécutée sur l’hôte de cluster, cette commande d’assistance vérifie la connectivité aux points de terminaison Azure Resource Manager et Microsoft Container Registry.

az iot ops verify-host

Pour vérifier que votre cluster Kubernetes est désormais activé pour Azure Arc, exécutez la commande suivante :

kubectl get deployments,pods -n azure-arc

La sortie ressemble à l’exemple suivant :

NAME                                         READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/clusterconnect-agent         1/1     1            1           10m
deployment.apps/extension-manager            1/1     1            1           10m
deployment.apps/clusteridentityoperator      1/1     1            1           10m
deployment.apps/controller-manager           1/1     1            1           10m
deployment.apps/flux-logs-agent              1/1     1            1           10m
deployment.apps/cluster-metadata-operator    1/1     1            1           10m
deployment.apps/extension-events-collector   1/1     1            1           10m
deployment.apps/config-agent                 1/1     1            1           10m
deployment.apps/kube-aad-proxy               1/1     1            1           10m
deployment.apps/resource-sync-agent          1/1     1            1           10m
deployment.apps/metrics-agent                1/1     1            1           10m

NAME                                              READY   STATUS    RESTARTS        AGE
pod/clusterconnect-agent-5948cdfb4c-vzfst         3/3     Running   0               10m
pod/extension-manager-65b8f7f4cb-tp7pp            3/3     Running   0               10m
pod/clusteridentityoperator-6d64fdb886-p5m25      2/2     Running   0               10m
pod/controller-manager-567c9647db-qkprs           2/2     Running   0               10m
pod/flux-logs-agent-7bf6f4bf8c-mr5df              1/1     Running   0               10m
pod/cluster-metadata-operator-7cc4c554d4-nck9z    2/2     Running   0               10m
pod/extension-events-collector-58dfb78cb5-vxbzq   2/2     Running   0               10m
pod/config-agent-7579f558d9-5jnwq                 2/2     Running   0               10m
pod/kube-aad-proxy-56d9f754d8-9gthm               2/2     Running   0               10m
pod/resource-sync-agent-769bb66b79-z9n46          2/2     Running   0               10m
pod/metrics-agent-6588f97dc-455j8                 2/2     Running   0               10m

Créer des sites

Pour gérer les clusters auxquels vos utilisateurs OT ont accès, vous pouvez regrouper vos clusters en sites. Pour en savoir plus, consultez Qu’est-ce que le gestionnaire de site Azure Arc (préversion) ?.

Étapes suivantes

Maintenant que vous disposez d’un cluster Kubernetes avec Azure Arc, vous pouvez déployer Opérations Azure IoT.