Próximas etapas recomendadas

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 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 IU. 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: implantar (opcional):
    • Ambientes de implantação: opcional. Use as caixas de seleção para escolher um ou mais ambientes em que o proxy vai ser implantado. Se preferir não implantar o proxy neste ponto, deixe o campo Ambientes de implantação em branco. O proxy poderá ser implantado posteriormente.
    • Conta de serviço: opcional Anexe uma conta de serviço à implantação para permitir que seu proxy acesse os serviços do Google Cloud, conforme especificado no papel e nas permissões da conta de serviço.
  9. Clique em Criar.

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

  10. A página Resumo do proxy do proxy recém-criado é aberta. 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.
  11. No painel de navegação à esquerda, selecione Gerenciamento > Ambientes > Grupos de ambientes.
  12. 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 interface. 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 novo.
  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. Clique em Visualizar no console do Google Cloud.
  16. 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.
  17. Feche o console do Google Cloud.

Chamar o proxy com acesso interno

Se você concedeu acesso interno na Etapa 4: personalizar 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 4: personalizar 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 da página Ambientes > Grupos de ambientes.

    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