Mengaktifkan ekstensi VM Arc dengan menggunakan Azure CLI (Windows dan Linux)

Artikel ini menjelaskan cara menyebarkan, meningkatkan, memperbarui, dan menghapus instalan ekstensi komputer virtual (VM) di server yang didukung Azure Arc dengan menggunakan Azure CLI (Windows atau Linux).

Prasyarat penyebaran ekstensi

Tinjau dokumentasi untuk setiap ekstensi VM yang direferensikan dalam tabel ekstensi untuk memahami persyaratan jaringan dan sistemnya di luar prasyarat umum dan persyaratan jaringan server berkemampuan Arc untuk server berkemampuan Arc. Upaya ini dapat membantu mencegah masalah konektivitas dengan layanan atau fitur Azure yang bergantung pada ekstensi VM tersebut.

Untuk menyebarkan ekstensi ke server dengan dukungan Azure Arc, pengguna memerlukan izin berikut:

  • microsoft.hybridcompute/machines/read
  • microsoft.hybridcompute/machines/extensions/read
  • microsoft.hybridcompute/machines/extensions/write

Peran Azure Connected Machine Resource Administrator mencakup izin yang diperlukan untuk mengimplementasikan ekstensi. Ini juga mencakup izin untuk menghapus sumber daya server dengan dukungan Azure Arc.

Server berkemampuan Azure Arc dengan satu atau beberapa ekstensi VM yang diinstal dapat dipindahkan antar grup sumber daya, atau ke langganan Azure lain, tanpa mengalami dampak apa pun terhadap konfigurasinya. Ruang lingkup sumber dan tujuan harus ada dalam penyewa Microsoft Entra yang sama. Untuk informasi selengkapnya tentang memindahkan sumber daya dan pertimbangan sebelum melanjutkan, lihat Memindahkan sumber daya ke grup sumber daya atau langganan baru.

Prasyarat

Menginstal ekstensi Connected Machine di Azure CLI

Perintah ConnectedMachine tidak dikirim sebagai bagian dari Azure CLI (Windows atau Linux). Sebelum Anda menggunakan Azure CLI (Windows atau Linux) untuk menyambungkan ke Azure dan mengelola ekstensi VM di server berkemampuan Arc, Anda perlu memuat ConnectedMachine ekstensi.

Anda dapat melakukan operasi manajemen ini dari stasiun kerja Anda, bukan di server dengan dukungan Azure Arc.

Jalankan perintah berikut untuk menginstal ekstensi Azure CLI ConnectedMachine :

az extension add --name connectedmachine

Aktifkan ekstensi

Untuk mengaktifkan ekstensi VM di server Azure Arc Anda, gunakan az connectedmachine extension create dengan parameter --machine-name, --extension-name, --location, --type, settings, dan --publisher. Anda dapat melihat nilai parameter dan instruksi penyebaran, OS yang didukung, atau informasi tambahan untuk setiap ekstensi VM di tabel ekstensi Windows atau Linux yang sesuai.

Contoh ini memungkinkan Ekstensi Skrip Kustom di server dengan dukungan Azure Arc:

az connectedmachine extension create --machine-name "myMachineName" --name "CustomScriptExtension" --location "regionName" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -gt 10000 }\\\"\"}" --type-handler-version "1.10" --resource-group "myResourceGroup"

Contoh ini memungkinkan ekstensi VM Azure Key Vault di server dengan dukungan Azure Arc:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Microsoft.Azure.KeyVault" --type "KeyVaultForLinux or KeyVaultForWindows" --name "KeyVaultForLinux or KeyVaultForWindows" --settings '{"secretsManagementSettings": { "pollingIntervalInS": "60", "observedCertificates": ["observedCert1"] }, "authenticationSettings": { "msiEndpoint": "http://localhost:40342/metadata/identity" }}'

