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
Copy file name to clipboardExpand all lines: content/ngf/get-started.md
+32-1Lines changed: 32 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -554,8 +554,39 @@ URI: /tea
554
554
Request ID: 1b5c8f3a4532ea7d7510cf14ffeb27af
555
555
```
556
556
557
+
## Migrate from NGINX Ingress Controller
558
+
559
+
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.
560
+
561
+
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.
562
+
563
+
{{< call-out "important" >}}
564
+
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.
565
+
{{< /call-out >}}
566
+
567
+
### Use ingress2gateway
568
+
569
+
To convert your existing NGINX Ingress resources to Gateway API resources that work with NGINX Gateway Fabric:
570
+
571
+
572
+
First, [install the ingress2gateway tool](https://github.com/kubernetes-sigs/ingress2gateway?tab=readme-ov-file#installation).
573
+
574
+
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:
581
+
582
+
```shell
583
+
kubectl apply -f gateway-api-resources.yaml
584
+
```
585
+
586
+
For detailed information about NGINX-specific features and conversion options, see the [NGINX provider documentation](https://github.com/kubernetes-sigs/ingress2gateway/blob/main/pkg/i2gw/providers/nginx/README.md).
587
+
557
588
## Next steps
558
589
559
590
-[Install NGINX Gateway Fabric]({{< ref "/ngf/install/" >}}), for additional ways to install NGINX Gateway Fabric
560
591
-[Traffic management]({{< ref "/ngf/traffic-management/" >}}), for more in-depth traffic management configuration
561
-
-[How-to guides]({{< ref "/ngf/how-to/" >}}), for configuring your cluster
592
+
-[How-to guides]({{< ref "/ngf/how-to/" >}}), for configuring your cluster
0 commit comments