Resolução de problemas da instalação do Apigee

Esta página aplica-se ao Apigee, mas não ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

Este documento apresenta erros comuns e descreve possíveis resoluções para quando instala e configura o Apigee.

Criar uma nova instância

Esta secção descreve erros comuns e possíveis resoluções após o envio de um pedido ao Apigee para criar uma nova instância:

  • 401 (UNAUTHENTICATED) indica que as suas credenciais podem ter expirado. Experimente renovar o token de autorização, como mostra o exemplo seguinte: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • RANGES_EXHAUSTED indica que não foi possível satisfazer o intervalo de endereços IP que pediu inicialmente e que tem de pedir um novo intervalo. Inicialmente, criou um pedido de intervalo no Passo 2: configure a rede.
    1. Crie estas variáveis de ambiente 
      2. RANGE_NAME_1=YOUR_RANGE_NAME_1
  RANGE_NAME_2=YOUR_RANGE_NAME_2
  NETWORK_NAME=YOUR_NETWORK_NAME
    2. Valide os detalhes dos intervalos de endereços existentes e certifique-se de que não se sobrepõem ao novo intervalo. 
      3.  gcloud compute addresses list --global --project=$PROJECT_ID
       
       gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID
    3. Para pedir um novo intervalo a partir do qual o Apigee escolhe um endereço IP para as ligações de serviços privados, execute o seguinte comando gcloud: 
      4.  gcloud compute addresses create $RANGE_NAME_2
            --project=$PROJECT_ID --global --prefix-length=16
            --description="additional peering range for Google services" --network=$NETWORK_NAME
            --purpose=VPC_PEERING

      Este comando cria um novo intervalo com o nome $RANGE_NAME_2.

    4. Valide os detalhes do intervalo de endereços antigo e novo 
      5.  gcloud compute addresses list --global --project=$PROJECT_ID 
       gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID 
       gcloud compute addresses describe $RANGE_NAME_2 --global --project=$PROJECT_ID
    5. Valide os detalhes da interligação de VPC existente: 
      6.  gcloud services vpc-peerings list \
            --network=$NETWORK_NAME \
            --service=servicenetworking.googleapis.com \
            --project=$PROJECT_ID
    6. Execute o seguinte comando para atualizar o seu pedido de associação: 
      7.  gcloud services vpc-peerings update
            --service=servicenetworking.googleapis.com --network=$NETWORK_NAME
            --ranges=$RANGE_NAME_1,$RANGE_NAME_2 --project=$PROJECT_ID
    7. Valide os detalhes da interligação de VPC existente: 
      8.  gcloud services vpc-peerings list \
            --network=$NETWORK_NAME \
            --service=servicenetworking.googleapis.com \
            --project=$PROJECT_ID

Criar uma organização do Apigee

O exemplo seguinte mostra um erro comum que o Apigee pode apresentar quando tenta criar uma organização pela primeira vez:

  Apigee API (staging) has not been used in project 59387731598 before or it is disabled. 
  Enable it by visiting https://console.developers.google.com/apis/api/staging-apigee.sandbox.googleapis.com/overview?project=59387731598 then retry. 
  If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry.

Isto significa que uma ou mais das APIs necessárias não estão ativadas. Reveja as APIs indicadas no Passo 1: ative as APIs necessárias e certifique-se de que todas as APIs estão ativadas antes de continuar.

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

  • 401 (UNAUTHENTICATED) indica que as suas credenciais podem ter expirado. Experimente renovar o token de autorização, como mostra o exemplo seguinte: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • 404 (Not Found) pode ser o resultado do seguinte:
    • Introduziu o URL do pedido/ponto final errado. Verifique se especificou apigee.googleapis.com para o domínio da chamada API.
    • O seu projeto pode ainda não ter sido aprovisionado. Contacte a equipa de vendas da Apigee.
  • Normalmente, 409 (Conflict) indica que o nome da organização indicado já existe. Os nomes das organizações têm de ser globalmente exclusivos. Escolha outro nome para a organização e reemita o comando. (Especifica o nome na carga útil do pedido se estiver a criar uma organização na linha de comandos. Tenha em atenção que tem de criar uma organização com o mesmo nome do seu projeto. Por isso, isto não deve acontecer, a menos que tenha cometido um erro de digitação.)

Segue-se um possível erro que o Apigee pode devolver quando verifica o estado de um novo pedido de organização:

  • 403 (Permission Denied) pode indicar que a organização ainda não foi criada. Aguarde mais um minuto e tente novamente. Se o Apigee devolver um 403 quando tentar criar a nova organização pela primeira vez, pode significar que uma ou mais das suas APIs não foram ativadas. Certifique-se de que ativou todas as APIs conforme descrito no Passo 1: ative as APIs necessárias .

Implementação de amostras

O balanceador de carga não está em bom estado

Quando implementa um proxy de exemplo, o Apigee pode devolver um erro HTTP 502 (Bad Gateway). Neste caso, experimente o seguinte:

  1. Verifique o estado do balanceador de carga. O separador Equilibrador de carga mostra todos os equilibradores de carga do projeto e os respetivos estados. Um triângulo amarelo indica que o serviço de back-end do balanceador de carga não está em bom estado.

    Na Google Cloud consola, aceda à página Serviços de rede > Equilíbrio de carga.

    Aceda a Balanceamento de carga

  2. Depois de confirmar um problema com o equilibrador de carga, verifique as VMs na instância de tempo de execução para garantir que estão em funcionamento e em bom estado.
  3. Consulte os ficheiros de registo para ver se consegue encontrar um erro ou outro tipo de problema que possa ter originado um problema. Para mais informações sobre como ativar e ver registos, consulte o artigo Ver registos.
  4. Experimente fazer um reinício progressivo no grupo de instâncias na Cloud Console:

    1. Na Google Cloud consola, aceda à página Compute Engine > Grupos de instâncias.

      Aceda a Grupos de instâncias

    2. Na lista de grupos de instâncias, clique no que não está a responder na coluna Nome.
    3. Clique em Reinício/substituição progressiva.
    4. No ecrã seguinte, clique em Reiniciar.

      Esta ação reinicia a instância do Envoy.

IP da instância incorreto

Se, em qualquer altura, eliminar e recriar a sua instância do Apigee, o IP da instância do Apigee é alterado e pode ficar dessincronizado com o IP do ponto final do modelo do grupo de instâncias gerido (MIG). Por exemplo, o modelo do MIG continua a ter o IP antigo da instância eliminada. O modelo de MIG foi criado durante o processo de aprovisionamento do Apigee. Nesta situação, experimente os seguintes passos para atualizar o modelo MIG com o IP do Apigee correto:

  1. Na Google Cloud consola, aceda à página Apigee > Administração > Instâncias.

    Aceda a Instâncias

  2. Tome nota do endereço IP da instância. Vai precisar de saber este IP num passo posterior. Por exemplo: 10.117.200.2.

  3. Na Google Cloud consola, aceda à página Modelos de instâncias.

    Aceda a Modelos de instâncias

  4. Abra o modelo de instância. Tem de abrir o modelo de instância usado pelo back-end mapeado para o equilibrador de carga.
  5. Desloque a página para baixo para encontrar o ENDPOINT IP na secção Metadados personalizados.
  6. Se o IP do ponto final for diferente do que anotou na IU do Apigee, tem de alterar o IP do modelo de instância para corresponder ao IP da instância do Apigee. Consulte o artigo Alterar IPs de instâncias.