Řešení chyb při povolování nebo zakazování služby Azure Arc na clusterech úloh AKS v AKS s povolenou službou Arc

Platí pro: AKS v Azure Stack HCI, AKS na Windows Serveru

Tento článek popisuje chyby, se kterými se můžete setkat (a jejich alternativní řešení) při připojování nebo odpojování clusterů úloh AKS ke službě Azure Arc pomocí rutin PowerShellu Enable-AksHciArcConnection a Disable-AksHciArcConnection ve službě AKS Arc. Informace o problémech, které nejsou popsané v tomto článku, najdete v tématu Řešení potíží s Kubernetes s podporou arc.

Pokud se vás netýká žádné z níže uvedených alternativních řešení, můžete také otevřít problém s podporou .

Chyba: Cluster úloh s názvem my-aks-cluster se nenašel

Tato chyba znamená, že jste cluster úloh nevytvořili nebo jste nesprávně napsali název clusteru úloh.

Spusťte rutinu Get-AksHciCluster a ujistěte se, že máte správný název nebo že cluster, který chcete připojit ke službě Arc, existuje.

Chyba: System.Management.Automation.RemoteException Spouští se proces onboardingového clusteru azure-arc-onboarding nastavený..."

Pokud použijete Windows Admin Center k vytvoření clusteru úloh a jeho připojení ke Kubernetes s podporou služby 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 pomocí Windows Admin Center.
  • Možnost 2: Spuštěním příkazu Get-AksHciCluster v PowerShellu zkontrolujte, jestli se cluster úspěšně vytvořil, a pak pomocí rutiny Enable-AksHciArcConnection připojte cluster ke službě Arc.

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

Když k přihlášení k Azure použijete Connect-AzAccount , můžete nastavit jako výchozí kontext jiné předplatné než ten, který jste zadali jako vstup do Set-AksHciRegistration. Když pak spustíte Enable-AksHciArcConnection, příkaz očekává předplatné použité v Set-AksHciRegistration. Enable-AksHciArcConnection Získá ale výchozí sadu předplatného pomocí Connect-AzAccount, a 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 Set-AksHciRegistration se přihlaste k Azure se stejnými parametry (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 Azure za účelem fakturace. Potom můžete použít Enable-AksHciArcConnection -Name <ClusterName> s výchozími hodnotami a váš cluster se připojí ke službě Arc v rámci fakturačního předplatného a skupiny prostředků hostitele AKS.

  • Možnost 2: Spuštěním příkazu Enable-AksHciArcRegistration se všemi parametry , subscription, , tenantresource grouplocation, a secretpřipojte cluster ke službě Azure Arc v jiném předplatném a jiné skupině prostředků než hostitel AKS. Spuštění byste měli provést Enable-AksHciArcRegistration také v případě, že nemáte dostatečná oprávnění k připojení clusteru ke službě Azure Arc pomocí účtu Azure (například pokud nejste vlastníkem předplatného).

Chyba: Vypršení časového limitu při čekání na podmínku

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 jste nasadili AKS v Azure Stack HCI na několika úrovních virtualizace.
  • Vypršení časového limitu způsobilo pomalý internet.

Pokud se vás týká některý z výše uvedených scénářů, spusťte příkaz Disable-AksHciArcConnection a zkuste se připojit znovu. Pokud se vás výše uvedený scénář netýká, otevřete problém s podporou pro AKS ve službě Azure Stack HCI.

Chyba: Tajné kódy sh.helm.release.v1.azure-arc.v1 se nenašly

Tato chyba značí, že váš server rozhraní API Kubernetes není dostupný.

Zkuste znovu spustit příkaz Disable-AksHciArcConnection a pak přejděte na Azure Portal a ověřte, že se váš connectedCluster prostředek skutečně odstranil. Spuštěním příkazu kubectl get ns -A můžete také ověřit, azure-arcže obor názvů ve vašem clusteru neexistuje.

Chyba: Chyba při aktualizaci agentů pro povolení funkcí

Pokud povolíte funkce vlastního umístění a připojení clusteru v clusteru AKS, který je připojený ke službě Azure Arc, 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 v zářijové verzi, který je opravený v říjnové verzi. U nových clusterů AKS vytvořených v říjnové verzi a připojených ke službě Arc pomocí Enable-AksHciArcConnection k tomuto problému dochází. Aktualizujte nasazení služby AKS Arc na říjnovou verzi a pak znovu připojte existující clustery ke službě Arc, abyste tento problém vyřešili.

Chyba: Připojení k Azure selhalo. Spusťte příkaz Set-AksHciRegistration a zkuste to znovu.

Tato chyba znamená, že vypršela platnost vašich přihlašovacích údajů k Azure.

Před dalším spuštěním příkazu Enable-AksHciArcConnection se přihlaste k Azure pomocí rutiny Set-AksHciRegistration. Při opětovném spuštění Set-AksHciRegistrationse 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 do Azure za účelem fakturace. Pokud příkaz znovu spustíte s jiným předplatným nebo jinou skupinou prostředků, nebudou zaregistrované. Jakmile jsou předplatné a skupina prostředků nastavené v Set-AksHciRegistration, nejde je změnit bez odinstalace služby AKS Arc.

Chyba: My-Cluster není platný název clusteru. Názvy musí být malé a musí odpovídat vzoru regulárního výrazu: '^[a-z0-9][a-z0-9-]*[a-z0-9]$''

Tato chyba značí, že cluster úloh nedodržuje zásady vytváření názvů Kubernetes.

Jak chyba napovídá, ujistěte se, že název clusteru je malými písmeny a odpovídá vzoru regulárního výrazu: ^[a-z0-9][a-z0-9]*[a-z0-9]$'.

Chyba: Addons.msft.microsoft demo-arc-onboarding už existuje.

Tato chyba obvykle znamená, že jste cluster AKS už připojili ke 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 zadali při spuštění set-AksHciRegistration (pokud jste použili výchozí hodnoty) nebo Enable-AksHciArcConnection (pokud jste nepoužili výchozí hodnoty). Spuštěním příkazu Azure CLI az connectedk8s show můžete také ověřit, jestli je váš cluster AKS ve službě Azure Stack HCI připojený k Azure. Pokud se váš cluster úloh nezobrazuje, spusťte Disable-AksHciArcConnection příkaz a zkuste to znovu.

Chyba: autorest/azure: Služba vrátila chybu. Status=404 Code="ResourceNotFound"...'

Následující chyba znamená, že Azure nemohl najít connectedCluster prostředek 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 následujících případech:

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

Pokud chcete tuto chybu vyřešit, jak je uvedeno v chybové zprávě, projděte si téma řešení chyb s nenalezenou prostředky.

Chyba: Addons clusteru arc uninstall Chyba: Obory názvů azure-arc se nenašly

Tato chyba obvykle znamená, že jste už odinstalovali agenty Arc z clusteru úloh nebo jste obor názvů odstranili azure-arc ručně pomocí kubectl příkazu .

Přejděte na Azure Portal a ověřte, že nedošlo k úniku prostředků. Například ověřte, že se v předplatném connectedCluster a skupině prostředků nezobrazuje prostředek.

Chyba: Předplatné Azure není správně nakonfigurované

K tomuto problému může dojít, pokud jste v předplatném Azure nenakonfigurovali poskytovatele prostředků Kubernetes s podporou Arc. V současné době kontrolujeme, že Microsoft.Kubernetes jsou nakonfigurované a Microsoft.KubernetesConfiguration .

Další informace o povolení těchto poskytovatelů prostředků najdete v tématu Registrace zprostředkovatelů pro Kubernetes s podporou arc.