Mengatasi kesalahan saat mengaktifkan atau menonaktifkan Azure Arc pada kluster beban kerja AKS Anda di AKS yang diaktifkan oleh Arc

Berlaku untuk: AKS di Azure Stack HCI, AKS di Windows Server

Artikel ini menjelaskan kesalahan yang mungkin Anda temui (dan solusinya) saat menyambungkan atau memutuskan kluster beban kerja AKS Anda ke Azure Arc menggunakan cmdlet PowerShell Enable-AksHciArcConnection dan Disable-AksHciArcConnection di AKS Arc. Untuk masalah yang tidak tercakup dalam artikel ini, lihat Pemecahan Masalah Kube yang diaktifkan Arc.

Anda juga dapat membuka masalah dukungan jika tidak ada solusi yang terdaftar di bawah ini yang berlaku untuk Anda.

Kesalahan: "Kluster beban kerja dengan nama 'my-aks-cluster' tidak ditemukan"

Kesalahan ini berarti Anda belum membuat kluster beban kerja, atau salah mengeja nama kluster beban kerja.

Jalankan Get-AksHciCluster untuk memastikan Anda memiliki nama yang benar atau bahwa kluster yang ingin Anda sambungkan ke Arc ada.

Kesalahan: "System.Management.Automation.RemoteException Memulai proses onboarding Kluster "azure-arc-onboarding" diatur..."

Kesalahan berikut dapat terjadi ketika Anda menggunakan Windows Admin Center untuk membuat kluster beban kerja dan menghubungkannya ke Kube yang didukung Arc:

System.Management.Automation.RemoteException Starting onboarding process Cluster "azure-arc-onboarding" set. User "azure-arc-onboarding" set. Context "azure-arc-onboarding" created. Switched to context "azure-arc-onboarding". Azure login az login: error: argument --password/-p: expected one argument usage: az login [-h] [--verbose] [--debug] [--only-show-errors] [--output {json,jsonc,yaml,yamlc,table,tsv,none}] [--query JMESPATH] [--username USERNAME] [--password PASSWORD] [--service-principal] [--tenant TENANT] [--allow-no-subscriptions] [-i] [--use-device-code] [--use-cert-sn-issuer] : Job Failed Condition]

Untuk mengatasi masalah ini, tinjau opsi di bawah ini:

  • Opsi 1: Hapus kluster beban kerja dan coba lagi menggunakan Pusat Admin Windows.
  • Opsi 2: Di PowerShell, periksa apakah kluster telah berhasil dibuat dengan menjalankan perintah Dapatkan-AksHciCluster, lalu gunakan Enable-AksHciArcConnection untuk menghubungkan kluster Anda ke Arc.

Enable-AksHciArcConnection gagal jika Connect-AzAccount digunakan untuk masuk ke Azure

Saat Anda menggunakan Connect-AzAccount untuk masuk ke Azure, Anda mungkin mengatur langganan yang berbeda sebagai konteks default Anda daripada yang Anda berikan sebagai input ke Set-AksHciRegistration. Saat Anda kemudian menjalankan Enable-AksHciArcConnection, perintah mengharapkan langganan yang digunakan di Set-AksHciRegistration. Namun, Enable-AksHciArcConnection membuat set langganan default menggunakan Connect-AzAccount, dan karenanya, dapat menyebabkan kesalahan.

Untuk mencegah kesalahan seperti ini, ikuti salah satu opsi di bawah ini:

  • Opsi 1: Jalankan Set-AksHciRegistration untuk masuk ke Azure dengan parameter yang sama (grup langganan serta sumber daya) yang digunakan saat pertama kali menjalankan perintah untuk menghubungkan host AKS Anda ke Azure untuk penagihan. Anda kemudian dapat menggunakan Enable-AksHciArcConnection -Name <ClusterName> dengan nilai default, dan kluster Anda akan terhubung ke Arc di bawah langganan penagihan host AKS dan grup sumber daya.

  • Opsi 2: Jalankan Enable-AksHciArcRegistration dengan semua parameter, subscription, resource group, location, tenantdan secret, untuk menghubungkan kluster Anda ke Azure Arc di bawah grup langganan dan sumber daya yang berbeda dari host AKS. Anda juga harus menjalankan Enable-AksHciArcRegistration jika tidak memiliki cukup izin untuk menghubungkan kluster ke Azure Arc menggunakan Akun Azure (misalnya, jika Anda bukan pemilik langganan).

Kesalahan: 'Waktu habis menunggu kondisi'

Kesalahan ini pada umumnya menunjuk ke salah satu masalah berikut:

  • Kluster dibuat di Azure VM di lingkungan virtual, atau Anda menyebarkan AKS di Azure Stack HCI pada beberapa tingkat virtualisasi.
  • Internet yang lambat menyebabkan waktu habis.

Jika salah satu skenario di atas berlaku untuk Anda, jalankan Disable-AksHciArcConnection, dan coba sambungkan lagi. Jika skenario di atas tidak berlaku untuk Anda, buka masalah dukungan untuk AKS di Azure Stack HCI.

Kesalahan: "Rahasia "sh.helm.release.v1.azure-arc.v1" tidak ditemukan"

Kesalahan ini berarti bahwa server API Kubernetes Anda tidak dapat dihubungi.

Coba jalankan perintah Disable-AksHciArcConnection lagi, lalu buka portal Microsoft Azure untuk mengonfirmasi bahwa sumber daya connectedCluster Anda sebenarnya telah dihapus. Anda juga dapat menjalankan kubectl get ns -A untuk mengonfirmasi bahwa namespace layanan, azure-arc, tidak ada pada kluster Anda.

