Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à : déploiements hyperconvergés de Azure Local
Cet article décrit les phases de préparation et d’installation du flux de travail de mise à jour Azure Local, notamment la façon dont les mises à jour sont téléchargées, validées, vérifiées et installées. Il explique également comment la progression des mises à jour est signalée à différentes étapes.
Pour plus d’informations sur les rapports d’avancement, consultez Utilisez Gestionnaire de mise à jour Azure pour mettre à jour Azure Local et Update Azure Local via PowerShell.
Aperçu
Les mises à jour "Azure Local" suivent un flux de travail en deux phases :
- Préparation : Téléchargez du contenu, validez et extrayez des packages, puis exécutez des vérifications d’intégrité pour confirmer que le cluster est prêt.
- Installation : appliquez la mise à jour sur le cluster via un plan d’action orchestré.
Chaque étape produit une UpdateRun ressource qui enregistre la progression pas à pas, le minutage et toutes les erreurs rencontrées. Vous pouvez interroger les détails de cette exécution sur la page Update Progress dans Gestionnaire de mise à jour Azure ou à l’aide de l’applet de commande Get-SolutionUpdateRun dans PowerShell.
Phase de préparation
Remplir les conditions préalables
Avant la préparation, la mise à jour peut être dans un
AdditionalContentRequiredétat. Cet état indique que le package de mise à jour nécessite du contenu du fournisseur de matériel. Cette exigence s’applique aux mises à jour de Solution Builder Extension (SBE) et aux mises à jour combinées de Solution et de SBE. Le package SBE installé à partir du fournisseur de matériel ne prend pas en charge le téléchargement automatique de ce contenu.Si la mise à jour est dans l’état
AdditionalContentRequired, vous devez importer le contenu avant de commencer la préparation ou l’installation. Pour plus d’informations, consultez Mettre à jour via PowerShell.Mise à jour du déclencheur (facultatif)
La phase de préparation est déclenchée dans le cadre du démarrage de chaque mise à jour ; Toutefois, vous avez la possibilité d’exécuter indépendamment la préparation sans déclencher également la phase d’installation. Pour plus d’informations, consultez la phase d’installation.
- Pour effectuer uniquement la phase de préparation, démarrez la mise à jour en exécutant
Start-SolutionUpdate -PrepareOnly. Cette étape télécharge et valide le contenu de mise à jour et exécute les vérifications d’intégrité sans démarrer l’installation. Utilisez-le pour pré-étaper des mises à jour ou valider la préparation du cluster avant une fenêtre de maintenance. - Pour effectuer la phase de préparation et la phase d’installation, démarrez la mise à jour en exécutant
Start-SolutionUpdate.
- Pour effectuer uniquement la phase de préparation, démarrez la mise à jour en exécutant
Lancer les phases de préparation
Le flux de travail de préparation passe par les phases suivantes dans l’ordre.
Télécharger
La phase de téléchargement récupère le package de mise à jour à partir de la source de mise à jour configurée.
- Téléchargement standard : Le service de mise à jour télécharge le package de mise à jour de solution principal (bundles NuGet) directement à partir du catalogue de mises à jour.
-
Suivi de la progression : le champ
ProgressPercentagede la propriétéUpdateStatePropertiesassociée à la mise à jour indique la progression du téléchargement sous la forme d’une valeur comprise entre 0 et 100.
Pendant cette phase, l’objet Update passe à l’état Downloading . En cas d’échec, l’état devient DownloadFailed.
Connecteur de téléchargement SBE (le cas échéant)
Toute mise à jour qui inclut une mise à jour SBE nécessite du contenu supplémentaire du fournisseur de matériel. Si le SBE fournit un connecteur de téléchargement, le service de mise à jour l’utilise pour gérer une partie du téléchargement :
- Le service de mise à jour vérifie si le SBE installé prend en charge un connecteur de téléchargement.
- Si cette action est prise en charge, un plan d’action Orchestrator appelle l’action de téléchargement SBE pour récupérer des packages de fournisseur de matériel tels que le firmware et les pilotes.
- Le fournisseur de matériel inclut généralement un contrôle d’intégrité de la connectivité de téléchargement qui doit passer avant le démarrage du téléchargement.
Si le téléchargement échoue lors de l’utilisation du connecteur de téléchargement SBE, l’état de mise à jour devient DownloadFailed. Pour afficher le message d’échec détaillé, examinez les détails de préparation dans Gestionnaire de mise à jour Azure dans le portail ou à l’aide de l’objet UpdateRun à partir de Get-SolutionUpdateRun.
Valider et extraire
Une fois que tout le contenu est téléchargé, le service de mise à jour valide l’intégrité des fichiers et extrait les fichiers de mise à jour.
Si la validation ou l’extraction échoue, UpdateRun enregistre l’erreur et l'état de mise à jour devient PreparationFailed.
Bilan de santé
Avant l’installation, le cluster exécute des vérifications d’intégrité avant la mise à jour. Ces vérifications vérifient que le cluster est dans un état sain. Ils identifient également les problèmes susceptibles d’interférer avec une installation réussie.
Chaque vérification de l'intégrité est associée à un niveau de gravité :
| Niveau de gravité | Résultat |
|---|---|
| Critique | Bloque la mise à jour. Vous devez corriger ces problèmes avant que l’installation puisse continuer. |
| Avertissement | Bloque la mise à jour par défaut. Vous pouvez contourner ces problèmes à l'aide de Start-SolutionUpdate -IgnoreWarnings. |
| Informational | Avis uniquement. Ne bloque pas l’installation. |
Si vous démarrez la mise à jour en -PrepareOnly mode, la mise à jour passe à l’état ReadyToInstall lorsque les contrôles d’intégrité passent. Si les contrôles de santé détectent des problèmes critiques ou d’alerte (et que vous ne spécifiez pas -IgnoreWarnings), l’état devient HealthCheckFailed.
Vous pouvez inspecter les résultats de la vérification d’intégrité sur l’objet de mise à jour à l’aide des éléments suivants :
# View health check results
(Get-SolutionUpdate).HealthCheckResult |
Where-Object { ($_.Status -ne "Success") -and ($_.Severity -ne "Informational") } |
Format-List Title, Status, Severity, Description, Remediation
Pour obtenir de l’aide sur la résolution des échecs de vérification de santé, consultez Résolution des problèmes de mise à jour.
Surveiller la phase de préparation
Surveillez la phase de préparation à l’aide de l’applet de commande Get-SolutionUpdateRun.
Chaque fois que vous exécutez Start-SolutionUpdate, avec ou sans -PrepareOnly, vous créez une UpdateRun ressource. Pour récupérer les détails de l’étape de préparation, utilisez :
# Get the most recent update run for an update
Get-SolutionUpdate -Id <UpdateResourceId> | Get-SolutionUpdateRun | % Progress | % Steps
Lorsqu’une exécution de préparation échoue, la propriété UpdateRunState est définie sur Failed, et l’arborescence de l’étape Progression contient des détails d’erreur au niveau de l’étape qui a rencontré le problème.
Phase d’installation
La mise à jour est en mesure d’entrer la phase d’installation lorsque vous exécutez Start-SolutionUpdate sans paramètre -PrepareOnly .
Lorsque vous démarrez la mise à jour de cette façon, l’installation commence :
-
Immédiatement : si vous avez récemment exécuté la phase de préparation et que la mise à jour était déjà dans l’état
ReadyToInstall. -
Une fois la préparation terminée , si la mise à jour n’a pas déjà été préparée et est uniquement dans l’état
Ready.
Démarrer l’installation
Pour démarrer une mise à jour complète qui inclut à la fois la préparation et l’installation, utilisez :
# Start a full update (preparation + installation)
Get-SolutionUpdate -Id <UpdateResourceId> | Start-SolutionUpdate
Lorsque l’installation commence, l’état de mise à jour passe à l’installation et un nouveau UpdateRun est créé. Cela UpdateRun représente la progression de l'installation et remplace le UpdateRun qui représentait précédemment la préparation.
Progression de l’installation
Pendant l’installation, la UpdateRunProgress propriété contient l’arborescence d’exécution complète du plan d’action. Cette propriété est une structure hiérarchique d’objets Step où chaque étape représente une étape, un rôle ou une tâche individuelle dans la mise à jour.
Chaque étape de l’arborescence de progression expose les propriétés suivantes :
| Propriété | Type | Description |
|---|---|---|
| Nom | ficelle | Nom de l’étape ou de la tâche |
| Description | ficelle | Description lisible par l’homme |
| État | ficelle |
InProgress, Success ou Error |
| StartTimeUtc | DateHeure | Lorsque l’étape a commencé à s’exécuter |
| EndTimeUtc | DateHeure | Lorsque l’étape est terminée ou a échoué |
| Message d'erreur | ficelle | Détails de l’erreur si l’étape a échoué |
| ExpectedExecutionTime | TimeSpan | Durée estimée du calcul de progression |
| Étapes | Étape[] | Sous-étapes formant l’arborescence d'exécution |
Surveiller la progression de l’installation
Étant donné que l’objet UpdateRun a une structure complexe, nous vous recommandons de surveiller l’état d’installation de la mise à jour via le portail Azure.
Pour surveiller la mise à jour dans PowerShell, surveillez directement l’état du plan d’action sous-jacent.
Remarque
**
Utilisez le cmdlet Start-MonitoringActionplanInstanceToComplete uniquement après l'installation de la mise à jour 2503 par le système. Avant 2503, l’utilisation de cette applet de commande pour surveiller la progression des mises à jour peut entraîner des échecs dans l’orchestration.
# Get the action plan instance ID from the update run, then monitor
$run = Get-SolutionUpdate | where State -eq "Installing" | Get-SolutionUpdateRun | where State -eq "InProgress"
$id = ($run.ResourceId -split '/')[-1]
Start-MonitoringActionplanInstanceToComplete -actionPlanInstanceID $id
Cette commande fournit une sortie de console en temps réel qui s’actualise automatiquement. Appuyez sur Ctrl+C pour quitter le moniteur sans arrêter la mise à jour.
Modifications de l’état d’installation
La mise à jour passe par ces états pendant l’installation :
| State | Signification |
|---|---|
| Installation en cours | L’installation est en cours d’exécution. |
| Installé | La mise à jour s'est installée avec succès. |
| Échec de l’installation | Une ou plusieurs étapes ont échoué. |
Résoudre les problèmes d’installation
En cas d’échec de l’installation, passez en revue les détails de l’échec dans le portail Azure ou à l’aide de l’applet de commande Get-SolutionUpdateRun. Pour obtenir des conseils sur la résolution des problèmes, consultez Résoudre les problèmes liés aux mises à jour.
Après avoir examiné et atténué l'échec, ou déterminé qu'il est temporaire, reprenez la mise à jour à partir du portail Azure ou à l'aide de l'applet de commande Start-SolutionUpdate :
Get-SolutionUpdate | where State -eq "InstallationFailed" | Start-SolutionUpdate
Après avoir exécuté cette applet de commande, l’état de mise à jour change de InstallationFailed à Installing.
Étapes suivantes
En savoir plus sur la résolution des problèmes de mises à jour.