Resolva problemas de criação ou atualização de clusters

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

Se precisar de assistência adicional, contacte o apoio ao cliente do Google Cloud.

Falhas na criação de clusters

Quando faz um pedido para criar um cluster, o GKE no Azure executa primeiro um conjunto de testes pré-voo para validar o pedido. Se a criação do cluster falhar, pode dever-se a uma destas situações: um dos testes prévios falhou ou um passo no próprio processo de criação do cluster não foi concluído.

Se um teste pré-implementação falhar, o cluster não cria recursos e devolve-lhe diretamente informações sobre o erro. Por exemplo, se tentar criar um cluster com o nome invalid%%%name, o teste prévio para um nome de cluster válido falha e o pedido devolve 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 de clusters também pode falhar após a aprovação nos testes pré-lançamento. Isto pode acontecer vários minutos após o início da criação do cluster, depois de o GKE no Azure ter criado recursos no Google Cloud e no Azure. Neste caso, existe um recurso do Azure no seu projeto com o estado definido como ERROR. Google Cloud

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 está a consultar
  • GOOGLE_CLOUD_LOCATION com o nome da Google Cloud região que gere este cluster do Azure

Em alternativa, pode obter detalhes sobre a falha de criação descrevendo o recurso Operationassociado à chamada da API create cluster.

gcloud container azure operations describe OPERATION_ID

Substitua OPERATION_ID pelo ID da operação que criou o cluster. Se não tiver o ID da operação do seu pedido de criação do cluster, pode obtê-lo com o seguinte comando:

gcloud container azure operations list \
    --location GOOGLE_CLOUD_LOCATION

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

Falhas na atualização do cluster

Quando atualiza um cluster, tal como quando cria um novo cluster, o GKE no Azure executa primeiro um conjunto de testes prévios para validar o pedido. Se a atualização do cluster falhar, pode dever-se a uma destas testes prévios falhados ou a um passo no próprio processo de atualização do cluster não concluído.

Se um teste pré-implementação falhar, o cluster não atualiza nenhum recurso e devolve-lhe diretamente informações sobre o erro. Por exemplo, se tentar atualizar um cluster para usar um par de chaves SSH com o nome test_ec2_keypair, o teste prévio tenta obter o par de chaves do EC2, falha e o pedido devolve 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 de clusters também podem falhar após a aprovação nos testes pré-implementação. Isto pode acontecer vários minutos após o início da atualização do cluster e o recurso do Azure no seu projeto tem o estado definido como DEGRADED. Google Cloud

Para obter detalhes sobre a falha e a operação relacionada, siga os passos descritos em Falhas na criação de clusters.

O que se segue?