Memecahkan masalah Azure Local Virtual Machines yang diaktifkan oleh Azure Arc

2025-07-07

Berlaku untuk: Azure Local 2311.2 dan yang lebih baru

Artikel ini menjelaskan cara mengumpulkan log dan memecahkan masalah dengan Azure Local Virtual Machines (VM) yang diaktifkan oleh Azure Arc. Ini juga mencantumkan batasan saat ini dan masalah yang diketahui dengan manajemen Azure Local VM, bersama dengan resolusi yang direkomendasikan.

Properti tidak didukung untuk operasi ini

Kesalahan:

Property '<Property Name>' isn't supported for this operation on your Azure Local cluster version. Please update your cluster if you want to set this property for this operation. Please view aka.ms/hciproperties.

Sebab:

Kesalahan ini terjadi saat fitur yang Anda coba gunakan tidak tersedia untuk versi perangkat lunak yang berjalan di instans Azure Local Anda. Ini dapat terjadi jika versi perangkat lunak pada kluster Anda kedaluarsa atau fitur diperkenalkan di versi yang lebih baru.

Resolusi:

Untuk mengatasi masalah ini, perbarui instans Azure Local Anda ke versi terbaru. Untuk informasi selengkapnya, lihat Memperbarui melalui PowerShell atau Memperbarui melalui portal Microsoft Azure.

Ekstensi kluster tidak mendukung jenis sumber daya

Kesalahan:

The cluster extension '<Cluster Extension Azure Resource Manager ID>' doesn't support resource type 'Microsoft.AzureStackHCI/<Resource Type>'. The currently enabled resource types are '<Supported Resource Type Names>'. Please ensure the 'Microsoft.AzureStackHCI' cluster extension version metadata file supports the resource type. [ClusterExtensionVersion='<Cluster Extension Version>'] [CorrelationId='<Correlation ID>'].

Sebab:

Resolusi:

Untuk mengatasi masalah ini, perbarui instans Azure Local Anda ke versi terbaru. Untuk informasi selengkapnya, lihat Memperbarui melalui PowerShell atau Memperbarui melalui portal Microsoft Azure.

Tidak dapat memilih gambar untuk VM peluncuran tepercaya

Peluncuran tepercaya untuk Azure Local VM saat ini hanya mendukung sekumpulan gambar Marketplace Azure tertentu. Untuk daftar gambar yang didukung, lihat Gambar sistem operasi tamu. Saat Anda membuat VM peluncuran Tepercaya di portal Microsoft Azure, daftar dropdown Gambar hanya memperlihatkan gambar yang didukung oleh Peluncuran tepercaya. Dropdown Gambar tampak kosong jika Anda memilih gambar yang tidak didukung, termasuk gambar kustom. Daftar juga tampak kosong jika tidak ada gambar yang tersedia di sistem Azure Local Anda yang didukung oleh Peluncuran tepercaya.

Kegagalan saat mencoba mengaktifkan manajemen tamu

Saat mencoba menjalankan perintah untuk mengaktifkan manajemen tamu, Anda akan melihat kesalahan berikut:

Kesalahan:Deployment failed. Correlation ID: aaaa0000-bb11-2222-33cc-444444dddddd. VM Spec validation failed for guest agent provisioning: Invalid managed identity. A system-assigned managed identity must be enabled in parent resource: Invalid Configuration

Kegagalan ini karena identitas terkelola tidak dibuat untuk VM ini. Identitas Terkelola yang ditetapkan sistem diperlukan untuk mengaktifkan manajemen tamu.

Resolusi:

Ikuti langkah-langkah ini untuk memverifikasi bahwa Identitas Terkelola tidak dibuat untuk VM ini lalu aktifkan Identitas Terkelola yang ditetapkan sistem.

Di portal Azure, buka VM. Telusuri ke halaman Gambaran Umum . Pada tab Properti , di bawah Konfigurasi, manajemen Tamu harus ditampilkan sebagai Dinonaktifkan. Pilih Tampilan JSON dari sudut kanan atas.
Parameter Identity, type harus ditampilkan sebagai None.
Untuk membuat identitas terkelola, sambungkan ke komputer Azure Local melalui Remote Desktop Protocol (RDP). Jalankan perintah berikut:
```
az extension add --name connectedmachine
```

Verifikasi bahwa ekstensi CLI komputer yang terhubung diinstal pada sistem. Berikut adalah contoh output dengan ekstensi yang berhasil diinstal. connectedmachine menunjukkan bahwa versi 0.7.0 diinstal.

