Řešení chyb při povolování nebo zakazování Azure Arc na clusterech úloh AKS

Tento článek popisuje chyby, ke kterým může dojít (a jejich alternativní řešení) při připojování nebo odpojování AKS v clusterech úloh Azure Stack HCI k Azure Arc pomocí rutin PowerShellu Enable-AksHciArcConnection a Disable-AksHciArcConnection. Informace o problémech, které nejsou uvedené v tomto článku, najdete v tématu řešení potíží s Kubernetes s podporou Arc.

Problém s podporou můžete otevřít také v případě, že se na vás nevztahuje žádné z níže uvedených alternativních řešení.

Chyba: Error while updating agents for enabling features

Pokud povolíte funkce vlastního umístění a připojení clusteru ve vašem Azure Arc připojeném AKS v Azure Stack HCI clusteru, může se zobrazit následující chyba:

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

Jedná se o známý problém se zářijovou verzí a je opravený v říjnové verzi. Nový AKS na Azure Stack HCI clusterech vytvořených pomocí říjnové verze a připojené k Arc pomocí Enable-AksHciArcConnection tento problém nezazná. Aktualizujte AKS v nasazení Azure Stack HCI na verzi z října a pak znovu připojte stávající clustery k Arc, abyste tento problém obešly.

Chyba: addons.msft.microsoft "demo-arc-onboarding" already exists

Tato chyba obvykle znamená, že jste už připojili AKS v clusteru Azure Stack HCI k Kubernetes s podporou Arc. Pokud chcete ověřit, že je připojený, přejděte na Azure Portal a zkontrolujte předplatné a skupinu prostředků, které jste poskytli při spuštění Set-AksHciRegistration (pokud jste použili výchozí hodnoty) nebo Enable-AksHciArcConnection (pokud jste nepoužít výchozí hodnoty). Spuštěním příkazu az connectedk8s show Azure CLI můžete také ověřit, jestli je váš Azure Stack HCI AKS v clusteru připojený k Azure. Pokud cluster úloh nevidíte, spusťte příkaz a Disable-AksHciArcConnection zkuste to znovu.

Chyba: Connection to Azure failed. Please run 'Set-AksHciRegistration' and try again

Tato chyba znamená, že vypršela platnost přihlašovacích údajů k Azure. Před opětovním spuštění příkazu Enable-AksHciArcConnection se přihlaste k Azure pomocí příkazu Set-AksHciRegistration. Při opětovném spuštění se ujistěte, že používáte stejné podrobnosti o předplatném a skupině prostředků, které jste použili při první registraci hostitele AKS v Set-AksHciRegistration Azure pro účely fakturace. Pokud příkaz znovu spusťte s jiným předplatným nebo skupinou prostředků, nezaregistruje se. Po nastavení předplatného a skupiny prostředků v nástroji není možné je změnit bez Set-AksHciRegistration odinstalace AKS na Azure Stack HCI.

Chyba: System.Management.Automation.RemoteException Starting onboarding process Cluster "azure-arc-onboarding" set...

Pokud k vytvoření clusteru úloh a jeho připojení Windows Kubernetes s podporou Arc, může dojít k následující chybě:

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]

Pokud chcete tento problém vyřešit, projděte si následující možnosti:

  • Možnost 1: Odstraňte cluster úloh a zkuste to znovu Windows Admin Center.
  • Možnost 2: V PowerShellu zkontrolujte, jestli se cluster úspěšně vytvořil, spuštěním příkazu Get-AksHciCluster a pak pomocí rutiny Enable-AksHciArcConnection připojte cluster ke službě Arc.

Chyba: Timed out waiting for the condition

Tato chyba obvykle ukazuje na jeden z následujících problémů:

  • Clustery se vytvořily na virtuálním počítači Azure ve virtualizovaném prostředí nebo pokud nasazujete AKS na Azure Stack HCI na více úrovních virtualizace.
  • Kvůli pomalému internetu.

Pokud se na vás vztahuje jeden z výše uvedených scénářů, spusťte příkaz Disable-AksHciArcConnection a zkuste se připojit znovu. Pokud se na vás výše uvedený scénář nevztahuje, otevřete problém s podporou v AKS na Azure Stack HCI.

Chyba: Azure subscription is not properly configured

