Ayrıcalıklı uç noktayı kullanarak Azure Stack Hub güncelleştirmelerini izleme

Makale
10/30/2024

Azure Stack Hub güncelleştirme çalıştırmasının ilerleme durumunu izlemek için ayrıcalıklı uç noktayı kullanabilirsiniz. Azure Stack Hub portalı kullanılamaz duruma gelirse son başarılı adımdan başarısız bir güncelleştirme çalıştırmasını sürdürmek için ayrıcalıklı uç noktayı da kullanabilirsiniz. Azure Stack Hub portalını kullanmak, Azure Stack Hub'daki güncelleştirmeleri yönetmek için önerilen yöntemdir.

Güncelleştirme yönetimi için aşağıdaki yeni PowerShell cmdlet'leri, Azure Stack Hub tümleşik sistemleri için 1710 güncelleştirmesine eklenmiştir.

Cmdlet	Açıklama
`Get-AzureStackUpdateStatus`	Çalışmakta olan, tamamlanan veya başarısız olan güncelleştirmenin durumunu döndürür. Güncelleştirme işleminin üst düzey durumunu ve hem geçerli adımı hem de ilgili durumu açıklayan bir XML belgesi sağlar.
`Resume-AzureStackUpdate`	Başarısız olan bir güncelleştirmeyi başarısız olduğu noktada sürdürür. Bazı senaryolarda, güncelleştirmeyi sürdürmeden önce azaltma adımlarını tamamlamanız gerekebilir.

Cmdlet'lerin kullanılabilir olduğunu doğrulayın

Cmdlet'ler Azure Stack Hub için 1710 güncelleştirme paketinde yeni olduğundan, izleme özelliğinin kullanılabilir duruma gelmesi için 1710 güncelleştirme işleminin belirli bir noktaya gelmesi gerekir. Genellikle, yönetici portalındaki durum 1710 güncelleştirmesinin Depolama Konaklarını Yeniden Başlat adımında olduğunu gösteriyorsa cmdlet'ler kullanılabilir. Özellikle, cmdlet güncelleştirmesi Adım: 2.6 adımını çalıştırma - PrivilegedEndpoint izin verilenler listesini güncelleştirme sırasında gerçekleşir.

Ayrıca, komut listesini ayrıcalıklı uç noktadan sorgulayarak cmdlet'lerin program aracılığıyla kullanılabilir olup olmadığını belirleyebilirsiniz. Bu sorguyu yapmak için donanım yaşam döngüsü konağından veya Privileged Access workstation'dan aşağıdaki komutları çalıştırın. Ayrıca, ayrıcalıklı uç noktanın güvenilir bir konak olduğundan emin olun. Daha fazla bilgi için bkz. Ayrıcalıklı uç noktaya erişmenin 1. adımı.

Azure Stack Hub ortamınızdaki (Prefix-ERCS01, Prefix-ERCS02 veya Prefix-ERCS03) herhangi bir ERCS sanal makinesinde (VM) powershell oturumu oluşturun. Ön Ek'i ortamınıza özgü VM ön ek dizesiyle değiştirin.
```
$cred = Get-Credential

$pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
```
Kimlik bilgileri istendiğinde Azure Stack Hub domain>\cloudadmin hesabını veya CloudAdmins grubunun üyesi olan bir hesabı kullanın<. CloudAdmin hesabı için, AzureStackAdmin etki alanı yönetici hesabı için yükleme sırasında sağlanan parolayı girin.

Ayrıcalıklı uç noktada kullanılabilen komutların tam listesini alın.

$commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command }

Ayrıcalıklı uç noktanın güncelleştirilip güncelleştirilmediğini belirleyin.

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

Microsoft.AzureStack.UpdateManagement modülüne özgü komutları listeleyin.

$commands | ? Source -eq $updateManagementModuleName

Örnek:

$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

Güncelleştirme yönetimi cmdlet'lerini kullanma

Not

Donanım yaşam döngüsü konağından veya Privileged Access workstation'dan aşağıdaki komutları çalıştırın. Ayrıca, ayrıcalıklı uç noktanın güvenilir bir konak olduğundan emin olun. Daha fazla bilgi için bkz. Ayrıcalıklı uç noktaya erişmenin 1. adımı.

Ayrıcalıklı uç noktaya bağlanma ve oturum değişkeni atama

Azure Stack Hub ortamınızdaki ERCS VM'lerinden herhangi birinde (Prefix-ERCS01, Prefix-ERCS02 veya Prefix-ERCS03) powershell oturumu oluşturmak ve bir oturum değişkeni atamak için aşağıdaki komutları çalıştırın.

$cred = Get-Credential

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

Kimlik bilgileri istendiğinde Azure Stack Hub domain>\cloudadmin hesabını veya CloudAdmins grubunun üyesi olan bir hesabı kullanın<. CloudAdmin hesabı için, AzureStackAdmin etki alanı yönetici hesabı için yükleme sırasında sağlanan parolayı girin.

Geçerli güncelleştirme çalıştırmasının üst düzey durumunu alma

Geçerli güncelleştirme çalıştırmasının üst düzey durumunu almak için aşağıdaki komutları çalıştırın:

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

$statusString.Value

Olası değerler şunlardır:

Çalışma
Tamamlandı
Başarısız
İptal edildi

En güncel durumu görmek için bu komutları tekrar tekrar çalıştırabilirsiniz. Yeniden denetlemek için yeniden bağlantı kurmanız gerekmez.

Ayrıntılarla birlikte güncelleştirme çalıştırma durumunun tamamını alma

Tam güncelleştirme çalıştırması özetini xml dizesi olarak alabilirsiniz. Dizeyi incelenmek üzere bir dosyaya yazabilir veya XML belgesine dönüştürebilir ve Ayrıştırmak için PowerShell kullanabilirsiniz. Aşağıdaki komut, XML'yi ayrıştırarak çalışmakta olan adımların hiyerarşik listesini alır:

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

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

Aşağıdaki örnekte, üst düzey adım (Cloud Update) depolama konaklarını güncelleştirmek ve yeniden başlatmak için bir alt plana sahiptir. Depolama Konaklarını Yeniden Başlat planının, konaklardan birinde Blob Depolama hizmetini güncelleştirdiğini gösterir.

[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

Başarısız güncelleştirme işlemini sürdürme

Güncelleştirme başarısız olursa, güncelleştirme çalıştırmasını kaldığı yerden sürdürebilirsiniz.

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

Sorun giderme

Ayrıcalıklı uç nokta, Azure Stack Hub ortamındaki tüm ERCS VM'lerinde kullanılabilir. Bağlantı yüksek oranda kullanılabilir bir uç noktaya yapılmadığından, ara sıra kesintiler, uyarı veya hata iletileriyle karşılaşabilirsiniz. Bu iletiler oturumun bağlantısının kesildiğini veya ECE Hizmeti ile iletişim kurarken bir hata olduğunu gösterebilir. Bu beklenen bir davranıştır. İşlemi birkaç dakika içinde yeniden deneyebilir veya diğer ERCS VM'lerinden birinde yeni bir ayrıcalıklı uç nokta oturumu oluşturabilirsiniz.

Güncelleştirme sorunlarını giderme hakkında daha fazla bilgi için bkz. Azure Stack Sorunlarını Giderme

Sonraki adımlar

Azure Stack Hub'da güncelleştirmeleri yönetme

Aracılığıyla paylaş