[v-hostl]: PS C:\Clusterstorage\lnfrastructure_l\ArcHci> az version
{
"azure-cli": "2.53.0",
"azure-cli-core": "2.53.0",
"azure-cli-telemetry": "1.1.0",
"extensions": {
    "akshybrid": "0.1.1",
    "arcappliance"^ "1.0.2",
    "connectedk8s": "1.5.4",
    "connectedmachine": "0.7.0",
    "customlocation": "0.1.3",
    "hybridaks": "0.2.4",
    "k8s-extension": "1.4.5",
    "stack-hci-vm": "0.1.8"
    }
}
[v-hostl]: PS C:\ClusterStorage\Infrastructure_l\ArcHci>
    ```

Jalankan perintah berikut untuk menetapkan identitas terkelola sistem ke VM.

az connectedmachine update --ids "<Resource Manager ID for the VM>" --set identity.type="SystemAssigned"

Buka portal Microsoft Azure dan telusuri ke halaman Gambaran Umum . Tampilan JSON harus menunjukkan bahwa identitas terkelola sistem sekarang ditetapkan ke VM.

Kegagalan menyebarkan gambar VM dari akun penyimpanan

Anda melihat kesalahan berikut saat mencoba menyebarkan gambar VM dari akun penyimpanan di Azure Local Anda:

Kesalahan:{"code":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=AuthorizationPermissionMismatch) =====\nDescription=, Details: (none)\n","message":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=AuthorizationPermissionMismatch) =====\nDescription=, Details: (none)\n"}

Atau, Anda akan melihat kesalahan ini:

Kesalahan:{"code":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=NoAuthenticationInformation) =====\nDescription=, Details: (none)\n","message":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=NoAuthenticationInformation) =====\nDescription=, Details: (none)\n"}

Kegagalan terjadi karena pengguna yang membuat gambar tidak memiliki izin yang tepat untuk mengakses gambar dari akun penyimpanan. Pengguna harus memiliki peran Storage Blob Data Contributor pada akun penyimpanan yang digunakan untuk citra tersebut. Untuk informasi selengkapnya, lihat Menetapkan peran Azure untuk akses ke data blob.

Resolusi:

Tambahkan peran Kontributor Data Blob Penyimpanan kepada pengguna yang perlu membuat gambar dari akun penyimpanan ini. Setelah peran ditambahkan, coba lagi menyebarkan gambar.

Anda mungkin juga melihat kesalahan berikut saat mencoba menyebarkan gambar VM dari akun penyimpanan:

Kesalahan:{"code":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=InvalidBlobType) =====\nDescription=The blob type is invalid for this operation.\nRequestId:5e74055f-e01e-0033-66eb-ff9734000000\nTime:2024-09-05T23:32:56.3001852Z, Details: (none)\n","message":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=InvalidBlobType) =====\nDescription=The blob type is invalid for this operation.\nRequestId:5e74055f-e01e-0033-66eb-ff9734000000\nTime:2024-09-05T23:32:56.3001852Z, Details: (none)\n","additionalInfo":[{"type":"ErrorInfo","info":{"category":"Uncategorized","recommendedAction":"","troubleshootingURL":""}}]}

Kegagalan ini karena jenis blob tidak benar dalam akun penyimpanan. Gambar harus berjenis page blob .

Resolusi:

Unggah gambar ke akun penyimpanan Anda di page blob format dan coba lagi menerapkan gambar tersebut.

Pastikan bahwa pengguna memiliki izin yang tepat, dan blob dalam format yang benar. Untuk informasi selengkapnya, lihat Menambahkan gambar VM dari akun Azure Storage.

Kegagalan untuk menyebarkan Azure Local VM

Anda melihat kesalahan berikut saat mencoba menyebarkan Azure Local VM:

Kesalahan:{"code":"ConflictingOperation","message":"Unable to process request 'Microsoft.AzureStackHCI/virtualMachineInstances'. There is already a previous running operation for resource '/subscriptions/<subscription ID>/resourceGroups/<Resource group name>/providers/Microsoft.HybridCompute/machines/<VM name>/providers/Microsoft.AzureStackHCI/virtualMachineInstances/default'. Please wait for the previous operation to complete."}

Kegagalan ini terjadi karena objek identitas terkelola SystemAssigned tidak berada di jenis sumber daya Microsoft.HybridCompute/machines.

Resolusi:

Verifikasi di templat penyebaran Anda bahwa:

Objek identitas terkelola SystemAssigned berada di bawah Microsoft.HybridCompute/machines jenis sumber daya dan bukan di bawah Microsoft.AzureStackHCI/VirtualMachineInstances jenis sumber daya.

Templat penyebaran harus cocok dengan templat sampel yang disediakan. Untuk informasi selengkapnya, lihat templat sampel di Membuat komputer virtual Azure Local yang diaktifkan oleh Azure Arc.

Penginstalan Azure CLI tidak dikenali

Jika lingkungan Anda gagal mengenali Azure CLI setelah menginstalnya, jalankan blok kode berikut untuk menambahkan jalur penginstalan Azure CLI ke jalur lingkungan.

        if ( -not( $env:PATH -like '*C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin*') ) {
            $env:PATH += "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin;"
            Write-Host "Updated path $env:PATH"
        }

Pesan "Windows membuat file halaman sementara" muncul saat startup

Kesalahan:

Saat Anda menyebarkan Komputer Virtual Lokal Azure menggunakan SQL Server 2022 pada gambar marketplace Azure Windows Server 2022 (Standar atau Perusahaan), Anda mungkin melihat peringatan berikut saat startup:

Windows membuat berkas halaman sementara...

Resolusi:

Untuk mengatasi masalah ini, ikuti langkah-langkah berikut:

Pilih OK pada popup peringatan. Atau, buka Properti Sistem>, kemudian buka Tingkat Lanjut>Performa>Pengaturan untuk membuka jendela Opsi Performa.
Di jendela Opsi Performa , pilih Ubah di bawah bagian Memori virtual .
Di jendela Memori Virtual , pilih Ukuran terkelola sistem.  Pastikan juga bahwa kotak centang Kelola ukuran file halaman secara otomatis untuk semua drive tidak dicentang.
Pilih Atur, lalu pilih OK untuk menerapkan perubahan.
Hidupkan ulang VM. Setelah menghidupkan ulang, pesan peringatan seharusnya tidak lagi muncul.