Solução de problemas da instalação da Apigee

Você está vendo a documentação da Apigee X.
Ver a documentação da Apigee Edge.

Nesta seção, listamos os erros comuns e as possíveis resoluções para instalar e configurar a Apigee.

O problema mais comum que pode ocorrer é o seguinte erro HTTP:

  • 401 (UNAUTHENTICATED) indica que suas credenciais podem expirar. Tente renovar seu token de autorização, conforme mostrado no exemplo a seguir:
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"

Criar uma nova instância

Nesta seção, descrevemos erros comuns e possíveis soluções depois de enviar uma solicitação para o Apigee criar uma nova instância:

  • 401 (UNAUTHENTICATED) indica que suas credenciais expiraram. Tente renovar seu token de autorização, conforme mostrado no exemplo a seguir:
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • RANGES_EXHAUSTED indica que o intervalo de endereços IP que você solicitou inicialmente não poderia ser acomodado e que você precisa solicitar um novo intervalo. Você criou inicialmente uma solicitação de intervalo na Etapa 3: configurar a rede de serviços.

    Para solicitar um novo intervalo a partir do qual a Apigee escolha um endereço IP para as conexões de serviço privadas:

    1. Execute o seguinte comando gcloud:
      gcloud compute addresses create google-svcs-2
        --project=$PROJECT_ID --global --prefix-length=16
        --description="additional peering range for Google services" --network=default
        --purpose=VPC_PEERING

      Esse comando cria uma nova solicitação de intervalo.

      Observe que é necessário especificar o nome do primeiro intervalo (neste caso, "google-svcs") e um nome para o intervalo recém-solicitado (neste caso, google-svcs-2).

    2. Execute o seguinte comando para atualizar a solicitação de conexão:
      gcloud services vpc-peerings update
        --service=servicenetworking.googleapis.com --network=default
        --ranges=google-svcs,google-svcs-2 --project=$PROJECT_ID

      Observe que o comando vpc-peerings update também especifica os intervalos de endereços IP antigos e novos.

      Para mais informações, consulte gcloud services vpc-peerings update.

Como criar uma organização da Apigee

No exemplo a seguir, mostramos um erro comum que a Apigee pode exibir ao tentar criar uma organização pela primeira vez:

Erro ao criar a organização

Isso significa que uma ou mais APIs necessárias não estão ativadas. Revise as APIs listadas na Etapa 2: ativar as APIs da Apigee e verifique se todas as APIs estão ativadas antes de continuar.

Além disso, você pode receber um dos seguintes erros HTTP:

  • 401 (UNAUTHENTICATED) indica que suas credenciais expiraram. Tente renovar seu token de autorização, conforme mostrado no exemplo a seguir:
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • 404 (Not Found) pode ser o resultado do seguinte:
    • Você inseriu o URL de endpoint/solicitação incorreto. Verifique se você especificou apigee.googleapis.com para o domínio da chamada de API.
    • É possível que seu projeto ainda não esteja provisionado. Entre em contato com a Equipe de Vendas da Apigee
  • 409 (Conflict) normalmente indica que o nome da organização fornecido já existe. Os nomes das organizações precisam ser globalmente exclusivos. Escolha outro nome para a organização e emita novamente o comando. Especifique o nome no payload da solicitação se você estiver criando uma organização na linha de comando. Lembre-se de que é preciso criar uma organização com o mesmo nome do projeto. Portanto, isso não ocorrerá a menos que haja um erro de digitação.

Veja a seguir um erro possível que a Apigee pode retornar ao verificar o status de uma nova solicitação da organização:

  • 403 (Permission Denied) pode indicar que a organização ainda não foi criada. Aguarde mais um minuto e tente novamente. Se a Apigee retornar um 403 quando você tentar criar a nova organização pela primeira vez, talvez uma ou mais APIs não tenham sido ativadas. Verifique se você ativou todas as APIs conforme descrito na Etapa 2: ativar as APIs da Apigee.

Como implantar amostras

Ao implantar um proxy de amostra, a Apigee pode retornar um erro HTTP 502 (Bad Gateway). Nesse caso, tente o seguinte:

  1. Abra o Console do Cloud.
  2. Verifique a integridade do balanceador de carga. No Console do Cloud, selecione Serviços de rede > Balanceamento de carga. A guia Balanceador de carga mostra todos os balanceadores de carga do projeto e os status correspondentes. Um triângulo amarelo indica que o serviço de back-end do balanceador de carga não está íntegro.
  3. Depois de confirmar um problema com o balanceador de carga, verifique as VMs na instância do ambiente de execução para garantir que estejam íntegras.
  4. Analise os arquivos de registro para tentar encontrar um erro ou outro tipo de problema que pode levar a uma dificuldade.
  5. Tente executar uma reinicialização gradual no grupo de instâncias no Console do Cloud:
    1. Selecione Compute Engine > Grupos de instâncias.
    2. Na lista de grupos de instâncias, clique naquela que não está respondendo na coluna Nome.
    3. Clique em Reinicialização/substituição gradual, como no exemplo a seguir:

      Reinicialização gradual do Compute Engine

    4. Na próxima tela, clique em Reiniciar.

      Isso reinicia a instância do Envoy.