O Google recomenda criar endereços IP estáticos para os dois gateways de entrada que
são expostos fora do cluster:
Gateway
Descrição
apigee-mart-istio-ingressgateway
O gateway de entrada do Istio usado pelo serviço MART para se comunicar com o plano de gerenciamento.
istio-ingressgateway
O gateway de entrada do Istio usado para enviar e receber o tráfego de proxy da API pelos balanceadores de carga do
processador de mensagens.
Esses gateways são provisionados com balanceadores de carga.
Por padrão, os endereços IP desses balanceadores de carga são temporários. Isso
significa que sempre que um dos serviços é excluído e restaurado, ele recebe um novo IP de balanceador de carga.
Neste tópico, explicamos como definir endereços IP estáticos para o Apigee híbrido implantado no GKE
e no Anthos GKE (GKE On-Prem).
Configurar endereços IP estáticos no GKE
Siga as instruções em
Como reservar um endereço IP externo estático para criar
dois endereços IP estáticos. É possível atribuir os nomes a qualquer nome, como
apigee-hybrid-mart e apigee-hybrid-runtime. Quando terminar, você
terá dois números de IP para usar na configuração do cluster na próxima etapa. Por exemplo:
35.225.131.189 e 34.66.75.196.
No arquivo de modificações, adicione as seguintes configurações loadBalancerIP ao
componente de entrada:
Sintaxe
A configuração tem a seguinte estrutura e sintaxe.
Os valores em red, bold italics são
valores de propriedade que você precisa fornecer.
Aplique o arquivo de modificações ao cluster. Como apenas o componente istio
precisa ser atualizado, você pode usar a sinalização -c istio. Por exemplo:
Consulte a documentação do Anthos GKE e crie dois endereços IP estáticos seguindo as
instruções específicas do Anthos GKE. Quando terminar, você
terá dois números de IP para usar na configuração do cluster na próxima etapa. Por exemplo:
35.225.131.189 e 34.66.75.196.
Abra o arquivo de modificações.
Adicione a seguinte configuração para ingress:
Sintaxe
A configuração tem a seguinte estrutura e sintaxe.
Os valores em red, bold italics são
valores de propriedade que você precisa fornecer.
Aplique o arquivo de modificações ao cluster. Como apenas o componente istio
precisa ser atualizado, você pode usar a sinalização -c istio. Por exemplo:
[[["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 document outlines the process of configuring static IP addresses for the \u003ccode\u003eapigee-mart-istio-ingressgateway\u003c/code\u003e and \u003ccode\u003eistio-ingressgateway\u003c/code\u003e in Apigee hybrid deployments on GKE and Anthos GKE.\u003c/p\u003e\n"],["\u003cp\u003eStatic IP addresses are recommended for these gateways to prevent IP changes when services are deleted and restored, as default load balancer IPs are ephemeral.\u003c/p\u003e\n"],["\u003cp\u003eTo configure static IPs on GKE, users need to reserve two static external IP addresses and then add the \u003ccode\u003eloadBalancerIP\u003c/code\u003e configurations to their overrides file under the \u003ccode\u003eingress\u003c/code\u003e component, specifying each IP for \u003ccode\u003eruntime\u003c/code\u003e and \u003ccode\u003emart\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eFor Anthos GKE, the process involves creating two static IP addresses according to Anthos GKE documentation, then adding the corresponding \u003ccode\u003eloadBalancerIP\u003c/code\u003e configurations to the overrides file for \u003ccode\u003eruntime\u003c/code\u003e and \u003ccode\u003emart\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAfter setting up the IPs in the overrides file for GKE and Anthos, use the \u003ccode\u003e$APIGEECTL_HOME/apigeectl init -f my-overrides.yaml -c istio\u003c/code\u003e command to apply these changes.\u003c/p\u003e\n"]]],[],null,["# Configure static IP addresses\n\n| You are currently viewing version 1.2 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\n\nGoogle recommends that you create static IP addresses for the two ingress gateways that\nare exposed outside the cluster:\n\nThese gateways are provisioned with [load balancers](https://kubernetes.io/docs/concepts/services-networking/service/#loadbalancer).\nBy default, the IP addresses for these load balancers are *ephemeral*. That\nmeans whenever one of the services is deleted and restored, it gets a new load balancer IP.\nThis topic explains how to define static IP addresses for Apigee hybrid deployed on GKE and Anthos GKE (GKE On-Prem).\n\n\u003cbr /\u003e\n\nConfigure static IP addresses on GKE\n------------------------------------\n\n1. Follow the instructions in [Reserving a static external IP address](https://cloud.google.com/compute/docs/ip-addresses/reserve-static-external-ip-address) to create two static IP addresses. You can give the addresses any name you wish, for example: `apigee-hybrid-mart` and `apigee-hybrid-runtime`. When you finish, you will have two IP numbers to use in the cluster configuration in the next step. For example: `35.225.131.189` and `34.66.75.196`\n2. In your overrides file, add the following `loadBalancerIP` configurations to the ingress component: \n\n ### Syntax\n\n The configuration has the following structure and syntax.\n Values in \u003cvar translate=\"no\"\u003ered, bold italics\u003c/var\u003e are\n property values that you must provide: \n\n ```gdscript\n ingress:\n enableAccesslog: true\n runtime:\n loadBalancerIP: runtime_IP\n mart:\n loadBalancerIP: mart_IP\n ```\n\n ### Example\n\n The following example shows the completed configuration with example property values\n added: \n\n ```gdscript\n ingress:\n enableAccesslog: true\n runtime:\n loadBalancerIP: 35.225.131.189\n mart:\n loadBalancerIP: 34.66.75.196\n ```\n3. Apply your overrides file to the cluster. Because only the `istio`\n component needs to be updated, you can use the `-c istio` flag. For example:\n\n $APIGEECTL_HOME/apigeectl init -f my-overrides.yaml -c istio\n\nConfigure static IP addresses for Anthos GKE\n--------------------------------------------\n\n1. Refer to the Anthos GKE documentation and create two static IP addresses by following the Anthos GKE specific instructions. When you finish, you will have two IP numbers to use in the cluster configuration in the next step. For example: `35.225.131.189` and `34.66.75.196`\n2. Open your overrides file.\n3. Add the following configuration for `ingress`: \n\n ### Syntax\n\n The configuration has the following structure and syntax.\n Values in \u003cvar translate=\"no\"\u003ered, bold italics\u003c/var\u003e are\n property values that you must provide: \n\n ```gdscript\n ingress:\n enableAccesslog: true\n runtime:\n loadBalancerIP: runtime_IP\n mart:\n loadBalancerIP: mart_IP\n ```\n\n ### Example\n\n The following example shows the completed configuration with example property values\n added: \n\n ```gdscript\n ingress:\n enableAccesslog: true\n runtime:\n loadBalancerIP: 35.225.131.189\n mart:\n loadBalancerIP: 34.66.75.196\n ```\n4. Save the file.\n5. Apply your overrides file to the cluster. Because only the `istio`\n component needs to be updated, you can use the `-c istio` flag. For example:\n\n $APIGEECTL_HOME/apigeectl init -f my-overrides.yaml -c istio"]]
