Solucionar problemas de criação ou atualização de cluster

Esta página mostra como resolver problemas relacionados à instalação ou atualização do GKE no Azure.

Se precisar de assistência adicional, entre em contato com o Atendimento ao Cliente da Cloud .

Falhas na criação de cluster

Ao fazer uma solicitação para criar um cluster, o GKE no Azure primeiro executa um conjunto de testes de pré-lançamento para verificar a solicitação. Se a criação do cluster falhar, pode ser porque um desses testes de pré-lançamento falhou ou porque uma etapa do processo de criação do cluster não foi concluída.

Se um teste de pré-voo falhar, o cluster não criará nenhum recurso e retornará informações sobre o erro diretamente para você. Por exemplo, se você tentar criar um cluster com o nome invalid%%%name , o teste de pré-voo para um nome de cluster válido falhará e a solicitação retornará o seguinte erro:

ERROR: (gcloud.container.azure.clusters.create) INVALID_ARGUMENT: must be
between 1-63 characters, valid characters are /[a-z][0-9]-/, should start with a
letter, and end with a letter or a number: "invalid%%%name",
field: azure_cluster_id

A criação do cluster também pode falhar após a conclusão dos testes de pré-voo. Isso pode ocorrer vários minutos após o início da criação do cluster, após o GKE no Azure ter criado recursos em Google Cloud e Azure. Neste caso, um recurso do Azure existirá em seu Google Cloud projeto com seu estado definido como ERROR .

Para obter detalhes sobre a falha, execute o seguinte comando:

gcloud container azure clusters describe CLUSTER_NAME \
    --location GOOGLE_CLOUD_LOCATION \
    --format "value(state, errors)"

Substitua o seguinte:

  • CLUSTER_NAME com o nome do cluster cujo estado você está consultando
  • GOOGLE_CLOUD_LOCATION com o nome do Google Cloud região que gerencia este cluster do Azure

Como alternativa, você pode obter detalhes sobre a falha de criação descrevendo o recurso Operation associado à chamada de API de criação de cluster.

gcloud container azure operations describe OPERATION_ID

Substitua OPERATION_ID pelo ID da operação que criou o cluster. Se você não tiver o ID da operação da sua solicitação de criação de cluster, poderá obtê-lo com o seguinte comando:

gcloud container azure operations list \
    --location GOOGLE_CLOUD_LOCATION

Use o registro de data e hora ou informações relacionadas para identificar a operação de criação de cluster de interesse.

Falhas de atualização de cluster

Ao atualizar um cluster, assim como ao criar um novo cluster, o GKE no Azure primeiro executa um conjunto de testes de pré-lançamento para verificar a solicitação. Se a atualização do cluster falhar, pode ser porque um desses testes de pré-lançamento falhou ou porque uma etapa do processo de atualização do cluster não foi concluída.

Se um teste de pré-voo falhar, o cluster não atualizará nenhum recurso e retornará informações sobre o erro diretamente para você. Por exemplo, se você tentar atualizar um cluster para usar um par de chaves SSH chamado test_ec2_keypair , o teste de pré-voo tentará buscar o par de chaves EC2, mas falhará, e a solicitação retornará o seguinte erro:

ERROR: (gcloud.container.azure.clusters.update) INVALID_ARGUMENT: key pair
"test_ec2_keypair" not found,
field: azure_cluster.control_plane.ssh_config.ec2_key_pair

As atualizações do cluster também podem falhar após a conclusão dos testes de pré-voo. Isso pode ocorrer vários minutos após o início da atualização do cluster, e seu recurso do Azure em seu Google Cloud o projeto tem seu estado definido como DEGRADED .

Para obter detalhes sobre a falha e a operação relacionada, siga as etapas descritas em Falhas na criação do cluster .

O que vem a seguir