Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
2a0030b
feat: Set up NGF integration to N1 Console
mjang Jul 25, 2025
961a680
delete unneeded file
mjang Jul 29, 2025
7b2ac9d
Apply suggestions from code review
mjang Aug 6, 2025
01c0d91
Apply suggestions from code review
mjang Aug 13, 2025
b392c5e
Update helm install ngf with agent options
mjang Aug 14, 2025
e9807b2
Merge branch 'main' into feat-add-ngf
mjang Aug 14, 2025
e21ebb9
Set up new page for ngf w/manifests. Add includes
mjang Aug 14, 2025
0e72d5b
fix
mjang Aug 14, 2025
d2e59f1
Merge branch 'main' into feat-add-ngf
mjang Aug 14, 2025
154e935
Update commands for nginx-gateway namespace
mjang Aug 14, 2025
d077a80
Apply suggestions from code review
mjang Aug 15, 2025
51fb9f1
Merge branch 'main' into feat-add-ngf
mjang Aug 15, 2025
0ad8ac4
Update content/nginx-one/k8s/add-ngf-manifests.md
mjang Aug 15, 2025
a408a90
Add ref links
mjang Aug 15, 2025
8a91b9b
Merge branch 'main' into feat-add-ngf
ADubhlaoich Aug 18, 2025
8895ad8
Add common k8s secret include
mjang Aug 18, 2025
75fff50
Update dp key update
mjang Aug 18, 2025
1b6bcdb
Apply suggestions from code review
mjang Aug 18, 2025
fd55b91
Apply suggestions from code review
mjang Aug 18, 2025
d6ce67d
Use another include
mjang Aug 18, 2025
e35e6c4
Update content/nginx-one/k8s/add-ngf-manifests.md
mjang Aug 18, 2025
3901ff0
Merge branch 'main' into feat-add-ngf
mjang Aug 18, 2025
bc4ff15
troubleshooting include
mjang Aug 18, 2025
1ef87e4
More feedback
mjang Aug 18, 2025
fa78878
Merge branch 'main' into feat-add-ngf
mjang Aug 18, 2025
4cff9ee
Apply suggestions from code review
mjang Aug 18, 2025
d5a66d7
Include to verify connection
mjang Aug 18, 2025
82ecccc
Merge branch 'main' into feat-add-ngf
mjang Aug 18, 2025
cd4fdea
Move file
mjang Aug 18, 2025
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
29 changes: 24 additions & 5 deletions content/nginx-one/k8s/add-ngf-helm.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,19 @@ To create a Kubernetes secret, you'll need:
- The Data Plane Key
- To set up the secret in the same namespace as NGINX Gateway Fabric
- Use the name `dataplane.key` as shown
- A namespace. The default NGINX Gateway Fabric namespace is `nginx-gateway`

To create a Kubernetes secret, you'll need:

- The Data Plane Key
- The `nginx-gateway` namespace must exist. You can create it with the following command: `kubectl create namespace nginx-gateway`

- Then create the secret with the following command. The key must be named `dataplane.key`:

```shell
kubectl create secret generic dataplane-key \
--from-literal=dataplane.key=<Your Dataplane Key> \
-n nginx-gateway
```
- You can create it with the following command: `kubectl create namespace nginx-gateway`

Once you have that information, run the following command:
Expand Down Expand Up @@ -64,7 +76,7 @@ To install the latest stable release of NGINX Gateway Fabric in the **nginx-gate

```shell
helm install ngf oci://ghcr.io/nginx/charts/nginx-gateway-fabric \
--set nginxAgent.dataplaneKeySecretName=<data_plane_key_secret_name> \
--set nginx.nginxOneConsole.dataplaneKeySecretName=<data_plane_key_secret_name> \
-n nginx-gateway
```

Expand All @@ -81,7 +93,7 @@ helm install ngf oci://ghcr.io/nginx/charts/nginx-gateway-fabric \
--set nginx.image.repository=private-registry.nginx.com/nginx-gateway-fabric/nginx-plus \
--set nginx.plus=true \
--set nginx.imagePullSecret=nginx-plus-registry-secret -n nginx-gateway \
--set nginxAgent.dataplaneKeySecretName=<data_plane_key_secret_name>
--set nginx.nginxOneConsole.dataplaneKeySecretName=<data_plane_key_secret_name>
```

{{% /tab %}}
Expand Down Expand Up @@ -111,7 +123,9 @@ If you prefer to install directly from sources, instead of through the OCI helm
To install the chart into the **nginx-gateway** namespace, run the following command:

```shell
helm install ngf . --create-namespace -n nginx-gateway
helm install ngf . \
--set nginx.nginxOneConsole.dataplaneKeySecretName=<data_plane_key_secret_name> \
-n nginx-gateway
```

{{% /tab %}}
Expand All @@ -123,7 +137,12 @@ helm install ngf . --create-namespace -n nginx-gateway
To install the chart into the **nginx-gateway** namespace, run the following command:

```shell
helm install ngf . --set nginx.image.repository=private-registry.nginx.com/nginx-gateway-fabric/nginx-plus --set nginx.plus=true --set nginx.imagePullSecret=nginx-plus-registry-secret -n nginx-gateway
helm install ngf . \
--set nginx.image.repository=private-registry.nginx.com/nginx-gateway-fabric/nginx-plus \
--set nginx.nginxOneConsole.dataplaneKeySecretName=<data_plane_key_secret_name> \
--set nginx.plus=true \
--set nginx.imagePullSecret=nginx-plus-registry-secret \
-n nginx-gateway
```

{{% /tab %}}
Expand Down
4 changes: 4 additions & 0 deletions content/nginx-one/k8s/add-ngf-manifests.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,10 @@ Log in to NGINX One Console. If you need more information, review our [Get start

{{< include "/nginx-one/how-to/generate-data-plane-key.md" >}}

### Create a Kubernetes secret with the data plane key

{{< include "/nginx-one/how-to/k8s-secret-dp-key.md" >}}

### Secure traffic

For more information, review how you can [Secure traffic using Let's Encrypt and cert-manager]({{< ref "/ngf/traffic-security/integrate-cert-manager.md" >}})
Expand Down