Kesalahan: 'Kesalahan saat memperbarui agen untuk mengaktifkan fitur'

Jika Anda mengaktifkan lokasi kustom dan fitur koneksi kluster pada kluster AKS yang tersambung ke Azure Arc, Anda mungkin melihat kesalahan berikut:

Error while updating agents for enabling features. Please run "kubectl get pods -n azure-arc" to check the pods in case of timeout error. Error: Error: UPGRADE FAILED: timed out waiting for the condition

Ini adalah masalah yang diketahui terkait rilis September dan diperbaiki dalam rilis Oktober. Kluster AKS baru yang dibuat menggunakan rilis Oktober dan terhubung ke Arc menggunakan Enable-AksHciArcConnection tidak mengalami masalah ini. Perbarui penyebaran AKS Arc Anda ke rilis Oktober lalu sambungkan kembali kluster yang ada ke Arc untuk solusi untuk masalah ini.

Kesalahan: 'Koneksi ke Azure gagal. Jalankan 'Set-AksHciRegistration' dan coba lagi'

Kesalahan ini berarti info masuk Anda ke Azure sudah kedaluwarsa.

Gunakan Set-AksHciRegistration untuk masuk ke Azure sebelum mengoperasikan perintah Enable-AksHciArcConnection lagi. Saat menjalankan ulang Set-AksHciRegistration, pastikan Anda menggunakan detail langganan dan grup sumber daya yang sama dengan yang digunakan saat pertama kali mendaftarkan host AKS ke Azure untuk penagihan. Jika Anda menjalankan ulang perintah dengan langganan atau grup sumber daya yang berbeda, maka tidak akan didaftarkan. Setelah langganan dan grup sumber daya diatur dalam Set-AksHciRegistration, mereka tidak dapat diubah tanpa menghapus instalan AKS Arc.

Kesalahan: ''My-Cluster' bukan nama kluster yang valid. Nama harus huruf kecil dan cocok dengan pola ekspresi reguler: '^[a-z0-9][a-z0-9-]*[a-z0-9]$''

Kesalahan ini menunjukkan bahwa kluster beban kerja tidak mengikuti konvensi penamaan Kubernetes.

Seperti yang disarankan kesalahan, pastikan nama kluster huruf kecil dan cocok dengan pola ekspresi reguler: '^[a-z0-9][a-z0-9-]*[a-z0-9]$'.

Kesalahan: 'addons.msft.microsoft "demo-arc-onboarding" sudah ada'

Kesalahan ini biasanya berarti Anda telah menghubungkan kluster AKS anda ke Kubernetes yang didukung Arc. Untuk mengonfirmasi bahwa sudah terhubung, buka portal Microsoft Azure kemudian periksa di bawah grup langganan dan sumber daya yang Anda sediakan saat menjalankan Set-AksHciRegistration (jika Anda telah menggunakan nilai default) atau Enable-AksHciArcConnection (jika Anda belum menggunakan nilai default). Anda juga dapat mengonfirmasi apakah kluster AKS di Azure Stack HCI Anda terhubung ke Azure dengan menjalankan perintah az connectedk8s show Azure CLI. Jika Anda tidak melihat kluster beban kerja, jalankan Disable-AksHciArcConnection dan coba lagi.

Kesalahan: 'autorest/azure: Layanan mengembalikan kesalahan. Status=404 Code="ResourceNotFound"...'

Kesalahan di bawah ini berarti bahwa Azure tidak bisa menemukan sumber daya ARM connectedCluster yang terkait dengan kluster Anda:

autorest/azure: Service returned an error. Status=404 Code="ResourceNotFound" Message="The Resource 'Microsoft.Kubernetes/connectedClusters/my-workload-cluster' under resource group 'AKS-HCI2' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix"]

Anda mungkin mengalami kesalahan ini apabila:

  • Anda menyediakan grup sumber daya atau langganan yang salah saat menjalankan Disable-AksHciArcConnection cmdlet.
  • Anda menghapus sumber daya di portal Microsoft Azure secara manual.
  • ARM tidak bisa menemukan sumber daya Azure Anda.

Untuk mengatasi kesalahan ini, misalnya yang ditunjukkan dalam pesan kesalahan, lihat mengatasi sumber daya yang tidak menemukan kesalahan.

Kesalahan: 'Cluster addons arc uninstall Error: namespaces "azure-arc" not found'

Kesalahan ini biasanya berarti bahwa Anda telah menghapus agen Arc dari kluster beban kerja, atau telah menghapus azure-arc namespace layanan secara manual menggunakan perintah kubectl.

Buka portal Microsoft Azure untuk mengonfirmasi apakah Anda tidak memiliki sumber daya yang bocor. Contohnya, verifikasi bahwa Anda tidak melihat sumber daya connectedCluster di grup langganan dan sumber daya.

Kesalahan: 'Langganan Azure tidak dikonfigurasi dengan benar'

Anda mungkin mengalami masalah ini jika belum mengonfigurasi langganan Azure dengan penyedia sumber daya Kubernetes dengan dukungan Arc. Saat ini kami memeriksa bahwa Microsoft.Kubernetes dan Microsoft.KubernetesConfiguration sudah dikonfigurasi.

Untuk informasi selengkapnya tentang mengaktifkan penyedia sumber daya ini, lihat Mendaftarkan penyedia untuk Kubernetes yang didukung Arc.