Manajemen ekstensi Azure Arc di Azure Stack HCI

Berlaku untuk: Azure Stack HCI, versi 23H2 dan 22H2

Artikel ini menjelaskan cara menginstal, meningkatkan, dan mengelola ekstensi Azure Arc di komputer server Azure Stack HCI.

Ekstensi Azure Arc yang dikelola pelanggan di Azure Stack HCI

Dengan Azure Stack HCI, Anda dapat menginstal, menghapus, dan memperbarui ekstensi Azure Arc pada sistem Azure Stack HCI Anda. Azure Arc memungkinkan Anda menjalankan layanan hibrid seperti pemantauan dan Windows Admin Center di portal Azure.

Berikut adalah ekstensi individual yang dapat Anda instal dan kelola.

• Agen Pemantauan Azure
• Azure Site Recovery
• Pusat Admin Windows

Ekstensi yang dikelola Azure di Azure Stack HCI

Setelah Anda berhasil mendaftarkan kluster Azure Stack HCI baru Anda dengan Azure, ekstensi yang dikelola Azure secara otomatis diinstal pada kluster Anda. Ekstensi ini sangat penting untuk fungsionalitas dan kualitas sistem Anda dan tidak dapat dihapus instalasinya. Anda dapat mengelola perilaku ekstensi ini di portal Azure dengan menavigasi ke halaman Ekstensi dan memilih menu Pengaturan.

Jika Anda memiliki kluster Azure Stack HCI yang sudah ada yang terdaftar ke Azure tanpa ekstensi ini, banner muncul di halaman Gambaran Umum atau Ekstensi di portal Azure. Anda dapat menggunakan informasi dalam spanduk untuk memandu Anda menginstal ekstensi ini.

Berikut adalah ekstensi yang dikelola Azure:

• Telemetri dan diagnostik
• Ekstensi Arc Dukungan Jarak Jauh

Menginstal ekstensi

Portal Azure

Anda dapat menginstal ekstensi dari tab Kemampuan untuk server dengan dukungan Azure Stack HCI Arc seperti yang ditunjukkan pada cuplikan layar. Anda dapat menggunakan tab kemampuan untuk menginstal sebagian besar ekstensi.

Saat Anda menginstal ekstensi di portal Azure, ini adalah operasi sadar kluster. Ekstensi ini diinstal pada semua server kluster. Jika Anda menambahkan lebih banyak server ke kluster Anda, semua ekstensi yang diinstal pada kluster Anda secara otomatis ditambahkan ke server baru.

Azure CLI

Azure CLI tersedia untuk diinstal di lingkungan Windows, macOS, dan Linux. Ini juga dapat dijalankan di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Azure Cloud Shell.

Luncurkan Azure Cloud Shell dan gunakan Bash untuk menginstal ekstensi dengan mengikuti langkah-langkah berikut:

1. Menyiapkan parameter dari langganan, grup sumber daya, dan kluster Anda

   subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   resourceGroup="hcicluster-rg" # Replace with your resource group name
   
   az account set --subscription "${subscription}"
   
   clusters=($(az graph query -q "resources | where type == 'microsoft.azurestackhci/clusters'| where resourceGroup =~ '${resourceGroup}' | project name" | jq -r '.data[].name'))
   

2. Untuk menginstal ekstensi Windows Admin Center pada semua kluster di bawah grup sumber daya, jalankan perintah berikut:

   extensionName="AdminCenter"
   extensionType="AdminCenter"
   extensionPublisher="Microsoft.AdminCenter"
   settingsConfig="{'port':'6516'}"
   connectivityProps="{enabled:true}"
   
   for cluster in ${clusters}; do
       echo "Enabling Connectivity for cluster $currentCluster"
       az stack-hci arc-setting update \
           --resource-group ${resourceGroup} \
           --cluster-name ${cluster} \
           --name "default" \
           --connectivity-properties ${connectivityProps}
   
       echo "Installing extension: ${extensionName} on cluster: ${cluster}"
       az stack-hci extension create \
           --arc-setting-name "default" \
           --cluster-name "${cluster}" \
           --resource-group "${resourceGroup}" \
           --name "${extensionName}" \
           --auto-upgrade "true" \
           --publisher "${extensionPublisher}" \
           --type "${extensionType}" \
           --settings "${settingsConfig}"
   done
   

3. Untuk menginstal ekstensi Agen Azure Monitor pada semua kluster di bawah grup sumber daya, jalankan perintah berikut:

   extensionName="AzureMonitorWindowsAgent"
   extensionType="AzureMonitorWindowsAgent"
   extensionPublisher="Microsoft.Azure.Monitor"
   
   for cluster in ${clusters}; do
       echo "Installing extension: ${extensionName} on cluster: ${cluster}"
   
       az stack-hci extension create \
           --arc-setting-name "default" \
           --cluster-name "${cluster}" \
           --resource-group "${resourceGroup}" \
           --name "${extensionName}" \
           --auto-upgrade "true" \
           --publisher "${extensionPublisher}" \
           --type "${extensionType}"
   done
   

4. Untuk menginstal ekstensi Azure Site Recovery pada semua kluster di bawah grup sumber daya, jalankan perintah berikut:

   asrSubscription="00000000-0000-0000-0000-000000000000" # Replace with your ASR subscription ID
   asrResourceGroup="asr-rg" # Replace with your ASR resource group
   asrVaultName="asr-vault" # Replace with your ASR vault name
   asrLocation="East US" # Replace with your ASR Location
   asrSiteId="00000000-0000-0000-0000-000000000000" # Replace with your ASR Site ID
   asrSiteName="asr-site" # Replace with your Site Name
   asrSitePolicyId="/subscriptions/${asrSubscription}/resourceGroups/${asrResourceGroup}/providers/Microsoft.RecoveryServices/vaults/${asrVaultName}/replicationPolicies/s-cluster-policy" # Replace with your Site Policy name
   
   extensionName="ASRExtension"
   extensionType="Windows"
   extensionPublisher="Microsoft.SiteRecovery.Dra"
   jsonFile="./tmp-asr.json" #Temp JSON file
   
   echo "{\"SubscriptionId\": \"${asrSubscription}\", \"Environment\": \"AzureCloud\",\"ResourceGroup\": \"${asrResourceGroup}\",\"Location\": \"${asrLocation}\",\"SiteId\": \"${asrSiteId}\", \"SiteName\": \"${asrSiteName}\", \"PolicyId\": \"${asrSitePolicyId}\", \"PrivateEndpointStateForSiteRecovery\": \"None\" }" > ${jsonFile}
   
   for cluster in ${clusters}; do
       echo "Installing extension: ${extensionName} on cluster: ${cluster}"
   
       az stack-hci extension create \
           --arc-setting-name "default" \
           --cluster-name "${cluster}" \
           --resource-group "${resourceGroup}" \
           --name "${extensionName}" \
           --auto-upgrade "true" \
           --publisher "${extensionPublisher}" \
           --type "${extensionType}" \
           --settings "${jsonFile}"
   done
   

Azure PowerShell

Azure PowerShell dapat dijalankan di Azure Cloud Shell. Dokumen ini merinci cara menggunakan PowerShell di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Azure Cloud Shell.

Luncurkan Azure Cloud Shell dan gunakan PowerShell untuk menginstal ekstensi dengan mengikuti langkah-langkah berikut:

1. Siapkan parameter dari langganan, grup sumber daya, dan kluster Anda:

   $subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   $resourceGroup = "hcicluster-rg" # Replace with your resource group name
   
   Set-AzContext -Subscription "${subscription}"
   $clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name
   

2. Untuk menginstal ekstensi Windows Admin Center pada semua kluster di bawah grup sumber daya, jalankan perintah berikut:

   $extensionName = "AdminCenter"
   $extensionType = "AdminCenter"
   $extensionPublisher = "Microsoft.AdminCenter"
   $settingsConfig = @{"port" = 6516 }
   
   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
   
       Write-Output ("Enable connectivity for cluster ${clusterName}")
       Invoke-AzRestMethod `
           -Method PATCH `
           -SubscriptionId ${subscription} `
           -ResourceGroupName ${resourceGroup} `
           -ResourceProviderName "Microsoft.AzureStackHCI" `
           -ResourceType ("clusters/" + ${clusterName} + "/arcSettings") `
           -Name "default" `
           -ApiVersion "2023-02-01" `
           -Payload (@{"properties" = @{ "connectivityProperties" = @{ "enabled" = $true } } } | ConvertTo-Json -Depth 5)
   
   
       Write-Output ("Installing Extension '${extensionName}' on cluster ${clusterName}")
   
       New-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default" `
           -Name "${extensionName}" `
           -ExtensionParameterPublisher "${extensionPublisher}" `
           -ExtensionParameterType "${extensionType}" `
           -ExtensionParameterSetting ${settingsConfig} `
           -NoWait
   }
   

