Etapa 8: implantar e chamar um proxy de amostra

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

O que você está fazendo nesta etapa

Siga as etapas abaixo para criar e implantar um proxy de API de teste. Por fim, teste o proxy de API enviando uma solicitação HTTP para ele.

Criar e implantar um proxy de API

O processo de provisionamento da Apigee não cria e implanta automaticamente um proxy de API. É necessário criar e implantar um proxy manualmente.

interface da Apigee no console do Cloud

Para criar e implantar seu primeiro proxy:

  1. Abra https://console.cloud.google.com/apigee em um navegador.
  2. Verifique se o nome da sua organização está selecionado no menu suspenso no canto superior esquerdo da interface. O nome da organização é o mesmo que o nome do projeto do Google Cloud.
  3. No painel de navegação à esquerda, clique em Desenvolvimento de proxy > Proxies de API.
  4. Clique em + Criar.

    A página Criar um proxy é aberta.

  5. Na caixa Modelo de proxy, selecione Proxy reverso (mais comum).
  6. Na Etapa 1: detalhes do proxy, configure o proxy com os seguintes valores:
    Nome do parâmetro Valor
    Nome do proxy hello-world
    Caminho base /hello-world
    Target (Existing API) mocktarget.apigee.net
  7. Clique em Próxima.
  8. Na Etapa 2: políticas, em Segurança: autorização, selecione Passar (sem autorização).
  9. Clique em Próxima.
  10. Na Etapa 3: implantar (opcional), selecione o ambiente em que o proxy será implantado e clique em OK.
  11. Clique em Criar.

    Seu novo proxy de API é criado e implantado no ambiente selecionado.

  12. A página Resumo do proxy para o proxy recém-criado será exibida. Uma marca de seleção verde em Status indica que o proxy foi implantado com sucesso. Se o proxy não for implantado, consulte Como implantar um proxy de API e siga as etapas para implantá-lo manualmente.
  13. No painel de navegação à esquerda, selecione Gerenciamento > Ambientes > Grupos de ambientes.
  14. Copie o nome do host do grupo de ambientes. Você usará esse nome do host para chamar o proxy de API nas próximas etapas.

IU da Apigee

Para criar e implantar seu primeiro proxy:

  1. Faça login na IU da Apigee.
  2. Verifique se o nome da sua organização está selecionado no menu suspenso no canto superior esquerdo da IU. O nome da organização é o mesmo que o nome do projeto do Google Cloud.
  3. Clique em API Proxies na visualização principal.
  4. Na lista suspensa Selecionar ambiente, selecione um ambiente.
  5. Clique em Criar nova.
  6. Clique em Proxy reverso (mais comum).
  7. Na página Detalhes do proxy, configure o proxy com os seguintes valores:
    Nome do parâmetro Valor
    Nome hello-world
    Caminho base /hello-world
    Target (Existing API) https://mocktarget.apigee.net
  8. Clique em Próxima.
  9. Na página Políticas comuns, em Segurança: autorização, selecione Transmitir (sem autorização).
  10. Clique em Próxima.
  11. Na página Resumo, em Implantação opcional, selecione o ambiente em que o proxy será implantado.
  12. Clique em Criar e implantar.

    O novo proxy de API é criado e implantado no ambiente selecionado.

  13. Clique em Ir para a lista de proxy. Uma marca de seleção verde em Status indica que o proxy foi implantado com sucesso. Se o proxy não for implantado, consulte Como implantar um proxy de API e siga as etapas para implantá-lo manualmente.
  14. No painel de navegação à esquerda, selecione Administrador > Ambientes > Grupos.
  15. Copie o nome do host do grupo de ambientes. Você usará esse nome do host para chamar o proxy de API nas próximas etapas.

Chamar o proxy com acesso interno

Se você concedeu acesso interno na Etapa 7: configurar o roteamento de acesso, siga as instruções em: Como chamar um proxy de API com acesso somente interno

Chamar o proxy com acesso externo

Se você permitiu o acesso externo na Etapa 7: configurar o roteamento de acesso, siga estas etapas:

  1. Configure uma entrada DNS para o host. Veja duas maneiras de realizar essa tarefa:
    • No registrador, crie um registro A que aponte o nome do host do grupo de ambientes para o IP mostrado na página do assistente em Configurar DNS. Por exemplo, se o nome do host for sales.example.com e o IP for 10.23.0.2, aponte o registro de sales.example.com para o endereço 10.23.0.2.
    • Use o Google Cloud DNS para mapear um URL para um endereço IP.
  2. Teste o proxy de API enviando a seguinte solicitação em uma janela de terminal:
    curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \
      https://YOUR_INSTANCE_IP_OR_DNS/hello-world

    Em que:

    • O valor do cabeçalho Host (YOUR_ENV_GROUP_HOSTNAME) é o nome do host definido no grupo de ambiente na Etapa 6: criar um ambiente.

    Uma solicitação bem-sucedida retorna a string: Hello, Guest!. Se a solicitação não for bem-sucedida, consulte Solução de problemas.

Próximas etapas