Solucionar problemas da implantação com falha de uma oferta de aplicativo do Kubernetes

Artigo
04/12/2024

Este artigo discute como solucionar problemas de uma implantação com falha de uma oferta de aplicativo kubernetes que foi aceita no microsoft Azure Marketplace. Quando você inicia a compra de uma oferta do Kubernetes, o Azure implanta um modelo do Azure Resource Manager (modelo ARM) que tenta instalar os recursos necessários para atender à oferta. No entanto, a implantação do modelo arm pode falhar por vários motivos.

Lista de verificação de solução de problemas

Examinar os logs de operação de implantação

Para determinar a causa da falha de implantação, você precisa examinar os logs de operação de implantação. Se você ainda estiver exibindo a página Com falha na implantação no portal do Azure, comece na etapa 5 do procedimento a seguir. Se, em vez disso, você saiu do portal do Azure ou navegou até outra página do portal, siga todas estas etapas:

No portal do Azure, pesquise e selecione Grupos de recursos.
Na lista de grupos de recursos, selecione o nome do grupo de recursos no qual você tentou implantar o aplicativo Kubernetes.
Na página Visão geral do grupo de recursos, localize a seção Essentials e selecione o texto hiperlinkado que aparece ao lado do campo Implantações. Este texto exibe a taxa de sucesso do histórico de implantação de recursos do grupo de recursos (por exemplo, 4 falharam, 30 foram bem-sucedidos).
Na lista de implantações tentativas para seu grupo de recursos, selecione o valor do nome da implantação que falhou, com base nos seguintes campos correspondentes:
- Última modificação (um carimbo de hora)
- Duration
- Status (mostra falha em vez de bem-sucedido)
Na lista de detalhes de implantação na página de implantação, localize o Recurso para o qual o campo Status tem um valor de Conflito. Selecione o link Detalhes da operação para esse recurso.
No painel Detalhes da Operação , localize a propriedade Status (mostra um valor de Conflito) e examine a caixa de mensagem Status abaixo da propriedade.

O código JSON dentro da mensagem status mostra uma status propriedade de Failed. Ele também mostra uma error propriedade que contém as propriedades filho de (um nome de código de code erro, como "ExtensionOperationFailed") e message (uma descrição de mensagem de erro, como "A operação de extensão falhou com o seguinte erro: falha ao resolve a versão de extensão dos valores fornecidos."). O código JSON se assemelha ao seguinte texto:
```
{
    "status": "Failed",
    "error": {
        "code": "ExtensionOperationFailed",
        "message": "The extension operation failed with the following error: Failed to resolve the extension version from the given values."
    }
}
```

As seções a seguir discutem a causa e a solução para alguns cenários comuns de falha.

Causa 1: O aplicativo não foi instalado no cluster do AKS selecionado

Se o aplicativo Kubernetes não tiver sido instalado no cluster do AKS (Serviço de Kubernetes do Azure selecionado), você receberá uma mensagem de erro que se assemelha ao seguinte texto:

Falha na solicitação no https://management.azure.com/subscriptions/<guid> de assinatura/resourceGroups/resourceGroup/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default?api-version=2021-03-01. Código de erro: proibido. Motivo: proibido.
{  
  "error": {  
    "code": "AuthorizationFailed",  
    "message": "The client '<client-guid>' with object id '<client-guid>' does not have authorization to perform action 'Microsoft.ContainerService/managedclusters/extensionaddons/read' over scope '/subscriptions/<subscription-guid>/resourceGroups/resourceGroup/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default' or the scope is invalid. If access was recently granted, please refresh your credentials."  
  }  
} 

Solução 1a: registrar o provedor de recursos Microsoft.KubernetesConfiguration

Registre o provedor de recursos Microsoft.KubernetesConfiguration. Nesse caso, a instalação falhou porque o provedor de recursos Microsoft.KubernetesConfiguration é necessário para que você implante o aplicativo Kubernetes. Para obter instruções de registro, consulte a seção "Registrar provedores de recursos" no artigo Implantar uma oferta de contêiner de Azure Marketplace artigo.