3. Untuk menginstal ekstensi Agen Azure Monitor pada semua kluster di bawah grup sumber daya, jalankan perintah berikut:

   $extensionName = "AzureMonitorWindowsAgent"
   $extensionType = "AzureMonitorWindowsAgent"
   $extensionPublisher = "Microsoft.Azure.Monitor"
   
   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
   
       Write-Output ("Installing Extension '${extensionType}/${extensionPublisher}' on cluster ${clusterName}")
   
       New-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default" `
           -Name "${extensionName}" `
           -ExtensionParameterPublisher "${extensionPublisher}" `
           -ExtensionParameterType "${extensionType}"
   }
   

4. Untuk menginstal ekstensi Azure Site Recovery pada semua kluster di bawah grup sumber daya, buat file parameter JSON lalu jalankan perintah berikut:

   $settings = @{
       SubscriptionId = "<Replace with your Subscription Id>"
       Environment = "<Replace with the cloud environment type. For example: AzureCloud>"
       ResourceGroup = "<Replace with your Site Recovery Vault resource group>"
       ResourceName = "<Replace with your Site Recovery Vault Name>"
       Location = "<Replace with your Site Recovery Azure Region>"
       SiteId = "<Replace with the ID of your recovery site>"
       SiteName = "<Replace with your recovery site name>"
       PolicyId = "<Replace with resource ID of your recovery site policy>"
       PrivateEndpointStateForSiteRecovery = "None"
   }
   
   $extensionName = "ASRExtension"
   $extensionType = "Windows"
   $extensionPublisher = "Microsoft.SiteRecovery.Dra"
   
   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
   
       Write-Output ("Installing Extension '${extensionType}/${extensionPublisher}' on cluster ${clusterName}")
   
       New-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default" `
           -Name "${extensionName}" `
           -ExtensionParameterPublisher "${extensionPublisher}" `
           -ExtensionParameterType "${extensionType}" `
           -ExtensionParameterSetting ${settings} `
           -NoWait
   }
   

Periksa status ekstensi

Portal Azure

Anda dapat memeriksa status ekstensi di setiap server dari halaman Ekstensi dengan melihat kolom status kisi.

Azure CLI

Azure CLI tersedia untuk diinstal di lingkungan Windows, macOS, dan Linux. Ini juga dapat dijalankan di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Azure Cloud Shell.

Luncurkan Azure Cloud Shell dan gunakan Bash untuk memeriksa status ekstensi dengan mengikuti langkah-langkah berikut:

1. Menyiapkan parameter dari langganan, grup sumber daya, nama kluster, dan nama ekstensi Anda

   subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   resourceGroup="hcicluster-rg" # Replace with your resource group name
   clusterName="HCICluster" # Replace with your cluster name
   extensionName="AzureMonitorWindowsAgent" # Replace with the extension name
   
   az account set --subscription "${subscription}"
   

2. Untuk mencantumkan semua ekstensi pada kluster, jalankan perintah berikut:

   az stack-hci extension list \
   --arc-setting-name "default" \
   --cluster-name "${clusterName}" \
   --resource-group "${resourceGroup}" \
   -o table
   

3. Untuk memfilter ekstensi tertentu seperti AzureMonitorWindowsAgent, jalankan perintah berikut:

   az stack-hci extension list \
   --arc-setting-name "default" \
   --cluster-name "${clusterName}" \
   --resource-group "${resourceGroup}" \
   --query "[?name=='${extensionName}'].{Name:name, ManagedBy:managedBy, ProvisionStatus:provisioningState, State:aggregateState, Type:extensionParameters.type}" \
   -o table
   

Azure PowerShell

Azure PowerShell dapat dijalankan di Azure Cloud Shell. Dokumen ini merinci cara menggunakan PowerShell di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Azure Cloud Shell.

Luncurkan Azure Cloud Shell dan gunakan PowerShell untuk memeriksa status ekstensi dengan mengikuti langkah-langkah berikut:

1. Menyiapkan parameter dari langganan, grup sumber daya, dan nama kluster Anda

   $subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   $resourceGroup = "hcicluster-rg" # Replace with your resource group name
   
   Set-AzContext -Subscription "${subscription}"
   $clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name
   

2. Untuk mencantumkan semua ekstensi pada kluster, jalankan perintah berikut:

   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
       Get-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default"|Format-Table -Property Name, ParameterType, ParameterPublisher, ParameterEnableAutomaticUpgrade, ProvisioningState
   }
   

Cara kerja peningkatan ekstensi

