You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This commit updates a link in the NGINX Ingress Controller to NGINX
Gateway Fabric migration document about extensibility information in the
Gateway API. It also fixes the metadata of another file in the same
folder, and restructures some content for readability.
Copy file name to clipboardExpand all lines: content/ngf/install/ingress-to-gateway.md
+10-8Lines changed: 10 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ nd-product: NGF
7
7
nd-docs:
8
8
---
9
9
10
-
# Migrate from NGINX Ingress Controller
10
+
This document describes how to migrate from F5 NGINX Ingress Controller to NGINX Gateway Fabric.
11
11
12
12
If you're already using NGINX Ingress Controller and want to migrate to NGINX Gateway Fabric, you can use the [ingress2gateway](https://github.com/kubernetes-sigs/ingress2gateway) tool to automatically convert your existing Ingress resources to Gateway API resources.
13
13
@@ -18,29 +18,31 @@ The [Gateway API](https://gateway-api.sigs.k8s.io/) is the next-generation Kuber
18
18
-**Role-oriented resources**: Distinct resources for infrastructure providers, cluster operators, and application developers, enabling [separation of concerns](https://gateway-api.sigs.k8s.io/concepts/security-model/#role-oriented-resources).
19
19
-**More expressive routing**: Support for [advanced traffic management](https://gateway-api.sigs.k8s.io/concepts/api-overview/#routes) such as path-based and header-based routing, traffic splitting, and TLS configuration.
20
20
-**Standardization and portability**: A Kubernetes [community standard](https://gateway-api.sigs.k8s.io/) supported by multiple vendors, ensuring consistent behavior across implementations.
21
-
-**Extensibility**: Built on Kubernetes [CRD extensibility](https://gateway-api.sigs.k8s.io/concepts/design-principles/#extensibility) to support new capabilities without breaking the core API.
21
+
-**Extensibility**: Built on Kubernetes [CRD extensibility](https://gateway-api.sigs.k8s.io/guides/migrating-from-ingress/?h=extensibility#approach-to-extensibility) to support new capabilities without breaking the core API.
22
22
23
23
Migrating to Gateway API with NGINX Gateway Fabric helps future-proof your Kubernetes networking stack, provide a standardized API across implementations, and unlock advanced traffic management features.
24
24
25
25
## About the ingress2gateway tool
26
26
27
-
The ingress2gateway tool is a Kubernetes SIG project for converting Ingress resources to Gateway API resources. It supports multiple Ingress providers, including NGINX Ingress Controller.
27
+
The ingress2gateway tool is a [Kubernetes SIG project](https://github.com/kubernetes-sigs) for converting Ingress resources to Gateway API resources. It supports multiple Ingress providers, including NGINX Ingress Controller.
28
28
29
29
{{< call-out "important" >}}
30
-
The ingress2gateway tool is a conversion utility that translates Ingress resources to Gateway API equivalents. It is not a complete end-to-end migration solution. You will need to manually review the converted resources, test functionality, and make additional configuration changes as needed for your specific environment.
31
-
{{< /call-out >}}
30
+
The ingress2gateway tool is a conversion utility that translates Ingress resources to Gateway API equivalents. It is not a complete end-to-end migration solution.
32
31
33
-
To convert your existing NGINX Ingress resources to Gateway API resources that work with NGINX Gateway Fabric:
32
+
You will need to manually review the converted resources, test functionality, and make additional configuration changes as needed for your specific environment.
33
+
{{< /call-out >}}
34
34
35
-
First,[install the ingress2gateway tool](https://github.com/kubernetes-sigs/ingress2gateway?tab=readme-ov-file#installation).
35
+
To convert your existing NGINX Ingress resources to Gateway API resources, first[install the ingress2gateway tool](https://github.com/kubernetes-sigs/ingress2gateway?tab=readme-ov-file#installation).
36
36
37
37
Then run the conversion command for the NGINX provider:
This tool will analyze your Ingress resources from the input file and output the equivalent Gateway API resources to a file named `gateway-api-resources.yaml`. Finally, review the generated Gateway API resources in the output file and apply them to your cluster:
43
+
This tool will analyze your Ingress resources from the input file and output the equivalent Gateway API resources to a file named `gateway-api-resources.yaml`.
44
+
45
+
Review the generated Gateway API resources in the output file and apply them to your cluster:
0 commit comments