Skip to content

Commit 0e72d5b

Browse files
mjangmjang
committed
fix
1 parent e21ebb9 commit 0e72d5b

File tree

5 files changed

+167
-13
lines changed

5 files changed

+167
-13
lines changed

‎content/includes/ngf/installation/deploy-ngf-crds.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
nd-docs: "DOCS-000"
3+
files:
4+
- content/ngf/install/manifests.md
5+
- content/nginx-one/ngf/add-ngf-manifests.md
6+
---
7+
8+
#### Stable release
9+
10+
```shell
11+
kubectl apply --server-side -f https://raw.githubusercontent.com/nginx/nginx-gateway-fabric/v{{< version-ngf >}}/deploy/crds.yaml
12+
```
13+
14+
#### Edge version
15+
16+
```shell
17+
kubectl apply --server-side -f https://raw.githubusercontent.com/nginx/nginx-gateway-fabric/main/deploy/crds.yaml
18+
```

‎content/includes/ngf/installation/deploy-ngf-manifests.md‎

Lines changed: 125 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,125 @@
1+
---
2+
nd-docs: "DOCS-000"
3+
files:
4+
- content/ngf/install/manifests.md
5+
- content/nginx-one/ngf/add-ngf-manifests.md
6+
---
7+
8+
{{< call-out "note" >}} By default, NGINX Gateway Fabric is installed in the **nginx-gateway** namespace. You can deploy in another namespace by modifying the manifest files. {{< /call-out >}}
9+
10+
{{<tabs name="install-manifests">}}
11+
12+
{{%tab name="Default"%}}
13+
14+
Deploys NGINX Gateway Fabric with NGINX OSS.
15+
16+
```shell
17+
kubectl apply -f https://raw.githubusercontent.com/nginx/nginx-gateway-fabric/v{{< version-ngf >}}/deploy/default/deploy.yaml
18+
```
19+
20+
{{% /tab %}}
21+
22+
{{%tab name="AWS NLB"%}}
23+
24+
Deploys NGINX Gateway Fabric with NGINX OSS.
25+
26+
```shell
27+
kubectl apply -f https://raw.githubusercontent.com/nginx/nginx-gateway-fabric/v{{< version-ngf >}}/deploy/default/deploy.yaml
28+
```
29+
30+
To set up an AWS Network Load Balancer service, add these annotations to your Gateway infrastructure field:
31+
32+
```yaml
33+
spec:
34+
infrastructure:
35+
annotations:
36+
service.beta.kubernetes.io/aws-load-balancer-type: "external"
37+
service.beta.kubernetes.io/aws-load-balancer-nlb-target-type: "ip"
38+
```
39+
40+
{{% /tab %}}
41+
42+
{{%tab name="Azure"%}}
43+
44+
Deploys NGINX Gateway Fabric with NGINX OSS and `nodeSelector` to deploy on Linux nodes.
45+
46+
```shell
47+
kubectl apply -f https://raw.githubusercontent.com/nginx/nginx-gateway-fabric/v{{< version-ngf >}}/deploy/azure/deploy.yaml
48+
```
49+
50+
{{% /tab %}}
51+
52+
{{%tab name="NGINX Plus"%}}
53+
54+
Deploys NGINX Gateway Fabric with NGINX Plus. The image is pulled from the
55+
NGINX Plus Docker registry, and the `imagePullSecretName` is the name of the Secret to use to pull the image.
56+
The NGINX Plus JWT Secret used to run NGINX Plus is also specified in a volume mount and the `--usage-report-secret` parameter. These Secrets are created as part of the [Before you begin](#before-you-begin) section.
57+
58+
```shell
59+
kubectl apply -f https://raw.githubusercontent.com/nginx/nginx-gateway-fabric/v{{< version-ngf >}}/deploy/nginx-plus/deploy.yaml
60+
```
61+
62+
{{% /tab %}}
63+
64+
{{%tab name="Experimental"%}}
65+
66+
Deploys NGINX Gateway Fabric with NGINX OSS and experimental features.
67+
68+
```shell
69+
kubectl apply -f https://raw.githubusercontent.com/nginx/nginx-gateway-fabric/v{{< version-ngf >}}/deploy/experimental/deploy.yaml
70+
```
71+
72+
{{< call-out "note" >}} Requires the Gateway APIs installed from the experimental channel. {{< /call-out >}}
73+
74+
{{% /tab %}}
75+
76+
{{%tab name="NGINX Plus Experimental"%}}
77+
78+
Deploys NGINX Gateway Fabric with NGINX Plus and experimental features. The image is pulled from the
79+
NGINX Plus Docker registry, and the `imagePullSecretName` is the name of the Secret to use to pull the image.
80+
The NGINX Plus JWT Secret used to run NGINX Plus is also specified in a volume mount and the `--usage-report-secret` parameter. These Secrets are created as part of the [Before you begin](#before-you-begin) section.
81+
82+
```shell
83+
kubectl apply -f https://raw.githubusercontent.com/nginx/nginx-gateway-fabric/v{{< version-ngf >}}/deploy/nginx-plus-experimental/deploy.yaml
84+
```
85+
86+
{{< call-out "note" >}} Requires the Gateway APIs installed from the experimental channel. {{< /call-out >}}
87+
88+
{{% /tab %}}
89+
90+
{{%tab name="NodePort"%}}
91+
92+
Deploys NGINX Gateway Fabric with NGINX OSS using a Service type of `NodePort`.
93+
94+
```shell
95+
kubectl apply -f https://raw.githubusercontent.com/nginx/nginx-gateway-fabric/v{{< version-ngf >}}/deploy/nodeport/deploy.yaml
96+
```
97+
98+
{{% /tab %}}
99+
100+
{{%tab name="OpenShift"%}}
101+
102+
Deploys NGINX Gateway Fabric with NGINX OSS on OpenShift.
103+
104+
```shell
105+
kubectl apply -f https://raw.githubusercontent.com/nginx/nginx-gateway-fabric/v{{< version-ngf >}}/deploy/openshift/deploy.yaml
106+
```
107+
108+
{{% /tab %}}
109+
110+
{{</tabs>}}
111+
112+
### Verify the Deployment
113+
114+
To confirm that NGINX Gateway Fabric is running, check the pods in the `nginx-gateway` namespace:
115+
116+
```shell
117+
kubectl get pods -n nginx-gateway
118+
```
119+
120+
The output should look similar to this (note that the pod name will include a unique string):
121+
122+
```text
123+
NAME READY STATUS RESTARTS AGE
124+
nginx-gateway-5d4f4c7db7-xk2kq 1/1 Running 0 112s
125+
```

‎content/includes/ngf/installation/install-manifests-prereqs.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
nd-docs: "DOCS-000"
3+
files:
4+
- content/ngf/install/manifests.md
5+
- content/nginx-one/ngf/add-ngf-manifests.md
6+
---
7+
8+
To complete this guide, you'll need to install:
9+
10+
- [kubectl](https://kubernetes.io/docs/tasks/tools/), a command-line interface for managing Kubernetes clusters.
11+
- [Add certificates for secure authentication]({{< ref "/ngf/install/secure-certificates.md" >}}) in a production environment.
12+
13+
{{< call-out "important" >}} If you’d like to use NGINX Plus, some additional setup is also required: {{< /call-out >}}
14+
15+
<details closed>
16+
<summary>NGINX Plus JWT setup</summary>
17+
18+
{{< include "/ngf/installation/jwt-password-note.md" >}}

‎content/includes/nginx-one/how-to/generate-data-plane-key.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ docs:
33
files:
44
- content/nginx-one/secure-your-fleet/set-up-security-alerts.md
55
- content/nginx-one/getting-started.md
6+
- content/nginx-one/ngf/add-nic.md
7+
- content/nginx-one/ngf/add-ngf-helm.md
8+
- content/nginx-one/ngf/add-ngf-manifests.md
69
---
710

811
A data plane key is a security token that ensures only trusted NGINX instances can register and communicate with NGINX One.
@@ -17,3 +20,5 @@ Data plane keys are displayed only once and cannot be retrieved later. Be sure t
1720

1821
Data plane keys expire after one year. You can change this expiration date later by [editing the key]({{< ref "nginx-one/connect-instances/create-manage-data-plane-keys.md#change-expiration-date" >}}). If you [revoke a data plane key]({{< ref "nginx-one/connect-instances/create-manage-data-plane-keys.md#revoke-data-plane-key" >}}) you disconnect all instances registered with that key.
1922
{{</call-out>}}
23+
24+
For more options associated with data plane keys, see [Create and manage data plane keys]({{< ref "/nginx-one/connect-instances/create-manage-data-plane-keys.md" >}}).

‎content/nginx-one/getting-started.md‎

Lines changed: 1 addition & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -110,20 +110,9 @@ The following instructions include minimal information, sufficient to "get start
110110

111111
### Generate a data plane key {#generate-data-plane-key}
112112

113-
A data plane key is a security token that ensures only trusted NGINX instances can register and communicate with NGINX One.
114-
115-
To generate a data plane key:
116-
117-
- **For a new key:** In the **Add Instance** pane, select **Generate Data Plane Key**.
118-
- **To reuse an existing key:** If you already have a data plane key and want to use it again, select **Use existing key**. Then, enter the key's value in the **Data Plane Key** box.
119-
120-
{{<call-out "caution" "Data plane key guidelines" "fas fa-key" >}}
121-
Data plane keys are displayed only once and cannot be retrieved later. Be sure to copy and store this key securely.
122-
123-
Data plane keys expire after one year. You can change this expiration date later by [editing the key]({{< ref "nginx-one/connect-instances/create-manage-data-plane-keys.md#change-expiration-date" >}}).
113+
{{< include "/nginx-one/how-to/generate-data-plane-key.md" >}}
124114

125115
[Revoking a data plane key]({{< ref "nginx-one/connect-instances/create-manage-data-plane-keys.md#revoke-data-plane-key" >}}) disconnects all instances that were registered with that key.
126-
{{</call-out>}}
127116

128117
### Add an instance
129118

@@ -132,7 +121,6 @@ Depending on whether this is your first time using NGINX One Console or you've u
132121
- **For first-time users:** On the welcome screen, select **Add Instance**.
133122
- **For returning users:** If you've added instances previously and want to add more, select **Instances** on the left menu, then select **Add Instance**.
134123

135-
136124
### Install NGINX Agent
137125

138126
After entering your data plane key, you'll see a `curl` command similar to the one below. Copy and run this command on each NGINX instance to install NGINX Agent. Once installed, NGINX Agent typically registers with NGINX One within a few seconds.

0 commit comments

Comments
 (0)