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:
- Abra https://console.cloud.google.com/apigee em um navegador.
- 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.
- No painel de navegação à esquerda, clique em Desenvolvimento de proxy > Proxies de API.
- Clique em + Criar.
A página Criar um proxy é aberta.
- Na caixa Modelo de proxy, selecione Proxy reverso (mais comum).
- 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
- Clique em Próxima.
- Na Etapa 2: políticas, em Segurança: autorização, selecione Passar (sem autorização).
- Clique em Próxima.
- Na Etapa 3: implantar (opcional), selecione o ambiente em que o proxy será implantado e clique em OK.
- Clique em Criar.
Seu novo proxy de API é criado e implantado no ambiente selecionado.
- 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.
- No painel de navegação à esquerda, selecione Gerenciamento > Ambientes > Grupos de ambientes.
- 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:
- Faça login na IU da Apigee.
- 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.
- Clique em API Proxies na visualização principal.
- Na lista suspensa Selecionar ambiente, selecione um ambiente.
- Clique em Criar nova.
- Clique em Proxy reverso (mais comum).
- 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
- Clique em Próxima.
- Na página Políticas comuns, em Segurança: autorização, selecione Transmitir (sem autorização).
- Clique em Próxima.
- Na página Resumo, em Implantação opcional, selecione o ambiente em que o proxy será implantado.
- Clique em Criar e implantar.
O novo proxy de API é criado e implantado no ambiente selecionado.
- 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.
- No painel de navegação à esquerda, selecione Administrador > Ambientes > Grupos.
- 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:
- 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 desales.example.com
para o endereço10.23.0.2
. - Use o Google Cloud DNS para mapear um URL para um endereço IP.
- 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
- 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. - O valor do cabeçalho
Próximas etapas
- Faça um tour pelos tutoriais da Apigee, incluindo: