Skip to content

Commit 4f72c45

Browse files
authored
feat: Fix broken migration link (#1113)
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.
1 parent d4425af commit 4f72c45

File tree

2 files changed

+12
-10
lines changed

2 files changed

+12
-10
lines changed

content/ngf/install/ingress-to-gateway.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ nd-product: NGF
77
nd-docs:
88
---
99

10-
# Migrate from NGINX Ingress Controller
10+
This document describes how to migrate from F5 NGINX Ingress Controller to NGINX Gateway Fabric.
1111

1212
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.
1313

@@ -18,29 +18,31 @@ The [Gateway API](https://gateway-api.sigs.k8s.io/) is the next-generation Kuber
1818
- **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).
1919
- **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.
2020
- **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.
2222

2323
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.
2424

2525
## About the ingress2gateway tool
2626

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

2929
{{< 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.
3231

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 >}}
3434

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

3737
Then run the conversion command for the NGINX provider:
3838

3939
```shell
4040
ingress2gateway print --providers=nginx --input-file=<your-ingress-file> > gateway-api-resources.yaml
4141
```
4242

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`. 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:
4446

4547
```shell
4648
kubectl apply -f gateway-api-resources.yaml

content/ngf/install/upgrade-version.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22
title: Upgrade NGINX Gateway Fabric
33
weight: 700
44
toc: true
5-
type: how-to
6-
product: NGF
5+
nd-content-type: how-to
6+
nd-product: NGF
77
nd-docs: DOCS-1852
88
---
99

0 commit comments

Comments
 (0)