Criar e implantar um novo proxy de API

Agora que você configurou o Google Cloud e a IU híbrida e instalou e configurou o ambiente de execução, está pronto para ver como tudo funciona em conjunto.

Esta seção mostra as seguintes informações:

  1. Criar um novo proxy de API na IU da Apigee usando o Assistente de proxy de API
  2. Implantar seu novo proxy no cluster com a IU

1. Criar um novo proxy de API usando a IU híbrida

Nesta seção, descrevemos como criar um novo proxy de API na interface do usuário usando o Assistente de proxy de API.

Para criar um proxy de API simples usando o Assistente de proxy de API:

  1. Abra a IU da Apigee em um navegador.
  2. Selecione Desenvolver > Proxies de API na visualização principal.
  3. Na lista suspensa Ambiente, selecione o ambiente em que você quer criar um novo proxy de API. Esta seção pressupõe que o nome do ambiente é "teste". Você criou pelo menos um ambiente na Etapa 5: adicionar um ambiente.

    A IU híbrida exibe uma lista de proxies de API para esse ambiente. Se você ainda não tiver criado nenhum proxy, a lista estará vazia.

  4. Clique em +Proxy na parte superior direita. O Assistente de proxy da API é iniciado:
  5. Selecione Inverter proxy (mais comum) e clique em Avançar.

    A visualização Detalhes do proxy é exibida.

  6. Defina seu proxy com as seguintes configurações:
    • Nome do proxy: digite "myproxy". As demais etapas desta seção presumem que este é o ID do seu proxy.
    • Caminho base do proxy: definido automaticamente como "/myproxy". O Caminho base do proxy faz parte do URL usado para fazer solicitações à API. O Edge usa o URL para corresponder e rotear solicitações de entrada para o proxy da API apropriado.
    • (Opcional) Descrição: insira uma descrição para o novo proxy de API, por exemplo, "Como testar a Apigee híbrida com um proxy simples".
    • Destino (API atual): insira "https://mocktarget.apigee.net". Isso define o URL de destino que a Apigee invoca em uma solicitação para o proxy da API. O serviço simulado está hospedado na Apigee e retorna dados simples. Ele não requer nenhuma chave de API nem um token de acesso.

    Os detalhes do proxy da API precisam ser semelhantes a este:

  7. Clique em Próxima.
  8. Na tela Políticas, selecione Passar (sem autorização) como a opção de segurança.
  9. Clique em Próxima.
  10. Na tela Resumo, clique em Criar.

    O híbrido gera o proxy (às vezes chamado de pacote de proxy):

  11. Clique em Ir para a lista de proxy.

    A visualização híbrida exibe a visualização de Proxies, que exibe uma lista de proxies da API. O novo proxy precisa estar no topo da lista, com um indicador de status cinza, o que significa que ele ainda não foi implantado.

2. Implantar o proxy no cluster usando a IU híbrida

Após criar um novo proxy, você precisa implantá-lo para poder testá-lo. Nesta seção, descrevemos como implantar seu novo proxy usando a IU híbrida.

Para implantar um proxy de API na IU híbrida:

  1. Na IU híbrida, selecione Desenvolver > Proxies de API.

    Verifique se o ambiente "teste" está selecionado.

    A IU exibe seu novo proxy na lista de proxies:

  2. Clique no proxy "myproxy".

    A IU exibe a guia Visão geral dos proxies da API desse proxy.

    Em Implantações, a coluna Revisão mostra "Não implantado".

  3. Na coluna Revisão, expanda o seletor suspenso para escolher a revisão a ser implantada.

    A lista suspensa exibe apenas "1" e "Cancelar implantação".

  4. Selecione "1", a revisão que você quer implantar, na lista suspensa.

    A IU solicita que você confirme a implantação:

  5. Clique em Implantar.

    A IU inicia o processo de implantação da revisão 1 do novo proxy no cluster.

    Observe que a implantação não é um processo instantâneo. No modelo de implantação de "consistência posterior" do ambiente híbrido, uma nova implantação será implementada no cluster por um curto período, e não imediatamente.

várias maneiras de verificar o status de implantação de um proxy na IU, mas as próximas duas etapas explicam como chamar o proxy de API que você acabou de implantar e como verificar o status da implantação com uma chamada para as APIs da Apigee.

3. Chamar o proxy da API

Siga as etapas abaixo, dependendo se você pode ou não atualizar o registro DNS do nome do host usado para criar o grupo de ambiente.

Se não for possível atualizar o DNS do nome do host

Siga estas etapas se o nome do host do grupo de ambiente não estiver registrado ou não for possível atualizar o registro DNS. Nestas etapas, você receberá o IP de entrada e o usará diretamente em uma chamada de cURL com a sinalização --resolve:

  1. Exporte o IP de entrada:
    export INGRESS_IP=$(kubectl -n istio-system get service \
      istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
  2. Exporte o número da porta de entrada segura:
    export SECURE_INGRESS_PORT=$(kubectl -n istio-system get \
      service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name=="https")].port}')
  3. Exporte o alias de host do grupo de ambiente para uma variável:
    export HOSTALIAS=your_host_alias
  4. Chame o proxy de API. A sinalização --resolve em cURL permite especificar diretamente o IP de entrada:
    curl  -H Host:$HOSTALIAS --resolve \
      $HOSTALIAS:$SECURE_INGRESS_PORT:$INGRESS_IP  \
      https://$HOSTALIAS:$SECURE_INGRESS_PORT/myproxy -k

Se você consegue atualizar o DNS do nome do host

Siga estas etapas se o nome do host usado ao criar o grupo de ambiente estiver registrado e você puder atualizar o registro DNS para que aponte para o IP de entrada externo:

  1. Exporte o IP externo da entrada para uma variável:
    export INGRESS_IP=$(kubectl -n istio-system get service \
      istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
  2. Verifique se a variável contém o endereço IP. Exemplo:
    echo $INGRESS_IP
    34.118.196.202
  3. Use esse endereço IP para atualizar o registro DNS (geralmente um registro A ou CNAME) no seu registrador ou provedor de DNS. Talvez seja necessário aguardar até uma hora para que a mudança do registro DNS seja propagada.
  4. Exporte o alias de host do grupo de ambiente para uma variável:
    export HOSTALIAS=your_host_alias
  5. Chamar o proxy da API
    curl -k https://$HOSTALIAS/myproxy

    Exemplo:

    curl -v -k https://apitest.acme.com/myproxy

    Se a chamada for bem-sucedida, você verá a seguinte saída:

    Hello, Guest!