Bagikan melalui

Panduan pemecahan masalah untuk masalah di AKS yang diaktifkan oleh Azure Arc di VMware

  • Artikel

Berlaku untuk: AKS yang diaktifkan oleh Azure Arc di VMware (pratinjau)

Artikel ini menguraikan langkah-langkah pemecahan masalah untuk masalah dan kesalahan yang diketahui yang dapat terjadi saat menyebarkan AKS yang diaktifkan oleh Azure Arc pada pratinjau VMware. Anda juga dapat meninjau masalah yang diketahui di sini atau mengikuti gambaran umum pemecahan masalah untuk melaporkan bug atau memberikan umpan balik produk.

Halaman ini terus diperbarui, jadi periksa kembali di sini untuk informasi baru. Saat kami mengidentifikasi masalah penting yang memerlukan solusi, kami menambahkannya. Harap tinjau informasi ini dengan cermat sebelum menyebarkan AKS Arc Anda pada pratinjau VMware.

Jembatan Sumber Daya Arc

Masalah jembatan sumber daya Azure Arc

Untuk masalah jembatan sumber daya Azure Arc, lihat panduan pemecahan masalah di sini.

Pulihkan dari penyebaran Arc Resource Bridge yang gagal

Lihat panduan pemecahan masalah di sini.

Koneksi vCenter Server ke Azure

Jika ada pesan kesalahan yang menyatakan "Nama> jembatan sumber daya jembatan <sumber daya yang terkait dengan vCenter Server ini saat ini tidak tersedia. Operasi yang dilakukan pada vCenter Server ini mungkin gagal sebagai akibatnya," ini menunjukkan bahwa jembatan sumber daya yang digunakan untuk menyambungkan vCenter Server tidak berfungsi atau dihapus.

Untuk mengatasi masalah ini, ikuti langkah-langkah berikut:

Mengumpulkan log

Jika mengalami masalah, Anda dapat berbagi file log dan versi CLI dengan teknisi dukungan untuk tujuan penelusuran kesalahan.

Masalah sebelum penyebaran Arc Resource Bridge

Ambil file kva.log dari sistem di c:\programdata\kva\kva.log untuk informasi verbose lainnya.

Masalah selama penyebaran Arc Resource Bridge

Untuk mengumpulkan log, jalankan perintah berikut dari komputer yang sebelumnya Anda gunakan untuk mencoba penyebaran jembatan sumber daya Arc. Dimulai dengan CLI versi 1.0.0, Anda harus terlebih dahulu menjalankan perintah az arcappliance get-credentials. Ini memastikan bahwa semua kredensial yang diperlukan untuk pengumpulan log ditarik ke komputer. Untuk informasi selengkapnya tentang perintah ini, lihat dokumentasi CLI:

az arcappliance get-credentials –name <name of Arc Resource Bridge> --resource-group <name of resource group>

Setelah menjalankan az arcappliance get-credentials perintah, Anda dapat melanjutkan pengumpulan az arcappliance logs vmware log menggunakan perintah :

az arcappliance logs vmware --ip <Arc Resource Bridge VM control plane IP endpoint> --address <vCenter FQDN/IP address, same one used when creating config files> --username <vcenter username> --password <vcenter password>

Jika Anda belum membuat VM appliance, az arcappliance logs vmware perintah tidak berguna, dan file kunci log tidak dihasilkan.

Masalah saat Arc Resource Bridge aktif dan berjalan

Untuk mengumpulkan log, jalankan az arcappliance logs vmware perintah dari komputer yang sama dengan yang Anda gunakan untuk menyebarkan Arc Resource Bridge:

  • Jika Anda memiliki kubeconfig untuk appliance dan VM appliance berjalan dengan server API yang dapat dijangkau, perintah berikut mengumpulkan log dari appliance dan menghasilkan file .zip di direktori kerja saat ini:

    az arcappliance logs vmware --kubeconfig='<path to your kubeconfig>'

  • Jika Anda tidak memiliki kubeconfig atau server API Anda tidak dapat dijangkau, perintah berikut mengumpulkan log menggunakan alamat IP VM appliance yang ditentukan (periksa kain virtualisasi Anda; misalnya, manajer Hyper-V, untuk menemukan alamat IP VM appliance). Perhatikan bahwa kubeconfig parameter masih diperlukan tetapi dapat diteruskan sebagai string kosong jika IP juga disediakan:

    az arcappliance logs vmware --kubeconfig='' --ip='<IP address of Arc Resource Bridge VM>'

Contoh dengan nilai yang diisi

az arcappliance logs vmware --kubeconfig .\resourcebridge\kubeconfig
az arcappliance logs vmware --kubeconfig='kubeconfig'
az arcappliance logs vmware --kubeconfig='' --ip=10.0.1.166

Mendapatkan versi ekstensi CLI

Anda dapat mengembalikan versi ekstensi CLI appliance dengan menjalankan perintah berikut:

az extension show --name arcappliance -o table

Anda harus memiliki versi terbaru Az CLI yang diinstal pada semua node di kluster fisik Anda.

  • Verifikasi bahwa Anda memiliki Az CLI dengan menjalankan az -v.
  • Tingkatkan ke versi terbaru dengan menjalankan az upgrade.

Pesan kesalahan dan langkah-langkah pemecahan masalah

Bagian ini menyediakan daftar pesan kesalahan umum dan langkah-langkah pemecahan masalahnya.

Kesalahan: "AlreadyDeployedError"

  • Akar penyebab: kesalahan ini terjadi karena lingkungan belum dibersihkan dari penyebaran sebelumnya sebelum mencoba menyebarkan lagi.
  • Resolusi: untuk mengatasi masalah ini, hapus instalan Arc Resource Bridge, lalu coba sebarkan lagi.

Kesalahan: x509: sertifikat telah kedaluwarsa atau belum valid: waktu <saat ini1> adalah sebelum <waktu2>. Pemeriksaan Gagal

  • Akar penyebab: kesalahan ini terjadi ketika sertifikat kedaluwarsa karena ketidakcocokan waktu antara komputer klien dan VM (atau server ESXi). Salah satunya tidak diaktifkan NTP.
  • Resolusi:
    1. Periksa apakah waktu pada VM cocok dengan waktu pada komputer yang Anda gunakan untuk penyebaran ARB.
    2. Sambungkan server ESXi ke server NTP untuk menyinkronkan waktunya dan menyelesaikan masalah.

Kesalahan: Istilah 'az' tidak dikenali sebagai nama cmdlet, fungsi, file skrip, atau program yang dapat dioperasikan. Periksa ejaan nama, atau jika jalur disertakan, verifikasi bahwa jalur sudah benar dan coba lagi

  • Akar penyebab: Az CLI tidak dikenali karena jendela PowerShell sebelumnya ditutup dan tidak disinkronkan dengan penginstalan Azure CLI.
  • Resolusi:
    1. Buka jendela PowerShell baru dan navigasikan ke folder tempat Anda menyimpan skrip onboarding Arc Resource Bridge.
    2. Jalankan .temp\.env\Scripts\Activate.ps1 untuk menginstal Python venv.

Langkah berikutnya