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
You can add an instance to NGINX One Console in the following ways:
6
+
7
+
- Directly, under **Instances**
8
+
- Indirectly, by selecting a Config Sync Group, and selecting **Add Instance to Config Sync Group**
9
+
10
+
In either case, NGINX One Console gives you a choice for data plane keys:
11
+
12
+
- Create a new key
13
+
- Use an existing key
14
+
15
+
NGINX One Console takes the option you use, and adds the data plane key to a command that you'd use to register your target instance. You should see the command in the **Add Instance** screen in the console.
16
+
17
+
Connect to the host where your NGINX instance is running. Run the provided command to [install NGINX Agent]({{< ref "/nginx-one/getting-started#install-nginx-agent" >}}) dependencies and packages on that host.
18
+
19
+
```bash
20
+
curl https://agent.connect.nginx.com/nginx-agent/install | DATA_PLANE_KEY="<data_plane_key>" sh -s -- -y
21
+
```
22
+
23
+
Once the process is complete, you can configure that instance in your NGINX One Console.
Copy file name to clipboardExpand all lines: content/nginx-one/nginx-configs/add-instance.md
+6-24Lines changed: 6 additions & 24 deletions
Original file line number
Diff line number
Diff line change
@@ -16,42 +16,24 @@ to set up a data plane key to connect your instances to NGINX One.
16
16
17
17
Before you add an instance to NGINX One Console, ensure:
18
18
19
-
- You have administrator access to NGINX One Console.
20
-
- You have configured instances of NGINX that you want to manage through NGINX One Console.
21
-
- You have or are ready to configure a data plane key.
22
-
- You have or are ready to set up managed certificates.
19
+
- You have [administrator access]({{< ref "/nginx-one/rbac/roles.md" >}}) to NGINX One Console.
20
+
- You have [configured instances of NGINX]({{< ref "/nginx-one/getting-started.md#add-your-nginx-instances-to-nginx-one" >}}) that you want to manage through NGINX One Console.
21
+
- You have or are ready to configure a [data plane key]({{< ref "/nginx-one/getting-started.md#generate-data-plane-key" >}}).
22
+
- You have or are ready to set up [managed certificates]({{< ref "/nginx-one/certificates/manage-certificates.md" >}}).
23
23
24
24
{{< note >}}If this is the first time an instance is being added to a Config Sync Group, and you have not yet defined the configuration for that Config Sync Group, that instance provides the template for that group. For more information, see [Configuration management]({{< ref "nginx-one/config-sync-groups/manage-config-sync-groups#configuration-management" >}}).{{< /note >}}
25
25
26
26
## Add an instance
27
27
28
-
You can add an instance to NGINX One Console in the following ways:
29
-
30
-
- Directly, under **Instances**
31
-
- Indirectly, by selecting a Config Sync Group, and selecting **Add Instance to Config Sync Group**
32
-
33
-
In either case, NGINX One Console gives you a choice for data plane keys:
34
-
35
-
- Create a new key
36
-
- Use an existing key
37
-
38
-
NGINX One Console takes the option you use, and adds the data plane key to a command that you'd use to register your target instance. You should see the command in the **Add Instance** screen in the console.
39
-
40
-
Connect to the host where your NGINX instance is running. Run the provided command to [install NGINX Agent]({{< ref "/nginx-one/getting-started#install-nginx-agent" >}}) dependencies and packages on that host.
41
-
42
-
```bash
43
-
curl https://agent.connect.nginx.com/nginx-agent/install | DATA_PLANE_KEY="<data_plane_key>" sh -s -- -y
44
-
```
45
-
46
-
Once the process is complete, you can configure that instance in your NGINX One Console.
28
+
{{< include "/nginx-one/how-to/add-instance.md" >}}
47
29
48
30
## Managed and Unmanaged Certificates
49
31
50
32
If you add an instance with SSL/TLS certificates, those certificates can match an existing managed SSL certificate/CA bundle.
51
33
52
34
### If the certificate is already managed
53
35
54
-
If you add an instance with a managed certificate, as described in [Add your NGINX instances to NGINX One], these certificates are added to your list of **Managed Certificates**.
36
+
If you add an instance with a managed certificate, as described in [Add your NGINX instances to NGINX One]({{< ref "/nginx-one/getting-started.md#add-your-nginx-instances-to-nginx-one" >}}), these certificates are added to your list of **Managed Certificates**.
55
37
56
38
NGINX One Console can manage your instances along with those certificates.
0 commit comments