Monitorování aktualizací služby Azure Stack Hub pomocí privilegovaného koncového bodu

Článek
03/29/2024

Pomocí privilegovaného koncového bodu můžete monitorovat průběh spuštění aktualizace služby Azure Stack Hub. Můžete také použít privilegovaný koncový bod k obnovení neúspěšného spuštění aktualizace z posledního úspěšného kroku v případě, že bude portál Azure Stack Hub nedostupný. Ke správě aktualizací ve službě Azure Stack Hub se doporučuje používat portál Azure Stack Hub.

Následující nové rutiny PowerShellu pro správu aktualizací jsou součástí aktualizace 1710 pro integrované systémy Služby Azure Stack Hub.

Rutina	Popis
`Get-AzureStackUpdateStatus`	Vrátí stav aktuálně spuštěné, dokončené nebo neúspěšné aktualizace. Poskytuje základní stav operace aktualizace a dokument XML, který popisuje aktuální krok i odpovídající stav.
`Resume-AzureStackUpdate`	Obnoví neúspěšnou aktualizaci v okamžiku, kdy selhala. V některých scénářích může být nutné provést kroky pro zmírnění rizik, než aktualizaci obnovíte.

Ověřte, že jsou rutiny dostupné.

Vzhledem k tomu, že rutiny jsou v balíčku aktualizace 1710 pro Azure Stack Hub nové, musí proces aktualizace 1710 přejít do určitého bodu, než bude k dispozici funkce monitorování. Rutiny jsou obvykle k dispozici, pokud stav na portálu pro správu indikuje, že aktualizace 1710 je v kroku Restartování hostitelů úložiště . Konkrétně k aktualizaci rutiny dochází během kroku: Spuštění kroku 2.6 – aktualizace seznamu povolených privilegovaných bodů.

Můžete také zjistit, jestli jsou rutiny dostupné programově, dotazováním seznamu příkazů z privilegovaného koncového bodu. Chcete-li provést tento dotaz, spusťte následující příkazy z hostitele životního cyklu hardwaru nebo z pracovní stanice Privileged Access. Také se ujistěte, že je privilegovaný koncový bod důvěryhodným hostitelem. Další informace najdete v kroku 1 v tématu Přístup k privilegovanému koncovému bodu.

Vytvořte relaci PowerShellu na libovolném virtuálním počítači ERCS ve vašem prostředí služby Azure Stack Hub (Prefix-ERCS01, Prefix-ERCS02 nebo Prefix-ERCS03). Předponu nahraďte řetězcem předpony virtuálního počítače, který je specifický pro vaše prostředí.
```
$cred = Get-Credential

$pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
```
Po zobrazení výzvy k zadání přihlašovacích údajů použijte < účet doména >služby Azure Stack Hub\cloudadmin nebo účet, který je členem skupiny CloudAdmins. Jako účet CloudAdmin zadejte stejné heslo, které jste zadali při instalaci pro účet správce domény AzureStackAdmin.
Získejte úplný seznam příkazů, které jsou k dispozici v privilegovaném koncovém bodu.
```
$commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command } 
```

Zjistěte, jestli se privilegovaný koncový bod aktualizoval.

$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."
 }

Zobrazí seznam příkazů specifických pro modul Microsoft.AzureStack.UpdateManagement.

$commands | ? Source -eq $updateManagementModuleName

Příklad:

$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

Použití rutin řešení Update Management

Poznámka

Spusťte následující příkazy z hostitele životního cyklu hardwaru nebo z pracovní stanice Privileged Access. Také se ujistěte, že je privilegovaný koncový bod důvěryhodným hostitelem. Další informace najdete v kroku 1 v tématu Přístup k privilegovanému koncovému bodu.

Připojení k privilegovanému koncovému bodu a přiřazení proměnné relace

Spuštěním následujících příkazů vytvořte relaci PowerShellu na libovolném virtuálním počítači ERCS ve vašem prostředí služby Azure Stack Hub (Prefix-ERCS01, Prefix-ERCS02 nebo Prefix-ERCS03) a přiřaďte proměnnou relace.

$cred = Get-Credential

$pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)

Po zobrazení výzvy k zadání přihlašovacích údajů použijte < účet doména >služby Azure Stack Hub\cloudadmin nebo účet, který je členem skupiny CloudAdmins. Jako účet CloudAdmin zadejte stejné heslo, které jste zadali při instalaci pro účet správce domény AzureStackAdmin.

Získání základního stavu aktuálního spuštění aktualizace

Pokud chcete získat základní stav aktuálního spuštění aktualizace, spusťte následující příkazy:

$statusString = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus -StatusOnly }

$statusString.Value

Mezi možné hodnoty patří:

Spuštěno
Dokončeno
Neúspěšný
Zrušeno

Tyto příkazy můžete opakovaně spouštět, abyste viděli nejaktuálnější stav. Abyste to mohli znovu zkontrolovat, nemusíte znovu navazovat připojení.

Získání úplného stavu spuštění aktualizace s podrobnostmi

Souhrn úplného spuštění aktualizace můžete získat jako řetězec XML. Řetězec můžete zapsat do souboru ke kontrole nebo ho převést na dokument XML a parsovat ho pomocí PowerShellu. Následující příkaz parsuje XML a získá hierarchický seznam aktuálně spuštěných kroků:

[xml]$updateStatus = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus }

$updateStatus.SelectNodes("//Step[@Status='InProgress']")

V následujícím příkladu má krok nejvyšší úrovně (Cloud Update) podřízený plán aktualizace a restartování hostitelů úložiště. Ukazuje, že plán Restartovat hostitele úložiště aktualizuje službu Blob Storage na jednom z hostitelů.

[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

Obnovení neúspěšné operace aktualizace

Pokud aktualizace selže, můžete pokračovat ve spuštění aktualizace tam, kde skončila.

Invoke-Command -Session $pepSession -ScriptBlock { Resume-AzureStackUpdate }

Řešení potíží

Privilegovaný koncový bod je k dispozici na všech virtuálních počítačích ERCS v prostředí Služby Azure Stack Hub. Vzhledem k tomu, že připojení k vysoce dostupnému koncovému bodu není vytvořené, může docházet k občasné přerušení, upozornění nebo chybovým zprávám. Tyto zprávy můžou znamenat, že relace byla odpojena nebo že došlo k chybě při komunikaci se službou ECE. Jde o očekávané chování. Operaci můžete zkusit zopakovat během několika minut nebo vytvořit novou relaci privilegovaného koncového bodu na jednom z dalších virtuálních počítačů ERCS.

Další informace o řešení potíží s aktualizacemi najdete v tématu Řešení potíží se službou Azure Stack.

Další kroky

Správa aktualizací ve službě Azure Stack Hub