Déployer un modèle de déploiement Azure Stack HCI version 23H2 via Azure Resource Manager modèle de déploiement

Article
05/10/2024

S’applique à : Azure Stack HCI, version 23H2

Cet article explique comment utiliser un modèle Azure Resource Manager dans le Portail Azure pour déployer une instance Azure Stack HCI dans votre environnement. L’article contient également les conditions préalables et les étapes de préparation requises pour commencer le déploiement.

Important

Azure Resource Manager déploiement de modèles de systèmes Azure Stack HCI version 23H2 est destiné aux déploiements à grande échelle. Le public prévu pour ce déploiement est les administrateurs informatiques qui ont de l’expérience de déploiement de clusters Azure Stack HCI. Nous vous recommandons de déployer d’abord un système version 23H2 via le Portail Azure, puis d’effectuer les déploiements suivants via le modèle Resource Manager.

Prérequis

Achèvement de l’inscription de vos serveurs auprès d’Azure Arc et de l’attribution d’autorisations de déploiement. Assurez-vous que :
- Toutes les extensions obligatoires sont correctement installées. Les extensions obligatoires incluent : Azure Edge Lifecycle Manager, Azure Edge Gestion des appareils, Télémétrie et diagnostics et Support à distance Azure Edge.
- Tous les serveurs exécutent la même version du système d’exploitation.
- Tous les serveurs ont la même configuration de carte réseau.

Étape 1 : Préparer les ressources Azure

Procédez comme suit pour préparer les ressources Azure dont vous avez besoin pour le déploiement :

Create un principal de service et une clé secrète client

Pour authentifier votre cluster, vous devez créer un principal de service et une clé secrète client correspondante pour Arc Resource Bridge (ARB).

Create un principal de service pour ARB

Suivez les étapes décrites dans Create une application Microsoft Entra et un principal de service qui peuvent accéder aux ressources via Portail Azure pour créer le principal de service et attribuer les rôles. Vous pouvez également utiliser la procédure PowerShell pour Create un principal de service Azure avec Azure PowerShell.

Les étapes sont également résumées ici :

Connectez-vous au centre d’administration Microsoft Entra en tant qu’administrateur d’application cloud. Accédez à Applications > d’identité > inscriptions d'applications sélectionnez Nouvelle inscription.
Fournissez un nom pour l’application, sélectionnez un type de compte pris en charge, puis sélectionnez Inscrire.
Une fois le principal de service créé, accédez à la page Applications d’entreprise . Recherche pour le SPN que vous avez créé, puis sélectionnez-le.
Sous propriétés, copiez l’ID d’application (client) et l’ID d’objet de ce principal de service.

Vous utilisez l’ID d’application (client) par rapport au arbDeploymentAppID paramètre et l’ID d’objet par rapport au arbDeploymentSPNObjectID paramètre dans le modèle Resource Manager.

Create une clé secrète client pour le principal de service ARB

Accédez à l’inscription d’application que vous avez créée et accédez à Certificats & secrets > secrets client.
Sélectionnez + Nouvelle clé secrète client.
Ajoutez une description pour la clé secrète client et indiquez un délai d’expiration. Sélectionnez Ajouter.
Copiez la valeur de la clé secrète client telle que vous l’utiliserez ultérieurement.

Notes

Pour l’ID client de l’application, vous aurez besoin de sa valeur secrète. Les valeurs de clé secrète client ne peuvent pas être consultées, sauf immédiatement après leur création. Veillez à enregistrer cette valeur lors de sa création avant de quitter la page.

Vous utilisez la valeur de clé secrète client par rapport au arbDeploymentAppSecret paramètre dans le modèle Resource Manager.

Obtenir l’ID d’objet pour le fournisseur de ressources Azure Stack HCI

Cet ID d’objet pour azure Stack HCI RP est unique par locataire Azure.

Dans le Portail Azure, recherchez et accédez à Microsoft Entra ID.
Accédez à l’onglet Vue d’ensemble et recherchez Fournisseur de ressources Microsoft.AzureStackHCI.

Sélectionnez le SPN répertorié et copiez l’ID d’objet.

Vous pouvez également utiliser PowerShell pour obtenir l’ID d’objet du principal de service RP Azure Stack HCI. Exécutez la commande suivante dans PowerShell :

Get-AzADServicePrincipal -DisplayName "Microsoft.AzureStackHCI Resource Provider"

Vous utilisez l’ID d’objet par rapport au hciResourceProviderObjectID paramètre dans le modèle Resource Manager.

Étape 2 : Déployer à l’aide d’azure Resource Manager modèle

Un modèle Resource Manager crée et affecte toutes les autorisations de ressources requises pour le déploiement.

Une fois toutes les étapes de configuration requise et de préparation terminées, vous êtes prêt à déployer à l’aide d’un modèle de déploiement Resource Manager valide et testé et d’un fichier JSON de paramètres correspondants. Utilisez les paramètres contenus dans le fichier JSON pour remplir toutes les valeurs, y compris les valeurs générées précédemment.

Important

Dans cette version, assurez-vous que tous les paramètres contenus dans la valeur JSON sont renseignés, y compris ceux qui ont une valeur Null. S’il existe des valeurs Null, celles-ci doivent être renseignées ou la validation échoue.

Dans le Portail Azure, accédez à Accueil, puis sélectionnez + Create une ressource.
Sélectionnez Create sous Déploiement de modèle (déployer à l’aide de modèles personnalisés).
En bas de la page, recherchez La section Démarrer avec un modèle de démarrage rapide ou une section spec de modèle . Sélectionnez l’option Modèle de démarrage rapide .
Utilisez le champ Modèle de démarrage rapide (exclusion de responsabilité) pour filtrer le modèle approprié. Tapez azurestackhci/create-cluster pour le filtre.
Lorsque vous avez terminé, sélectionnez modèle.
Sous l’onglet Informations de base , vous voyez la page Déploiement personnalisé . Vous pouvez sélectionner les différents paramètres dans la liste déroulante ou sélectionner Modifier les paramètres.
Modifiez des paramètres tels que l’intention réseau ou l’intention réseau de stockage. Une fois les paramètres renseignés, enregistrez le fichier de paramètres.

Conseil

Téléchargez un exemple de fichier de paramètres pour comprendre le format dans lequel vous devez fournir les entrées.
Sélectionnez le groupe de ressources approprié pour votre environnement.
Faites défiler vers le bas et vérifiez que Mode de déploiement = Valider.
Sélectionnez Revoir + créer.
Sous l’onglet Vérifier + créer, sélectionnez Créer. Cela crée les ressources requises restantes et valide le déploiement. La validation prend environ 10 minutes.
Une fois la validation terminée, sélectionnez Redéployer.
Dans l’écran Déploiement personnalisé , sélectionnez Modifier les paramètres. Chargez les paramètres précédemment enregistrés, puis sélectionnez Enregistrer.
En bas de l’espace de travail, remplacez la valeur finale dans le JSON de Valider par Déployer, où Mode de déploiement = Déployer.
Vérifiez que tous les champs du modèle de déploiement Resource Manager sont renseignés par le JSON Paramètres.
Sélectionnez le groupe de ressources approprié pour votre environnement.
Faites défiler vers le bas et vérifiez que Mode de déploiement = Déployer.
Sélectionnez Revoir + créer.
Sélectionnez Create (Créer). Cela commence le déploiement, à l’aide des ressources prérequises existantes qui ont été créées lors de l’étape Valider .

L’écran Déploiement effectue des cycles sur la ressource de cluster pendant le déploiement.

Une fois le déploiement lancé, il y a une exécution limitée du vérificateur d’environnement, une exécution complète du vérificateur d’environnement et le déploiement cloud démarre. Après quelques minutes, vous pouvez surveiller le déploiement dans le portail.
Dans une nouvelle fenêtre de navigateur, accédez au groupe de ressources de votre environnement. Sélectionnez la ressource de cluster.
Sélectionnez Déploiements.
Actualisez et watch la progression du déploiement à partir du premier serveur (également appelé serveur initial et est le premier serveur sur lequel vous avez déployé le cluster). Le déploiement prend entre 2,5 et 3 heures. Plusieurs étapes prennent 40 à 50 minutes ou plus.
L’étape du déploiement qui prend le plus de temps est Déployer Moc et ARB Stack. Cette étape prend 40 à 45 minutes.

Une fois l’opération terminée, la tâche située en haut se met à jour avec status et l’heure de fin.

Vous pouvez également case activée ce modèle de source communautaire pour déployer un cluster Azure Stack HCI version 23H2 à l’aide de Bicep.

Résoudre les problèmes de déploiement

Si le déploiement échoue, vous devez voir un message d’erreur sur la page des déploiements.

Dans Détails du déploiement, sélectionnez les détails de l’erreur.
Copiez le message d’erreur à partir du panneau Erreurs . Vous pouvez fournir ce message d’erreur au support Microsoft pour obtenir une assistance supplémentaire.

Problèmes connus pour le déploiement de modèles ARM

Cette section contient des problèmes connus et des solutions de contournement pour le déploiement de modèles ARM.

Problème	Solution de contournement/Commentaires
Dans cette version, vous pouvez voir une erreur d’attribution de rôle déjà existante . Cette erreur se produit si le déploiement du cluster Azure Stack HCI a d’abord été tenté à partir du portail et si le même groupe de ressources a été utilisé pour le déploiement de modèle ARM.	Bien que ces erreurs puissent être ignorées et que le déploiement puisse se poursuivre via le modèle ARM, nous vous recommandons vivement de ne pas échanger les modes de déploiement entre le portail et le modèle ARM.
Dans cette version, vous pouvez rencontrer un problème de synchronisation de licence lors de l’utilisation du déploiement de modèle ARM.	Une fois que le cluster a terminé la phase de validation, nous vous recommandons de ne pas lancer un autre déploiement de modèle ARM en mode « Valider » si votre cluster est en état d’échec de déploiement . Le démarrage d’un autre déploiement réinitialise les propriétés du cluster, ce qui peut entraîner des problèmes de synchronisation des licences.

Partage via