Saat diterbitkan oleh tim penerbit ekstensi, proses peningkatan ekstensi menggantikan versi ekstensi yang ada dengan yang baru didukung. Secara default, fitur peningkatan ekstensi otomatis diaktifkan untuk semua ekstensi yang disebarkan pada kluster berkemampuan Azure Stack HCI Arc kecuali Anda secara eksplisit menolak peningkatan otomatis.

Saat ini, peningkatan ekstensi otomatis hanya didukung di ekstensi Windows Admin Center, tetapi lebih banyak ekstensi akan ditambahkan di masa mendatang.

Catatan

Secara default, semua ekstensi disiapkan untuk mengaktifkan peningkatan otomatis, bahkan jika ekstensi tidak mendukung peningkatan ekstensi otomatis. Namun, pengaturan default ini tidak berpengaruh sampai penerbit ekstensi memilih untuk mendukung peningkatan ekstensi otomatis.

Aktifkan peningkatan ekstensi otomatis

Portal Azure

Untuk beberapa ekstensi, Anda dapat mengaktifkan peningkatan otomatis melalui manajemen ekstensi.

Untuk mengaktifkan peningkatan otomatis, navigasikan ke halaman Ekstensi dan lakukan langkah-langkah berikut:

1. Pilih ekstensi yang ingin Anda aktifkan pemutakhiran otomatisnya.

2. Pilih Aktifkan peningkatan otomatis dari menu atas

   

3. Ketika diminta untuk mengonfirmasi niat Anda, pilih OK.

   

Azure CLI

Untuk menginstal dan mengaktifkan peningkatan otomatis untuk ekstensi tertentu seperti AzureMonitorWindowsAgent jalankan perintah berikut:

clusterName="HCICluster" # Replace with your cluster name
resourceGroup="hcicluster-rg" # Replace with your resource group name

extensionName="AzureMonitorWindowsAgent"
extensionPublisher="Microsoft.Azure.Monitor"
extensionType="AzureMonitorWindowsAgent"

az stack-hci extension create \
    --name "${extensionName}" \
    --arc-setting-name "default" \
    --cluster-name "${clusterName}" \
    --resource-group "${resourceGroup}" \
    --publisher ${extensionPublisher} \
    --type ${extensionType} \
    --auto-upgrade "true"

Azure PowerShell

Untuk menginstal dan mengaktifkan peningkatan otomatis untuk ekstensi tertentu seperti AzureMonitorWindowsAgent jalankan perintah berikut:

$clusterName = "HCICluster" # Replace with your cluster name
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

$extensionName = "AzureMonitorWindowsAgent"
$extensionType = "AzureMonitorWindowsAgent"
$extensionPublisher = "Microsoft.Azure.Monitor"

