Menggunakan titik akhir istimewa di Azure Stack Hub

Anda dapat menggunakan titik akhir istimewa untuk memantau kemajuan proses pembaruan Azure Stack Hub. Anda juga dapat menggunakan titik akhir istimewa untuk melanjutkan proses pembaruan yang gagal dari langkah terakhir yang berhasil jika portal Azure Stack Hub menjadi tidak tersedia. Menggunakan portal Azure Stack Hub adalah metode yang disarankan untuk mengelola pembaruan di Azure Stack Hub.

Cmdlet PowerShell baru berikut untuk manajemen pembaruan disertakan dalam pembaruan 1710 untuk sistem terintegrasi Azure Stack Hub.

Cmdlet Deskripsi
Get-AzureStackUpdateStatus Menampilkan status pembaruan yang sedang berjalan, selesai, atau gagal. Memberikan status tingkat tinggi dari operasi pembaruan dan dokumen XML yang menjelaskan langkah saat ini dan status yang sesuai.
Resume-AzureStackUpdate Melanjutkan pembaruan yang gagal pada titik kegagalan tersebut. Dalam skenario tertentu, Anda mungkin harus menyelesaikan langkah-langkah mitigasi sebelum melanjutkan pembaruan.

Pastikan cmdlet tersedia

Karena cmdlet adalah hal yang baru dalam paket pembaruan 1710 untuk Azure Stack Hub, proses pembaruan 1710 perlu sampai ke titik tertentu sebelum kemampuan pemantauan tersedia. Biasanya, cmdlet tersedia jika status di portal administrator menunjukkan bahwa pembaruan 1710 berada pada langkah Hidupkan Ulang Host Penyimpanan. Secara khusus, pembaruan cmdlet berlangsung selama Langkah: Menjalankan langkah 2.6 - Perbarui daftar PrivilegedEndpoint yang diizinkan.

Anda juga dapat menentukan apakah cmdlet tersedia secara terprogram dengan mengkueri daftar perintah dari titik akhir istimewa. Untuk melakukan kueri ini, jalankan perintah berikut dari host siklus hidup perangkat keras atau dari Stasiun Kerja Akses Istimewa. Selain itu, pastikan titik akhir istimewa adalah host tepercaya. Untuk informasi selengkapnya, lihat langkah 1 Akses titik akhir istimewa.

  1. Buat sesi PowerShell di salah satu mesin virtual (VM) ERCS di lingkungan Azure Stack Hub Anda (Prefix-ERCS01, Prefix-ERCS02, atau Prefix-ERCS03). Ganti Prefiks dengan string prefiks VM yang khusus untuk lingkungan Anda.

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

    Jika dimintai informasi masuk, gunakan akun <<>\cloudadmin, atau akun yang merupakan anggota grup CloudAdmins. Untuk akun CloudAdmin, masukkan kata sandi yang sama yang disediakan pada saat penginstalan akun administrator domain AzureStackAdmin.

  2. Dapatkan daftar lengkap perintah yang tersedia di titik akhir istimewa.

    $commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command } 
    
  3. Pastikan apakah titik akhir istimewa telah diperbarui.

    $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."
     } 
    
  4. Buat daftar perintah khusus untuk modul Microsoft.AzureStack.UpdateManagement.

    $commands | ? Source -eq $updateManagementModuleName 
    

    Contohnya:

    $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
    

Menggunakan cmdlet manajemen pembaruan

Catatan

Jalankan perintah berikut dari host siklus hidup perangkat keras atau dari Stasiun Kerja Akses Istimewa. Selain itu, pastikan titik akhir istimewa adalah host tepercaya. Untuk informasi selengkapnya, lihat langkah 1 Akses titik akhir istimewa.

Menyambungkan ke titik akhir istimewa dan menetapkan variabel sesi

Jalankan perintah berikut untuk membuat sesi PowerShell pada salah satu VM ERCS di lingkungan Azure Stack Hub Anda (Prefix-ERCS01, Prefix-ERCS02, atau Prefix-ERCS03), dan untuk menetapkan variabel sesi.

$cred = Get-Credential

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

Jika dimintai informasi masuk, gunakan akun <<>\cloudadmin, atau akun yang merupakan anggota grup CloudAdmins. Untuk akun CloudAdmin, masukkan kata sandi yang sama yang disediakan pada saat penginstalan akun administrator domain AzureStackAdmin.

Dapatkan status tingkat tinggi dari proses pembaruan saat ini

Untuk mendapatkan status tingkat tinggi dari proses pembaruan saat ini, jalankan perintah berikut:

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

$statusString.Value 

Nilai yang mungkin termasuk:

  • Berjalan
  • Selesai
  • Gagal
  • Batal

Anda dapat menjalankan perintah ini berulang kali untuk melihat status terbaru. Untuk memeriksa lagi, Anda tidak perlu membuat ulang koneksi.

Mendapatkan status proses pembaruan lengkap dengan detailnya

Anda bisa mendapatkan ringkasan proses pembaruan lengkap dalam string XML. Anda dapat menulis string ke file untuk pemeriksaan, atau mengonversinya ke dokumen XML dan menggunakan PowerShell untuk menguraikannya. Perintah berikut mengurai XML untuk mendapatkan daftar hierarkis dari langkah-langkah yang sedang dijalankan:

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

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

Dalam contoh berikut, langkah tingkat atas (Pembaruan Cloud) memiliki rencana turunan untuk memperbarui dan menghidupkan ulang host penyimpanan. Ini menunjukkan bahwa paket Hidupkan Ulang Host Penyimpanan memperbarui layanan Blob Storage di salah satu host.

[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

Melanjutkan operasi pembaruan yang gagal

Jika pembaruan gagal, Anda dapat melanjutkan proses pembaruan dari langkah terakhir yang berhasil.

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

Pecahkan masalah

Titik akhir istimewa tersedia di semua VM ERCS di lingkungan Azure Stack Hub. Karena koneksi tidak dibuat ke titik akhir yang sangat tersedia, Anda mungkin mendapatkan gangguan, peringatan, atau pesan kesalahan sesekali. Pesan tersebut mungkin menunjukkan bahwa sesi terputus atau terjadi kesalahan saat berkomunikasi dengan Layanan ECE. Perilaku ini diharapkan. Anda dapat mencoba kembali operasi dalam beberapa menit atau membuat sesi titik akhir istimewa baru di salah satu VM ERCS lainnya.

Untuk informasi selengkapnya tentang pemecahan masalah pembaruan, lihat Pemecahan Masalah Azure Stack

Langkah berikutnya