Préparer votre cluster Kubernetes avec Azure Arc
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 CNCF produits 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 :
- Matériel qui répond à la configuration système requise.
Un abonnement Azure. Si vous n’avez pas d’abonnement Azure, créez-en un gratuitement avant de commencer.
Azure CLI version 2.46.0 ou ultérieure installée sur votre ordinateur de développement. Utilisez
az --version
pour vérifier votre version etaz upgrade
pour effectuer une mise à jour si nécessaire. Si vous souhaitez en savoir plus, veuillez consulter la rubrique Installation de l’interface de ligne de commande Azure.Extension Opérations Azure IoT pour Azure CLI. Utilisez la commande suivante pour ajouter l’extension ou la mettre à jour vers la dernière version :
az extension add --upgrade --name azure-iot-ops
Matériel qui répond à la configuration requise :
- Assurez-vous que votre ordinateur dispose d’au moins 10 Go de RAM, de 4 processeurs virtuels et de 40 Go d’espace disque libre.
- Passez en revue la configuration requise et la matrice de prise en charge d’AKS Edge Essentials.
- Passez en revue l’aide sur la mise en réseau AKS Edge Essentials.
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.
Téléchargez la version du programme d’installation d’AKS Edge Essentials validée sur votre ordinateur local.
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.
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
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.
Commentaires
https://aka.ms/ContentUserFeedback.
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir:Soumettre et afficher des commentaires pour