Visão geral sobre a solução de problemas

Esta página traz informações gerais e links para outras páginas para saber mais sobre a solução de problemas.

Erros de implantação das configurações do Endpoints

Se você tiver recebido uma mensagem de erro do comando gcloud endpoints services deploy, consulte Como solucionar problemas na implantação na configuração do Endpoints.

Erros de implantação do back-end da API

A implantação da API e do Extensible Service Proxy (ESP) em um back-end do Google Cloud Platform (GCP) depende da plataforma. Consulte os seguintes guias de solução de problemas para saber mais:

Erros de resposta

Quando enviar uma solicitação para a API e receber uma resposta de erro, consulte Como solucionar problemas em erros de resposta para saber mais sobre como solucionar o erro.

Como verificar os serviços obrigatórios

No mínimo, o Endpoints e o ESP exigem os seguintes serviços:

  • API Service Management (servicemanagement.googleapis.com)
  • API Service Control (servicecontrol.googleapis.com)
  • Google Cloud Endpoints (endpoints.googleapis.com)
  • Stackdriver Logging (logging.googleapis.com)

Observe que esses serviços também podem ter dependências.

Com exceção dos serviços obrigatórios para hospedar a API no GCP, depois de criar um projeto do GCP e implantar a configuração do Endpoints usando o comando gcloud endpoints services deploy, todos os serviços que o Endpoints e o ESP exigem serão ativados.

Use o procedimento a seguir para conseguir a lista de serviços obrigatórios. Consulte a referência do gcloud para mais informações sobre os comandos a seguir.

Para conseguir a lista de serviços obrigatórios:

  1. Crie um projeto de teste substituindo PROJECT_ID por um código de projeto exclusivo. Os códigos de projeto precisam começar com letra minúscula e podem conter letras ASCII minúsculas, números e hifens. O código precisa ter entre 6 e 30 caracteres.

    gcloud projects create PROJECT_ID
  2. Defina o projeto recém-criado como padrão.

    gcloud config set project PROJECT_ID
  3. Salve uma cópia do arquivo openapi.yaml da amostra do getting-started na máquina local.

  4. Abra o arquivo openapi.yaml e, no campo host, substitua o texto pelo nome do serviço Endpoints, que precisa estar no formato a seguir.

    host: "echo-api.endpoints.YOUR_PROJECT_ID.cloud.goog"
  5. Salve o arquivo openapi.yaml.

  6. No diretório em que você salvou o arquivo openapi.yaml, implante a configuração do Endpoints.

    gcloud endpoints services deploy openapi.yaml
  7. Consiga uma lista de todos os serviços ativados.

    gcloud services list
  8. Depois de copiar a lista de serviços obrigatórios, exclua o projeto de teste.

    gcloud projects delete PROJECT_ID
  9. Compare a lista de serviços ativados no projeto de teste com os que estão ativados no seu projeto.

Como verificar informações de depuração

Executar a ferramenta de linha de comando gcloud com detalhamento de depuração ajudará no processo.

gcloud --verbosity=debug COMMAND

Esse comando faz com que a ferramenta de linha de comando gcloud imprima um registro detalhado do erro. Dependendo do comando em execução, a saída pode incluir informações de solicitação e resposta do servidor.

Como ativar um serviço

É possível verificar se um serviço está habilitado usando gcloud.

gcloud services list

Para exibir a configuração de um serviço específico, use o seguinte comando:

gcloud endpoints services describe SERVICE_NAME

OAuth do proxy falha e ainda pede passagem

Verifique se há uma seção authentication que contenha sua definição de OAuth no arquivo de configuração da API gRPC. Um exemplo de arquivo de configuração está disponível em Amostra de Bookstore no GitHub.

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Cloud Endpoints com gRPC
Precisa de ajuda? Acesse nossa página de suporte.