Skip to content
Open
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions content/ngf/get-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -554,6 +554,38 @@ URI: /tea
Request ID: 1b5c8f3a4532ea7d7510cf14ffeb27af
```

## Migrating from NGINX Ingress Controller

If you're already using NGINX Ingress Controller and want to migrate to NGINX Gateway Fabric, you can use the ingress2gateway tool to automatically convert your existing Ingress resources to Gateway API resources.

The ingress2gateway tool is a Kubernetes SIG project that helps convert Ingress resources to Gateway API resources. It supports various Ingress controllers, including NGINX Ingress Controller.

{{< call-out "important" >}}
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.
{{< /call-out >}}

### Using ingress2gateway

To convert your existing NGINX Ingress resources to Gateway API resources that work with NGINX Gateway Fabric:

1. Install the ingress2gateway tool following the [installation instructions](https://github.com/kubernetes-sigs/ingress2gateway).

2. Run the conversion command for NGINX provider:
```shell
ingress2gateway --providers=nginx --input-file=<your-ingress-file>.yaml > output-file=gateway-api-resources.yaml
```

3. Review the generated Gateway API resources and apply them to your cluster:
```shell
kubectl apply -f gateway-api-resources.yaml
```

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).

{{< call-out "note" >}}
After conversion, you may need to adjust some configurations to take advantage of NGINX Gateway Fabric-specific features or to ensure compatibility with your existing setup.
{{< /call-out >}}

## Next steps

- [Install NGINX Gateway Fabric]({{< ref "/ngf/install/" >}}), for additional ways to install NGINX Gateway Fabric
Expand Down
Loading