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.
Selecione Desenvolver > Proxies de API na visualização principal.
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 criou nenhum
proxy, a lista estará vazia.
Clique em +Proxy na parte superior direita.
O Assistente de proxy da API é iniciado
Selecione Inverter proxy (mais comum) e clique em Avançar.
A visualização Detalhes do proxy é exibida.
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:
Clique em Próxima.
Na tela Políticas, selecione Passar por (nenhum) como a
opção de segurança:
Clique em Próxima.
Na tela Resumo, clique em Criar.
O híbrido gera o proxy (às vezes chamado de pacote de proxy):
Clique em Sair.
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:
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:
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".
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".
Selecione "1", a revisão que você quer implantar, na lista suspensa.
A IU solicita que você confirme a implantação:
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.
Há 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.
Se você usou o caractere curinga "*" para a propriedade envs.hostAlias,
conforme instruído em Configurar o cluster,
siga estas etapas antes de continuar:
Consiga o IP externo para o
serviço istio-ingressgateway. Exemplo:
kubectl get services -n istio-system
Na saída, você verá algo como isto, em que
34.68.41.240 é o endereço IP de entrada externo:
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S)
istio-ingressgateway LoadBalancer 10.43.255.19 34.68.41.240 80:31381/TCP,443:31391
Copie o valor de EXTERNAL-IP a ser usado na próxima etapa. Neste
exemplo, você copiaria 34.68.41.240.
Chame o proxy usando cURL ou o cliente REST da sua escolha:
curl -v -k https://34.68.41.240/myproxy
Se a chamada for bem-sucedida, você verá a seguinte saída:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-28 UTC."],[[["\u003cp\u003eThis documentation pertains to version 1.1 of Apigee hybrid, which is no longer supported and should be upgraded.\u003c/p\u003e\n"],["\u003cp\u003eYou can create a new API proxy in the Apigee UI using the API Proxy Wizard by selecting "Reverse proxy" and configuring the proxy details.\u003c/p\u003e\n"],["\u003cp\u003eAfter creating a new proxy, it needs to be deployed to the cluster via the hybrid UI to be accessible.\u003c/p\u003e\n"],["\u003cp\u003eDeploying a proxy involves selecting the revision in the hybrid UI and confirming the deployment, noting that the deployment process is not immediate.\u003c/p\u003e\n"],["\u003cp\u003eYou can call the newly deployed API proxy using cURL or a REST client, after ensuring the \u003ccode\u003eistio-ingressgateway\u003c/code\u003e service's external IP is available if using a wildcard host alias.\u003c/p\u003e\n"]]],[],null,["# Create and deploy a new API proxy\n\n| You are currently viewing version 1.1 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nNow that you've configured and the hybrid UI, and installed and configured the\nruntime, you're ready to see how it all works together.\n\nThis section walks you through the following:\n\n1. **[Create a new API proxy](#create-proxy)** in the Apigee UI using the API Proxy Wizard\n2. **[Deploy your new proxy](#deploy)** to your cluster with the UI\n\n1. Create a new API proxy using the hybrid UI\n---------------------------------------------\n\nThis section describes how to create a new API proxy in the UI by using the API Proxy Wizard.\n\n**To create a simple API proxy using the API Proxy Wizard:**\n\n1. Open [Apigee UI](https://apigee.google.com) in a browser.\n2. Select **Develop \\\u003e API Proxies** in the main view.\n3. From the **Environment** drop-down list, select the environment in which you want to create a new API proxy. This section assumes the name of the environment is \"test\". You created at least one environment in [Step 5: Add an environment](/apigee/docs/hybrid/v1.1/precog-add-environment).\n\n The hybrid UI displays a list of API proxies for that environment. If you haven't created any\n proxies yet, the list is empty.\n4. Click **+Proxy** in the upper right.\n\n The API Proxy Wizard starts\n5. Select **Reverse proxy** (most common), and click **Next** .\n\n The **Proxy details** view is displayed.\n6. Configure your proxy with the following settings:\n - **Proxy Name:** Enter \"myproxy\". The remaining steps in this section assume that this is your proxy's ID.\n - **Proxy Base Path:** Automatically set to \"/myproxy\". The **Proxy Base\n Path** is part of the URL used to make requests to your API. Edge uses the URL to match and route incoming requests to the proper API proxy.\n - (Optional)**Description:** Enter a description for your new API proxy, such as \"Testing Apigee hybrid with a simple proxy\".\n - **Target (Existing API):** Enter \"https://mocktarget.apigee.net\". This defines the target URL that Apigee invokes on a request to the API proxy. The mocktarget service is hosted at Apigee and returns simple data. It requires no API key or access token.\n\n Your API proxy's details should look like the following:\n\n7. Click **Next**.\n8. On the **Policies** screen, select **Pass through (none)** as the security option.\n9. Click **Next**.\n10. On the **Summary** screen, click **Create** .\n\n Hybrid generates the proxy (sometimes referred to as *the proxy bundle*):\n\n | **NOTE:** In this case, the hybrid UI does *not* deploy the proxy to your cluster. You will do this in [the next step](#deploy).\n11. Click **Exit** .\n\n Hybrid displays the **Proxies** view, which displays a list of API proxies. The\n new proxy should be at the top of the list, with a gray status indicator, meaning that it has\n not yet been deployed.\n\n2. Deploy your proxy to the cluster using the hybrid UI\n-------------------------------------------------------\n\nAfter creating a new proxy, you must deploy it so that you can try it out. This section\ndescribes how to deploy your new proxy using the hybrid UI.\n\n**To deploy an API proxy in the hybrid UI:**\n\n1. In the hybrid UI, select **Develop \\\u003e API Proxies** .\n\n Be sure the \"test\" environment is selected.\n\n The UI displays your new proxy in the proxies list:\n\n2. Click on the \"myproxy\" proxy.\n\n The UI displays the **API Proxies Overview** tab for that proxy.\n\n Notice that under **Deployments** , the **Revision** column shows\n \"Not deployed\".\n3. In the **Revision** column, expand the drop-down selector to choose the revision to deploy.\n\n The drop down list displays only \"1\" and \"Undeploy\".\n4. Select \"1\"---the revision that you want to deploy---from the drop down list.\n\n The UI prompts you to confirm the deployment:\n\n5. Click **Deploy** .\n\n The UI begins the process of deploying revision 1 of your new proxy to the cluster.\n\n Note that deployment is not an instantaneous process. Hybrid's \"eventually consistent\"\n deployment model means that a new deployment will be rolled out to the cluster over a short\n period of time and not immediately.\n\nWhile there are [several ways](/apigee/docs/api-platform/deploy/ui-deploy-overview#viewing-deployment-status) to check the\ndeployment status of a proxy in the UI, the next two steps explain how to call the API proxy\nyou just deployed and how\nto check the deployment status with a call to the [Apigee APIs](/apigee/docs/reference/apis/apigee/rest).\n\n3. Call the API proxy\n---------------------\n\nWhen the [UI indicates\nyour proxy is deployed](/apigee/docs/hybrid/v1.1/ui-deploy-overview#view-deployment-status), you can try calling it:\n\n1. If you used the wildcard character '\\*' for the `envs.hostAlias` property as instructed in [Configure the cluster](/apigee/docs/hybrid/v1.1/install-copy-overrides), follow these steps before continuing:\n 1. Get the external IP for the `istio-ingressgateway` service. For example: \n\n ```\n kubectl get services -n istio-system\n ```\n\n In the output, you will see something like this, where\n `34.68.41.240` is the external ingress IP address: \n\n ```\n NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S)\n istio-ingressgateway LoadBalancer 10.43.255.19 34.68.41.240 80:31381/TCP,443:31391\n ```\n 2. Copy the value of the `EXTERNAL-IP` to use in the next step. In this example, you would copy `34.68.41.240`.\n2. Call the proxy using cURL or the REST client of your choice: \n\n ```\n curl -v -k https://34.68.41.240/myproxy\n ```\n\n If the call succeeds, you will see the following output: \n\n ```\n Hello, Guest!\n ```\n\n\n*[Google Cloud]: Google Cloud"]]
