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.- Crie estas variáveis de ambiente
- Verifique os detalhes dos intervalos de endereços atuais e verifique se eles não se sobrepõem ao novo intervalo.
- 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:
- Confira os detalhes do intervalo de endereços antigo e do novo
- Verifique os detalhes do peering de VPC:
- Execute o seguinte comando para atualizar a solicitação de conexão:
- Verifique os detalhes do peering de VPC:
RANGE_NAME_1=YOUR_RANGE_NAME_1 RANGE_NAME_2=YOUR_RANGE_NAME_2 NETWORK_NAME=YOUR_NETWORK_NAME
gcloud compute addresses list --global --project=$PROJECT_ID
gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID
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.
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
gcloud services vpc-peerings list \ --network=$NETWORK_NAME \ --service=servicenetworking.googleapis.com \ --project=$PROJECT_ID
gcloud services vpc-peerings update --service=servicenetworking.googleapis.com --network=$NETWORK_NAME --ranges=$RANGE_NAME_1,$RANGE_NAME_2 --project=$PROJECT_ID
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:
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
- Você inseriu o URL de endpoint/solicitação incorreto. Verifique se você especificou
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 um403
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:
- Abra o Console do Cloud.
- 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.
- 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.
- 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.
- Tente executar uma reinicialização gradual no grupo de instâncias no Console do Cloud:
- Selecione Compute Engine > Grupos de instâncias.
- Na lista de grupos de instâncias, clique naquela que não está respondendo na coluna Nome.
- Clique em Reinicialização/substituição gradual, como no exemplo a seguir:
- 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:
Abra a IU da Apigee.
- Acesse Administrador > Instâncias.
- Anote o endereço IP da instância. Você vai precisar desse IP mais adiante.
Por exemplo,
10.117.200.2
. No Console do Google Cloud, acesse a página Modelos de instância.
- 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.
- Role para baixo para encontrar o IP do
ENDPOINT
na seção Metadados personalizados. - 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.