New-AzStackHciExtension `
    -ClusterName "${clusterName}" `
    -ResourceGroupName "${resourceGroup}" `
    -ArcSettingName "default" `
    -Name "${extensionName}" `
    -ExtensionParameterPublisher "${extensionPublisher}" `
    -ExtensionParameterType "${extensionType}" `
    -ExtensionParameterEnableAutomaticUpgrade

Peningkatan ekstensi manual melalui portal Azure

Peningkatan ekstensi manual berfungsi seperti peningkatan ekstensi Otomatis. Pada kluster dengan dukungan Azure Stack HCI Arc, saat Anda meningkatkan ekstensi secara manual, Azure menyimpan versi yang telah Anda pilih. Azure kemudian mencoba meningkatkan ekstensi di semua server dalam kluster ke versi tersebut.

Di beberapa server, jika peningkatan ekstensi gagal platform mencoba meningkatkan ke versi yang dipilih selama sinkronisasi cloud Azure Stack HCI berikutnya.

Gunakan alur kerja manual dalam skenario ini:

• Versi baru ekstensi tersedia dan Anda ingin meningkatkannya secara manual.

• Opsi peningkatan otomatis ekstensi dinonaktifkan dan ada ketidakcocokan versi di berbagai server kluster Azure Stack HCI.

Untuk meningkatkan ekstensi secara manual, ikuti langkah-langkah berikut:

1. Buka halaman Ekstensi .

2. Pilih ekstensi yang ingin Anda tingkatkan dan pilih Pengaturan dari menu atas.

   

3. Pilih versi terbaru dan pilih Simpan.

Menonaktifkan peningkatan ekstensi otomatis

Anda dapat menonaktifkan peningkatan otomatis untuk ekstensi tertentu di portal Azure. Untuk menonaktifkan peningkatan otomatis, navigasikan ke halaman Ekstensi dan lakukan langkah-langkah berikut:

1. Pilih ekstensi yang ingin Anda nonaktifkan peningkatan otomatisnya.

2. Pilih Nonaktifkan peningkatan otomatis dari menu atas.

   

3. Ketika diminta untuk mengonfirmasi niat Anda, pilih OK.

   

Periksa riwayat peningkatan ekstensi

Anda dapat melihat tab Log Aktivitas pada sumber daya server, grup sumber daya, dan langganan dengan dukungan Azure Arc individual untuk memeriksa riwayat peningkatan ekstensi otomatis untuk server kluster individual. Untuk informasi selengkapnya, lihat Memeriksa riwayat peningkatan ekstensi otomatis.

Pembaruan ketersediaan pertama

Untuk sekelompok kluster berkemampuan Azure Stack HCI Arc yang mengalami peningkatan, platform Azure menggunakan model peningkatan ekstensi Otomatis untuk mengatur peningkatan.

Waktu peningkatan ekstensi otomatis

Saat versi baru ekstensi yang didukung diterbitkan, ekstensi tersebut tersedia untuk penginstalan dan peningkatan manual di server yang diaktifkan Azure Arc. Peningkatan dikeluarkan dalam batch di seluruh wilayah dan langganan Azure, sehingga Anda mungkin melihat peningkatan ekstensi terjadi di beberapa server sebelum yang lain. Untuk informasi selengkapnya, lihat Pengaturan waktu peningkatan ekstensi otomatis.

Untuk segera meningkatkan ekstensi, lihat Peningkatan ekstensi manual melalui portal Azure.

Putar kembali dan coba lagi otomatis

Jika peningkatan ekstensi gagal, Azure melakukan tindakan yang terkait dengan Putar kembali otomatis dan coba lagi dalam upaya untuk memperbaiki ekstensi.

Jika Anda terus mengalami masalah dengan peningkatan ekstensi, Anda dapat menonaktifkan peningkatan ekstensi otomatis. Saat Anda menonaktifkan peningkatan otomatis, ini mencegah sistem mencoba kembali saat Anda memecahkan masalah. Anda dapat mengaktifkan peningkatan ekstensi otomatis lagi saat Anda siap.

Peningkatan dengan beberapa ekstensi

Jika beberapa peningkatan ekstensi tersedia untuk komputer, mereka mungkin di-batch bersama-sama. Namun, setiap peningkatan ekstensi diterapkan satu per satu pada komputer. Untuk informasi selengkapnya, lihat Peningkatan ekstensi dengan beberapa ekstensi.

Menghapus instalan ekstensi

Portal Azure

Jika diinginkan, Anda dapat menghapus instalan beberapa ekstensi dari kluster Azure Stack HCI di portal Azure. Untuk menghapus instalan ekstensi, gunakan langkah-langkah berikut:

1. Buka halaman Ekstensi.

2. Pilih ekstensi yang ingin Anda hapus instalannya. Tombol hapus instalan tidak tersedia untuk ekstensi yang dikelola Azure.

   

3. Pilih Hapus instalan dari menu atas.

4. Konfirmasi niat dan pilih Ya.

   

Azure CLI

Untuk menghapus ekstensi tertentu seperti AzureMonitorWindowsAgent jalankan perintah berikut:

extensionName="AzureMonitorWindowsAgent" # Replace with the extension name
resourceGroup="hcicluster-rg" # Replace with your resource group name
clusterName="HCICluster" # Replace with your cluster name

az stack-hci extension delete \
--arc-setting-name "default" \
--name "${extensionName}" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}"

Azure PowerShell

Untuk menghapus ekstensi tertentu seperti AzureMonitorWindowsAgent jalankan perintah berikut:

$clusterName = "HCICluster" # Replace with your cluster name
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

$extensionName = "AzureMonitorWindowsAgent"

Remove-AzStackHciExtension `
    -ClusterName "${clusterName}" `
    -ResourceGroupName "${resourceGroup}" `
    -ArcSettingName "default" `
    -Name "${extensionName}"

Memecahkan masalah kesalahan ekstensi

Status Ekstensi: Gagal

Rekomendasi: Untuk ekstensi dengan status gagal, pilih tautan Gagal (Lihat detail). Lihat semua informasi tentang kegagalan dan terapkan tips pemecahan masalah.

Langkah selanjutnya

Pelajari tentang Manajemen ekstensi komputer virtual dengan server dengan dukungan Azure Arc.