K tomuto problému může dojít v případě, že jste nenakonfigurovali předplatné Azure s poskytovateli prostředků Kubernetes s podporou služby Arc. V současné době zkontrolujeme, Microsoft.Kubernetes jestli Microsoft.KubernetesConfiguration jsou nakonfigurované a . Další informace o povolení těchto poskytovatelů prostředků najdete v tématu povolení poskytovatelů prostředků pro Kubernetes s podporou Arc.

Chyba: A workload cluster with the name 'my-aks-cluster' was not found

Tato chyba znamená, že jste nevytyčili cluster úloh nebo jste nesprávně napsal název clusteru úloh. Spuštěním get-AksHciCluster ověřte, že máte správný název nebo jestli existuje cluster, ke které se chcete připojit k Arc.

Chyba: 'My-Cluster' is not a valid cluster name. Names must be lower-case and match the regular expression pattern: '^[a-z0-9][a-z0-9-]*[a-z0-9]$'

Tato chyba znamená, že cluster úloh neodpovídá konvenci vytváření názvů Kubernetes. Jak chyba naznačuje, ujistěte se, že název clusteru je malá písmena a odpovídá vzoru regulárního výrazu: ^[a-z0-9][a-z0-9-]*[a-z0-9]$.

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

Tato chyba obvykle znamená, že jste agenty Arc z clusteru úloh už odinstalováli nebo jste obor názvů ručně odstranili azure-arc pomocí kubectl příkazu . Přejděte do Azure Portal a ověřte, že nemáte žádné prozrazené prostředky. Ověřte například, že v předplatném a skupině prostředků connectedCluster nevidíte prostředek.

Chyba: Secrets "sh.helm.release.v1.azure-arc.v1" not found

Tato chyba znamená, že váš server rozhraní Kubernetes API nebyl dosažen. Zkuste znovu spustit příkaz Disable-AksHciArcConnection a pak přejděte do Azure Portal a ověřte, že se váš prostředek skutečně odstranil. Můžete také spustit příkaz a potvrdit, že obor kubectl get ns -a názvů ve vašem clusteru azure-arc neexistuje.

Chyba: autorest/azure: Service returned an error. Status=404 Code="ResourceNotFound"...

Následující chyba znamená, že Azure nemohl najít prostředek connectedCluster ARM přidružený k vašemu clusteru:

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"]

K této chybě může dojít v případě, že:

  • Při spuštění rutiny jste zadali nesprávnou skupinu prostředků nebo Disable-AksHciArcConnection předplatné.
  • Ručně jste odstranili prostředek na Azure Portal.
  • ARM nemůže najít váš prostředek Azure.

Pokud chcete tuto chybu vyřešit, jak je uvedeno v chybové zprávě, podívejte se na řešení chyb typu Prostředek se nenašel.

Enable-AksHciArcConnection selhání, Connect-AzAccount se používá k přihlášení k Azure

Když se Připojení-AzAccount použijete k přihlášení k Azure, můžete jako výchozí kontext nastavit jiné předplatné než to, které jste dali jako vstup pro Set-AksHciRegistration. Když pak spustíte Enable-AksHciArcConnection,očekává příkaz předplatné použité v . Získá Enable-AksHciArcConnection však výchozí sadu předplatného pomocí , a Connect-AzAccount proto může způsobit chybu. Pokud chcete této chybě zabránit, postupujte podle jedné z následujících možností:

  • Možnost 1: Spuštěním příkazu se přihlaste k Azure pomocí stejných parametrů (předplatné a skupina prostředků), které jste použili při prvním spuštění příkazu pro připojení hostitele AKS k Set-AksHciRegistration Azure pro účely fakturace. Pak můžete použít s výchozími hodnotami a váš cluster se připojí k Arc v rámci fakturačního předplatného a skupiny prostředků hostitele Enable-AksHciArcConnection -Name <ClusterName> AKS.

  • Možnost 2: Spuštěním příkazu se všemi parametry , , , a připojte cluster k Azure Arc v rámci jiného předplatného a skupiny prostředků než hostitel Enable-AksHciArcRegistrationsubscriptionresource grouplocationtenantsecret AKS. Příkaz byste měli spustit také v případě, že nemáte dostatečná oprávnění k připojení clusteru Azure Arc pomocí účtu Azure (například pokud nejste vlastníkem Enable-AksHciArcRegistration předplatného).

Další kroky