Superviser les mises à jour dans Azure Stack Hub à l’aide du point de terminaison privilégié
Vous pouvez utiliser le point de terminaison privilégié pour surveiller la progression de l’exécution d’une mise à jour d’Azure Stack Hub. Le point de terminaison privilégié vous permet également de reprendre l’exécution d’une mise à jour ayant échoué à partir de la dernière étape réussie, dans le cas où vous n’avez plus accès au portail Azure Stack Hub. L’utilisation du portail Azure Stack Hub est la méthode recommandée pour gérer les mises à jour dans Azure Stack Hub.
Les nouvelles applets de commande PowerShell suivantes pour la gestion des mises à jour sont incluses dans la mise à jour 1710 des systèmes intégrés Azure Stack Hub.
| Applet de commande | Description |
|---|---|
Get-AzureStackUpdateStatus |
Renvoie l’état de la mise à jour en cours, terminée ou qui a échoué. Fournit l’état de haut niveau de l’opération de mise à jour ainsi qu’un document XML qui décrit l’étape actuelle et l’état correspondant. |
Resume-AzureStackUpdate |
Reprend une mise à jour ayant échoué au point où elle a échoué. Dans certains scénarios, vous devrez peut-être prendre des mesures d’atténuation des risques avant de reprendre la mise à jour. |
Vérifier que les applets de commande sont disponibles
Les applets de commande étant nouvelles dans le package de mise à jour 1710 d’Azure Stack Hub, le processus de mise à jour 1710 doit atteindre un certain point avant que la fonctionnalité de surveillance soit disponible. En règle générale, les applets de commande sont disponibles si l’état dans le portail d’administration indique que la mise à jour 1710 se trouve à l'étape Redémarrer les hôtes de stockage. Pour être plus précis, la mise à jour de la cmdlet intervient au cours de l'Étape : Exécution de l’étape 2.6 - Mise à jour de la liste d’autorisation PrivilegedEndpoint.
Vous pouvez également déterminer si les applets de commande sont disponibles par programmation en interrogeant la liste des commandes à partir du point de terminaison privilégié. Pour exécuter cette requête, exécutez les commandes suivantes à partir de l’hôte de cycle de vie du matériel ou d’une station de travail avec accès privilégié. Assurez-vous également que le point de terminaison privilégié est un hôte approuvé. Pour plus d’informations, consultez l’étape 1 Accéder au point de terminaison privilégié.
Créez une session PowerShell sur une des machines virtuelles ERCS de votre environnement Azure Stack Hub (Prefix-ERCS01, Prefix-ERCS02 ou Prefix-ERCS03). Remplacez Prefix par la chaîne de préfixe de la machine virtuelle spécifique à votre environnement.
$cred = Get-Credential $pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)Lorsque vous êtes invité à saisir vos informations d’identification, utilisez le <domaine Azure Stack Hub>\compte cloudadmin, ou un compte membre du groupe CloudAdmins. Pour le compte CloudAdmin, entrez le mot de passe fourni pendant l’installation pour le compte d’administrateur de domaine AzureStackAdmin.
Obtenez la liste complète des commandes disponibles dans le point de terminaison privilégié.
$commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command }Déterminez si le point de terminaison privilégié a été mis à jour.
$updateManagementModuleName = "Microsoft.Azurestack.UpdateManagement" if (($commands | ? Source -eq $updateManagementModuleName)) { Write-Host "Privileged endpoint was updated to support update monitoring tools." } else { Write-Host "Privileged endpoint has not been updated yet. Please try again later." }Liste des commandes spécifiques au module Microsoft.AzureStack.UpdateManagement.
$commands | ? Source -eq $updateManagementModuleNamePar exemple :
$commands | ? Source -eq $updateManagementModuleName CommandType Name Version Source PSComputerName ----------- ---- ------- ------ -------------- Function Get-AzureStackUpdateStatus 0.0 Microsoft.Azurestack.UpdateManagement Contoso-ercs01 Function Resume-AzureStackUpdate 0.0 Microsoft.Azurestack.UpdateManagement Contoso-ercs01
Utiliser les applets de commande de gestion des mises à jour
Notes
Exécutez les commandes suivantes à partir de l’hôte de cycle de vie du matériel ou d’une station de travail avec accès privilégié. Assurez-vous également que le point de terminaison privilégié est un hôte approuvé. Pour plus d’informations, consultez l’étape 1 Accéder au point de terminaison privilégié.
Se connecter au point de terminaison privilégié et attribuer une variable de session
Exécutez les commandes suivantes pour créer une session PowerShell sur une des machines virtuelles ERCS de votre environnement Azure Stack Hub (Prefix-ERCS01, Prefix-ERCS02 ou Prefix-ERCS03), et pour attribuer une variable de session.
$cred = Get-Credential
$pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
Lorsque vous êtes invité à saisir vos informations d’identification, utilisez le <domaine Azure Stack Hub>\compte cloudadmin, ou un compte membre du groupe CloudAdmins. Pour le compte CloudAdmin, entrez le mot de passe fourni pendant l’installation pour le compte d’administrateur de domaine AzureStackAdmin.
Obtenir l’état de haut niveau de l’exécution de la mise à jour actuelle
Pour obtenir un état de haut niveau de l’exécution de la mise à jour actuelle, exécutez les commandes suivantes :
$statusString = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus -StatusOnly }
$statusString.Value
Les valeurs possibles incluent :
- Exécution en cours
- Completed
- Échec
- Opération annulée
Vous pouvez exécuter ces commandes à plusieurs reprises pour afficher l’état le plus récent. Vous n’êtes pas obligé de rétablir la connexion à chaque fois.
Obtenir l’état détaillé complet de l'exécution de la mise à jour
Vous pouvez obtenir le résumé complet de l'exécution de la mise à jour sous forme d'une chaîne XML. Vous pouvez enregistrer la chaîne dans un fichier pour l'examiner, ou la convertir en un document XML et utiliser PowerShell pour l’analyser. La commande suivante analyse le code XML pour obtenir une liste hiérarchique des étapes en cours d’exécution :
[xml]$updateStatus = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus }
$updateStatus.SelectNodes("//Step[@Status='InProgress']")
Dans l’exemple suivant, l’étape de niveau supérieur (mise à jour du cloud) dispose d’un plan enfant pour mettre à jour et redémarrer les hôtes de stockage. Cela indique que le plan de redémarrage des hôtes de stockage met à jour le service de Stockage Blob sur un des hôtes.
[xml]$updateStatus = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus }
$updateStatus.SelectNodes("//Step[@Status='InProgress']")
FullStepIndex : 2
Index : 2
Name : Cloud Update
Description : Perform cloud update.
StartTimeUtc : 2017-10-13T12:50:39.9020351Z
Status : InProgress
Task : Task
FullStepIndex : 2.9
Index : 9
Name : Restart Storage Hosts
Description : Restart Storage Hosts.
EceErrorAction : Stop
StartTimeUtc : 2017-10-13T15:44:06.7431447Z
Status : InProgress
Task : Task
FullStepIndex : 2.9.2
Index : 2
Name : PreUpdate ACS Blob Service
Description : Check function level, update deployment artifacts, configure Blob service settings
StartTimeUtc : 2017-10-13T15:44:26.0708525Z
Status : InProgress
Task : Task
Reprendre une opération de mise à jour ayant échoué
Si la mise à jour échoue, vous pouvez la reprendre là où elle s’est arrêtée.
Invoke-Command -Session $pepSession -ScriptBlock { Resume-AzureStackUpdate }
Dépanner
Le point de terminaison privilégié est disponible sur toutes les machines virtuelles ERCS dans l’environnement Azure Stack Hub. Comme la connexion n’est pas établie vers un point de terminaison hautement disponible, vous risquez de rencontrer des interruptions occasionnelles, des avertissements ou des messages d’erreur. Ces messages peuvent indiquer que la session a été déconnectée ou qu’une erreur de communication avec le service ECE s'est produite. Il s’agit du comportement attendu. Vous pouvez réessayer l’opération dans quelques minutes ou créer une session de point de terminaison privilégié sur l’une des autres machines virtuelles ERCS.
Pour plus d'informations sur le dépannage des problèmes de mise à jour, consultez Résolution des problèmes liés à Azure Stack.
Étapes suivantes
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour