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.
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.
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 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:
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'))
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
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
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 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:
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
Untuk menginstal ekstensi Windows Admin Center pada semua kluster di bawah grup sumber daya, jalankan perintah berikut:
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
}
Anda dapat memeriksa status ekstensi di setiap server dari halaman Ekstensi dengan melihat kolom status kisi.
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:
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}"
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
Untuk memfilter ekstensi tertentu seperti AzureMonitorWindowsAgent, jalankan perintah berikut:
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:
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
Untuk mencantumkan semua ekstensi pada kluster, jalankan perintah berikut:
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.
Untuk beberapa ekstensi, Anda dapat mengaktifkan peningkatan otomatis melalui manajemen ekstensi.
Untuk mengaktifkan peningkatan otomatis, navigasikan ke halaman Ekstensi dan lakukan langkah-langkah berikut:
Pilih ekstensi yang ingin Anda aktifkan pemutakhiran otomatisnya.
Pilih Aktifkan peningkatan otomatis dari menu atas
Ketika diminta untuk mengonfirmasi niat Anda, pilih OK.
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"
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:
Buka halaman Ekstensi .
Pilih ekstensi yang ingin Anda tingkatkan dan pilih Pengaturan dari menu atas.
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:
Pilih ekstensi yang ingin Anda nonaktifkan peningkatan otomatisnya.
Pilih Nonaktifkan peningkatan otomatis dari menu atas.
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.
Jika peningkatan ekstensi gagal, Azure melakukan tindakan yang terkait dengan Putar kembali otomatis dan coba lagi dalam upaya untuk memperbaiki 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.
Jika diinginkan, Anda dapat menghapus instalan beberapa ekstensi dari kluster Azure Stack HCI di portal Azure. Untuk menghapus instalan ekstensi, gunakan langkah-langkah berikut:
Buka halaman Ekstensi.
Pilih ekstensi yang ingin Anda hapus instalannya. Tombol hapus instalan tidak tersedia untuk ekstensi yang dikelola Azure.
Pilih Hapus instalan dari menu atas.
Konfirmasi niat dan pilih Ya.
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}"
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.