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

Permissões exigidas para a tarefa

A criação e a implantação de proxies precisam de um conjunto mínimo de permissões. Se você tiver o papel de administrador da organização da Apigee, conclua esta tarefa. Para saber mais sobre outros papéis que você pode implantar, consulte Papéis da Apigee.

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

Observação: há uma nova versão da IU da Apigee, que está integrada ao console do Google Cloud. A nova interface é chamada de Apigee no console do Cloud. As instruções nas duas primeiras guias abaixo explicam como usar a Apigee no console do Cloud ou a Apigee clássica.

interface da Apigee no console do Cloud

Para criar e implantar seu primeiro proxy:

1. Abra a interface da Apigee no console do Cloud 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.

    Observação: o proxy não é implantado por inteiro instantaneamente. A implantação do proxy pode levar até um minuto para ser concluída.
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.

    Observação: o proxy não é implantado por inteiro instantaneamente. A implantação do proxy pode levar até um minuto para ser concluída.
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:
   Observação: as alterações de DNS são publicadas imediatamente, mas podem levar um tempo para se propagar. Devido a esse atraso, talvez seja necessário aguardar até uma hora para chamar o proxy de amostra.

   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

• Faça um tour pelos tutoriais da Apigee, incluindo:
  • Proteção contra picos de tráfego repentinos.
  • Como receber uma visão detalhada do fluxo de solicitação/resposta.