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

Esta página se aplica à Apigee, mas não à Apigee híbrida.

Confira a documentação da Apigee Edge.

Neste documento, listamos os erros comuns e as possíveis resoluções para instalar e configurar a Apigee.

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 2: configurar 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
    3. Verifique os detalhes dos intervalos de endereços atuais e verifique se eles não se sobrepõem ao novo intervalo.
    4.  gcloud compute addresses list --global --project=$PROJECT_ID
       gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID 
    5. Para solicitar um novo intervalo em que a Apigee escolha um endereço IP para as conexões de serviço particulares, execute o comando gcloud a seguir:
    6.  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 

      Esse comando cria um novo intervalo chamado $RANGE_NAME_2.

    7. Confira os detalhes do intervalo de endereços antigo e do novo
    8.  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 
    9. Verifique os detalhes do peering de VPC:
    10.  gcloud services vpc-peerings list \
                  --network=$NETWORK_NAME \
                  --service=servicenetworking.googleapis.com \
                  --project=$PROJECT_ID 
    11. Execute o seguinte comando para atualizar a solicitação de conexão:
    12.  gcloud services vpc-peerings update
                  --service=servicenetworking.googleapis.com --network=$NETWORK_NAME
                  --ranges=$RANGE_NAME_1,$RANGE_NAME_2 --project=$PROJECT_ID 
    13. Verifique os detalhes do peering de VPC:
    14.  gcloud services vpc-peerings list \
                  --network=$NETWORK_NAME \
                  --service=servicenetworking.googleapis.com \
                  --project=$PROJECT_ID 

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 1: ativar as APIs necessárias 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. Você precisa ter ativado todas as APIs conforme descrito na Etapa 1: ativar as APIs necessárias.

Como implantar amostras

O balanceador de carga não está íntegro

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 incorreção que possa causar um problema. Para mais informações sobre como ativar e visualizar registros, consulte esta página.
  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.

IP da instância incorreto

Se, a qualquer momento, você excluir e recriar sua instância da Apigee, o IP dessa instância muda e pode ficar fora de sincronia com o IP do endpoint do modelo de grupo de instâncias gerenciadas (MIG). Por exemplo, o modelo de MIG ainda terá o IP antigo da instância excluída. O modelo de MIG foi criado durante o processo de provisionamento da Apigee. Nesse caso, tente as seguintes etapas para atualizar o modelo de MIG com o IP correto da Apigee:

  1. Abra a IU da Apigee.

    Acessar a IU da Apigee

  2. Acesse Administrador > Instâncias.
  3. Anote o endereço IP da instância. Você vai precisar desse IP mais adiante. Por exemplo, 10.117.200.2.
  4. No Console do Google Cloud, acesse a página Modelos de instância.

    Acesse "Modelos de instância"

  5. Abra o modelo de instância. Você precisa abrir o modelo de instância usado pelo back-end que é mapeado para o balanceador de carga.
  6. Role para baixo para encontrar o IP do ENDPOINT na seção Metadados personalizados.
  7. Se o IP do endpoint for diferente do que você copiou da IU da Apigee, altere o IP do modelo de instância para corresponder ao IP da instância da Apigee. Consulte Alterar IPs de instâncias.