Solução 1b: manter a integridade do cluster do AKS

Em geral, você deve marcar a integridade do cluster do AKS para evitar que outros problemas ocorram durante o período de instalação. Para garantir que o cluster esteja saudável, resolve problemas identificados no cluster.

Solução 1c: examinar o log de atividades do Azure Monitor

E se o cluster estiver saudável, mas a instalação ainda falhar? Nesse caso, examine o log de atividades do Azure Monitor no cluster do AKS para localizar a causa da falha nesse estágio da instalação.

Causa 2: a assinatura tem restrições de recurso

Como sua assinatura do Azure tem restrições de recurso, você experimenta uma falha que produz uma mensagem de erro semelhante ao seguinte texto:

Os instrumentos de pagamento 'desconhecidos' não têm suporte para oferta com OfferId: '<offer-name>', PlanId '<subscription-plan-name>'.

Solução 2: verifique se sua assinatura atende à configuração de cobrança necessária

Verifique a configuração de cobrança da assinatura para garantir que ela atenda aos requisitos de recurso do aplicativo Kubernetes. Para obter mais informações, consulte Verificações de validação de compra.

Causa 3: A oferta não estava disponível em sua região

Você recebe uma mensagem de erro que afirma que a oferta não pode ser vendida em uma determinada região geográfica. A mensagem de erro pode se assemelhar ao seguinte texto:

A Oferta: '<nome> da oferta' não pode ser comprada por assinatura: '<guia de> assinatura' pois não deve ser vendida no mercado: '<two-letter-region-code'.

Solução 3: verificar novamente se e onde a oferta ainda está disponível

Verifique se a oferta ainda está disponível e marcar duas vezes as regiões às quais a oferta se aplica.

Causa 4: ocorreu um erro interno do servidor

O aplicativo Kubernetes não foi instalado porque um recurso de extensão não foi instalado. Essa falha gera a seguinte mensagem de erro:

Falha na implantação da extensão com erro do servidor interno

Solução 4: excluir e reinstalar a extensão

Primeiro, exclua o recurso de extensão que faz parte da compra da oferta. Em seguida, reinstale a extensão.

Causa 5: O gráfico helm não foi instalado

Erros no gráfico do Helm geram a seguinte mensagem de erro:

Falha ao instalar o gráfico do caminho [] para lançamento

Solução 5: verificar novamente as entradas feitas no modelo ARM

Verifique se os valores e as seleções que você inseriu no portal do Azure para a implantação do modelo do ARM são aceitáveis no aplicativo Kubernetes.

Causa 6: Você não aceitou os termos legais na assinatura deste plano

Antes que a assinatura possa ser usada, você precisa aceitar os termos legais da imagem. Caso contrário, você receberá a seguinte mensagem de erro:

Você não aceitou os termos legais desta assinatura: "<guia> de assinatura" para este plano. Antes que a assinatura possa ser usada, você precisa aceitar os termos legais da imagem.

Solução 6: aceitar os termos legais

Você pode implantar por meio do portal do Azure. O portal do Azure fornece uma experiência de interface do usuário para ler e aceitar os termos legais.

Próximas etapas

Solucionar problemas de erros ao implantar extensões de cluster do AKS

Aviso de isenção de responsabilidade para informações de terceiros

Os produtos de terceiros mencionados neste artigo são produzidos por empresas independentes da Microsoft. A Microsoft não oferece nenhuma garantia, implícita ou não, do desempenho ou da confiabilidade desses produtos.

Entre em contato conosco para obter ajuda

Se você tiver dúvidas ou precisar de ajuda, crie uma solicitação de suporte ou peça ajuda à comunidade de suporte do Azure. Você também pode enviar comentários sobre o produto para a comunidade de comentários do Azure.

Partilhar via