Contoh ini memungkinkan ekstensi Microsoft Antimalware di server Windows dengan dukungan Azure Arc:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Microsoft.Azure.Security" --type "IaaSAntimalware" --name "IaaSAntimalware" --settings '"{\"AntimalwareEnabled\": \"true\"}"'

Contoh ini memungkinkan ekstensi Datadog di server Windows dengan dukungan Azure Arc:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Datadog.Agent" --type "DatadogWindowsAgent" --settings '{"site": "us3.datadoghq.com"}' --protected-settings '{"api_key": "YourDatadogAPIKey" }'

Petunjuk / Saran

Banyak ekstensi lain yang didukung di server dengan dukungan Arc. Untuk detailnya, lihat Manajemen ekstensi komputer virtual dengan server dengan dukungan Azure Arc.

Daftar ekstensi yang terpasang

Untuk mendapatkan daftar ekstensi VM di server berkemampuan Azure Arc Anda, gunakan az connectedmachine extension list dengan parameter --machine-name dan --resource-group.

az connectedmachine extension list --machine-name "myMachineName" --resource-group "myResourceGroup"

Secara default, output dari perintah Azure CLI ada di JavaScript Object Notation (JSON). Untuk mengubah keluaran default menjadi daftar atau tabel, misalnya, gunakan az config set core.output=table. Anda juga dapat menambahkan --output ke perintah apa pun untuk perubahan satu kali dalam format keluaran.

Contoh berikut menunjukkan output JSON parsial dari az connectedmachine extension -list perintah:

[
  {
    "autoUpgradingMinorVersion": "false",
    "forceUpdateTag": null,
    "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.HybridCompute/machines/SVR01/extensions/DependencyAgentWindows",
    "location": "regionName",
    "name": "DependencyAgentWindows",
    "namePropertiesInstanceViewName": "DependencyAgentWindows",

Memperbarui konfigurasi ekstensi

Beberapa ekstensi VM memerlukan pengaturan konfigurasi sehingga Anda dapat menginstalnya di server yang diaktifkan Azure Arc (seperti Ekstensi Skrip Kustom). Untuk meningkatkan konfigurasi ekstensi, gunakan az connectedmachine extension update.

Contoh berikut menunjukkan cara mengonfigurasi Ekstensi Skrip Kustom:

az connectedmachine extension update --name "CustomScriptExtension" --type "CustomScriptExtension" --publisher "Microsoft.HybridCompute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version "1.10" --machine-name "myMachine" --resource-group "myResourceGroup"

Tingkatkan ekstensi

Ketika versi baru dari ekstensi VM yang didukung dirilis, Anda dapat memperbaruinya ke rilis terbaru tersebut. Untuk meningkatkan ekstensi VM, gunakan az connectedmachine upgrade-extension dengan parameter --machine-name, --resource-group, dan --extension-targets.

Untuk parameter --extension-targets, Anda perlu menentukan ekstensi dan versi terbaru yang tersedia. Untuk menentukan versi terbaru yang tersedia untuk sebuah ekstensi, buka halaman Ekstensi untuk server yang dipilih yang diaktifkan Azure Arc di portal Azure atau jalankan az vm extension image list. Anda dapat menentukan beberapa ekstensi dalam satu permintaan peningkatan dengan menyediakan keduanya:

  • Daftar ekstensi yang dipisahkan koma, yang ditentukan oleh penerbit dan jenisnya (dipisahkan oleh titik)
  • Versi target untuk setiap ekstensi

Anda dapat meninjau versi ekstensi VM yang terpasang kapan saja dengan menjalankan perintah az connectedmachine extension list. Nilai properti typeHandlerVersion mewakili versi ekstensi.

Petunjuk / Saran

Banyak ekstensi VM dapat dikonfigurasi untuk peningkatan otomatis.

Menghapus ekstensi

Untuk menghapus ekstensi VM yang diinstal dari server yang diaktifkan Azure Arc Anda, gunakan az connectedmachine extension delete dengan parameter --extension-name, --machine-name, dan --resource-group.

Konten terkait

  • Terakhir diperbarui pada