Manajemen ekstensi Azure Arc di Azure Local

Artikel
03/09/2025

Berlaku untuk: Azure Local 2311.2 dan yang lebih baru

Artikel ini menjelaskan cara menginstal, meningkatkan, dan mengelola ekstensi Azure Arc di Azure Local.

Ekstensi Azure Arc yang dikelola pelanggan di Azure Local

Anda dapat menginstal, menghapus instalan, dan memperbarui ekstensi Azure Arc di Azure Local Anda. Azure Arc memungkinkan Anda menjalankan layanan hibrid seperti pemantauan dan Pusat Admin Windows di portal Azure.

Berikut adalah ekstensi individual yang dapat Anda instal dan kelola.

Ekstensi yang dikelola Azure di Azure Local

Setelah Anda berhasil mendaftarkan Azure Local baru Anda dengan Azure, ekstensi yang dikelola Azure secara otomatis diinstal pada sistem 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 Azure Local 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:

Menginstal ekstensi

Anda dapat menginstal ekstensi dari tab Kemampuan untuk server dengan dukungan Azure Local 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 diinstal pada semua simpul sistem. Jika Anda menambahkan lebih banyak simpul ke sistem Anda, semua ekstensi yang diinstal pada sistem 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 Panduan Cepat untuk Azure Cloud Shell.

Luncurkan Azure Cloud Shell dan gunakan Bash 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

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 Pusat Admin Windows pada semua sistem 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 sistem 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 sistem 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 Panduan 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 Pusat Admin Windows pada semua sistem 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
}

Untuk menginstal ekstensi Agen Azure Monitor pada semua sistem 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}"
}

Untuk menginstal ekstensi Azure Site Recovery pada semua sistem 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

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

Azure CLI tersedia untuk diinstal di lingkungan Windows, macOS, dan Linux. Ini juga dapat dijalankan di Azure Cloud Shell. Untuk informasi selengkapnya, rujuklah ke Panduan Memulai dengan 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 sistem, 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:

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 dapat dijalankan di Azure Cloud Shell. Dokumen ini merinci cara menggunakan PowerShell di Azure Cloud Shell. Untuk informasi selengkapnya, lihatlah Panduan Memulai 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 sistem, 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 dari proses 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 dengan dukungan Azure Local Arc kecuali Anda secara eksplisit menolak peningkatan otomatis.

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

Catatan

Secara default, semua ekstensi disiapkan untuk mengaktifkan peningkatan otomatis, tetapi pengaturan ini hanya berfungsi jika penerbit mendukungnya. Jika ekstensi tidak disiapkan untuk mengaktifkan peningkatan otomatis, peningkatan terjadi selama proses pembaruan solusi. Seiring waktu, peningkatan ekstensi manual akan beralih ke peningkatan otomatis.

Aktifkan 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 peningkatan 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 Local Arc, saat Anda meningkatkan ekstensi secara manual, Azure menyimpan versi yang Telah Anda pilih. Azure kemudian mencoba meningkatkan ekstensi pada semua simpul dalam kluster ke versi tersebut.

Di beberapa server, jika peningkatan ekstensi gagal, platform akan mencoba meningkatkan ke versi yang dipilih selama sinkronisasi cloud lokal Azure 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 simpul Azure Local.

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.

Nonaktifkan 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 yang didukung Azure Arc individual untuk memeriksa riwayat peningkatan ekstensi otomatis untuk simpul individual. Untuk informasi selengkapnya, lihat Memeriksa riwayat peningkatan ekstensi otomatis.

Pembaruan dengan Prioritas Ketersediaan

Untuk sekelompok kluster dengan dukungan Azure Local 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 akan tersedia untuk penginstalan dan peningkatan manual di server dengan dukungan 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 Waktu pembaruan otomatis ekstensi.

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 pengulangan otomatis dan percobaan ulang dalam usaha untuk memperbaiki ekstensi.

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

Pembaruan dengan beberapa ekstensi

Jika ada beberapa peningkatan ekstensi yang tersedia untuk simpul, peningkatan tersebut mungkin dikelompokkan bersama. Namun, setiap peningkatan ekstensi diterapkan satu per satu pada simpul. Untuk informasi selengkapnya, lihat Peningkatan ekstensi dengan beberapa ekstensi.

Hapus ekstensi

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

Buka halaman Ekstensi.
Pilih ekstensi yang ingin Anda hapus instalasinya. 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.

Langkah selanjutnya

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

Bagikan melalui