Google recommends that you create static IP addresses for the two ingress gateways that
are exposed outside the cluster:
Gateway
Description
apigee-mart-istio-ingressgateway
The Istio ingress gateway used by the MART service to communicate with the management plane.
istio-ingressgateway
The Istio ingress gateway used to send and receive API proxy traffic by the message processor
load balancers.
These gateways are provisioned with load balancers.
By default, the IP addresses for these load balancers are ephemeral. That
means whenever one of the services is deleted and restored, it gets a new load balancer IP.
This topic explains how to define static IP addresses for Apigee hybrid deployed on GKE
and Anthos GKE (GKE On-Prem).
Configure static IP addresses on GKE
Follow the instructions in
Reserving a 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
In your overrides file, add the following loadBalancerIP configurations to
the ingress component:
Syntax
The configuration has the following structure and syntax.
Values in red, bold italics are
property values that you must provide:
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
Open your overrides file.
Add the following configuration for ingress:
Syntax
The configuration has the following structure and syntax.
Values in red, bold italics are
property values that you must provide:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-26 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"]]
