Aplica-se a: AKS no Azure Stack HCI, AKS no Windows Server
Este artigo descreve os erros que pode encontrar (e as respetivas soluções) ao ligar ou desligar os clusters de cargas de trabalho do AKS ao Azure Arc com os cmdlets do PowerShell Enable-AksHciArcConnection e Disable-AksHciArcConnection no AKS Arc. Para problemas que não são abordados neste artigo, veja Resolução de problemas do Kubernetes compatível com o Arc.
Também pode abrir um problema de suporte se nenhuma das soluções listadas abaixo se aplicar a si.
Erro: "Não foi encontrado um cluster de cargas de trabalho com o nome "my-aks-cluster"
Este erro significa que não criou o cluster de cargas de trabalho ou que soletrou incorretamente o nome do cluster de cargas de trabalho.
Execute Get-AksHciCluster para garantir que tem o nome correto ou que o cluster que pretende ligar ao Arc existe.
Erro: "System.Management.Automation.RemoteException A iniciar o cluster do processo de inclusão "azure-arc-onboarding" definido..."
O seguinte erro pode ocorrer quando utiliza Windows Admin Center para criar um cluster de cargas de trabalho e ligá-lo ao Kubernetes compatível com o 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]
Para resolver este problema, reveja as opções abaixo:
- Opção 1: elimine o cluster de cargas de trabalho e tente novamente com Windows Admin Center.
- Opção 2: no PowerShell, verifique se o cluster foi criado com êxito ao executar o comando Get-AksHciCluster e, em seguida, utilize Enable-AksHciArcConnection para ligar o cluster ao Arc.
Enable-AksHciArcConnection falha se Connect-AzAccount for utilizado para iniciar sessão no Azure
Quando utiliza o Connect-AzAccount para iniciar sessão no Azure, pode definir uma subscrição diferente do contexto predefinido que deu como entrada para Set-AksHciRegistration. Quando executar Enable-AksHciArcConnection, o comando espera que a subscrição seja utilizada no Set-AksHciRegistration. No entanto, Enable-AksHciArcConnection obtém a subscrição predefinida com o Connect-AzAccounte, portanto, pode causar um erro.
Para evitar este erro, siga uma das opções abaixo:
Opção 1: execute
Set-AksHciRegistrationpara iniciar sessão no Azure com os mesmos parâmetros (subscrição e grupo de recursos) que utilizou quando executou o comando pela primeira vez para ligar o anfitrião do AKS ao Azure para faturação. Em seguida, pode utilizarEnable-AksHciArcConnection -Name <ClusterName>com valores predefinidos e o cluster será ligado ao Arc na subscrição de faturação do anfitrião do AKS e no grupo de recursos.Opção 2: execute
Enable-AksHciArcRegistrationcom todos os parâmetros,subscription,resource group,location,tenantesecret, para ligar o cluster ao Azure Arc numa subscrição e grupo de recursos diferente do anfitrião do AKS. Também deve executarEnable-AksHciArcRegistrationse não tiver permissões suficientes para ligar o cluster ao Azure Arc com a sua Conta do Azure (por exemplo, se não for o proprietário da subscrição).
Erro: "Tempo limite excedido à espera da condição"
Normalmente, este erro aponta para um dos seguintes problemas:
- Os clusters foram criados numa VM do Azure num ambiente virtualizado ou estava a implementar o AKS no Azure Stack HCI em vários níveis de virtualização.
- Uma Internet lenta causou o tempo limite.
Se um dos cenários acima se aplicar a si, execute Disable-AksHciArcConnection e tente ligar novamente. Se o cenário acima não se aplicar a si, abra um problema de suporte para o AKS no Azure Stack HCI.
Erro: "Segredos "sh.helm.release.v1.azure-arc.v1" não encontrados"
Este erro indica que não foi possível aceder ao servidor da API do Kubernetes.
Tente executar novamente o comando Disable-AksHciArcConnection e, em seguida, aceda ao portal do Azure para confirmar que o recurso connectedCluster foi realmente eliminado. Também pode executar kubectl get ns -A para confirmar que o espaço de nomes, azure-arc, não existe no cluster.
Erro: "Erro ao atualizar agentes para ativar funcionalidades"
Se ativar a localização personalizada e as funcionalidades de ligação do cluster num cluster do AKS que está ligado ao Azure Arc, poderá ver o seguinte erro:
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
Este é um problema conhecido com a versão de setembro e foi corrigido na versão de outubro. Os novos clusters do AKS criados com a versão de outubro e ligados ao Arc com Enable-AksHciArcConnection não têm este problema. Atualize a implementação do AKS Arc para a versão de outubro e, em seguida, volte a ligar os clusters existentes ao Arc para obter uma solução para este problema.
Erro: "Falha na ligação ao Azure. Execute "Set-AksHciRegistration" e tente novamente"
Este erro significa que as credenciais de início de sessão no Azure expiraram.
Utilize Set-AksHciRegistration para iniciar sessão no Azure antes de executar novamente o comando Enable-AksHciArcConnection . Ao executar novamente Set-AksHciRegistration, certifique-se de que utiliza os mesmos detalhes da subscrição e do grupo de recursos que utilizou quando registou pela primeira vez o anfitrião do AKS no Azure para faturação. Se voltar a executar o comando com uma subscrição ou grupo de recursos diferente, estes não serão registados. Assim que a subscrição e o grupo de recursos estiverem definidos no Set-AksHciRegistration, não podem ser alterados sem desinstalar o AKS Arc.
Erro: "O Meu Cluster" não é um nome de cluster válido. Os nomes têm de estar em minúsculas e corresponder ao padrão de expressão regular: '^[a-z0-9][a-z0-9-]*[a-z0-9]$''
Este erro indica que o cluster de cargas de trabalho não segue a convenção de nomenclatura do Kubernetes.
Como o erro sugere, certifique-se de que o nome do cluster está em minúsculas e corresponde ao padrão de expressão regular: '^[a-z0-9][a-z0-9-]*[a-z0-9]$'.
Erro: "addons.msft.microsoft "demo-arc-onboarding" já existe"
Normalmente, este erro significa que já ligou o cluster do AKS ao Kubernetes compatível com o Arc.
Para confirmar que está ligado, aceda ao portal do Azure e verifique na subscrição e no grupo de recursos que forneceu ao executar Set-AksHciRegistration (se tiver utilizado valores predefinidos) ou Enable-AksHciArcConnection (se não tiver utilizado valores predefinidos). Também pode confirmar se o AKS no cluster do Azure Stack HCI está ligado ao Azure ao executar o comando az connectedk8s show da CLI do Azure. Se não vir o cluster de cargas de trabalho, execute Disable-AksHciArcConnection e tente novamente.
Erro: "autorest/azure: O serviço devolveu um erro. Status=404 Code="ResourceNotFound"...'
O erro abaixo significa que o Azure não conseguiu encontrar o recurso arm connectedCluster associado ao cluster:
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"]
Poderá deparar-se com este erro se:
- Forneceu um grupo de recursos ou subscrição incorreto durante a execução do
Disable-AksHciArcConnectioncmdlet. - Eliminou manualmente o recurso no portal do Azure.
- O ARM não consegue localizar o recurso do Azure.
Para resolver este erro, conforme indicado na mensagem de erro, veja Resolver erros de recursos não encontrados.
Erro: "Erro de desinstalação do arc de suplementos de cluster: espaços de nomes "azure-arc" não encontrados"
Normalmente, este erro significa que já desinstalou agentes do Arc do cluster de cargas de trabalho ou eliminou manualmente o azure-arc espaço de nomes com o kubectl comando .
Aceda à portal do Azure para confirmar que não tem quaisquer recursos vazados. Por exemplo, verifique se não vê um connectedCluster recurso na subscrição e no grupo de recursos.
Erro: "A subscrição do Azure não está configurada corretamente"
Poderá deparar-se com este problema se não tiver configurado a sua subscrição do Azure com os fornecedores de recursos do Kubernetes compatíveis com o Arc. Atualmente, verificamos e Microsoft.KubernetesMicrosoft.KubernetesConfiguration estamos configurados.
Para obter mais informações sobre como ativar estes fornecedores de recursos, veja Registar fornecedores do Kubernetes compatível com o Arc.