From 0d718857d162a9574a77f2a9dffa9df77c0cb54b Mon Sep 17 00:00:00 2001 From: Jesse Dohmann Date: Tue, 20 Jan 2026 16:57:12 -0800 Subject: [PATCH] OSDOCS-15912: add note about enabling user-managed DNS for GCP installations --- modules/nw-ingress-gateway-api-enable.adoc | 5 +++++ .../ingress-controller-dnsmgt.adoc | 5 +++++ 2 files changed, 10 insertions(+) diff --git a/modules/nw-ingress-gateway-api-enable.adoc b/modules/nw-ingress-gateway-api-enable.adoc index 50b81ff00a..77cebd4f0b 100644 --- a/modules/nw-ingress-gateway-api-enable.adoc +++ b/modules/nw-ingress-gateway-api-enable.adoc @@ -190,6 +190,11 @@ status: dnsZone: id: ... ---- ++ +[NOTE] +==== +For {gcp-first} installations, you can use a custom DNS solution. You must manually create a DNS record for any Gateways in Gateway API. For more information, see "Enabling a user-managed DNS" and "Provisioning your own DNS records". +==== . Create an `HTTPRoute` resource that directs requests to your already-created namespace and application called `example-app/example-app`: + diff --git a/networking/ingress_load_balancing/configuring_ingress_cluster_traffic/ingress-controller-dnsmgt.adoc b/networking/ingress_load_balancing/configuring_ingress_cluster_traffic/ingress-controller-dnsmgt.adoc index c0e55c94af..2d6ca98bb0 100644 --- a/networking/ingress_load_balancing/configuring_ingress_cluster_traffic/ingress-controller-dnsmgt.adoc +++ b/networking/ingress_load_balancing/configuring_ingress_cluster_traffic/ingress-controller-dnsmgt.adoc @@ -22,6 +22,11 @@ The following list details key aspects for a managed DNS management policy: The following list details key aspects for a unmanaged DNS management policy: * The Unmanaged DNS management policy for Ingress Controllers ensures that the lifecycle of the wildcard DNS record on the cloud provider is not automatically managed; instead, it becomes the responsibility of the cluster administrator. ++ +[NOTE] +==== +For {gcp-first} installations, you can use a custom DNS solution. Refer to the `DNSRecord` CR for information on what you need to include in the DNS record. For more information, see xref:../../../installing/installing_gcp/installing-gcp-customizations.adoc#installation-gcp-enabling-user-managed-DNS_installing-gcp-customizations[Enabling a user-managed DNS] and xref:../../../installing/installing_gcp/installing-gcp-customizations.adoc#installation-gcp-provisioning-own-dns-records_installing-gcp-customizations[Provisioning your own DNS records]. +==== include::modules/creating-a-custom-ingress-controller.adoc[leveloffset=+1]