Skip to content

Commit 5c3506f

Browse files
authored
docs: Publish NGINXaaS for GC pre-release docs (#1285)
Publish NGINXaaS for GC pre-release docs
1 parent ec749b9 commit 5c3506f

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

57 files changed

+2852
-16
lines changed

content/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Learn how to deliver, manage, and protect your applications using F5 NGINX produ
4343
{{</card-section>}}
4444

4545
{{<card-section showAsCards="true" title="F5 NGINX as a Service">}}
46-
{{<card title="F5 NGINXaaS for Azure" titleUrl="/nginxaas/azure/" brandIcon="NGINX-for-Azure-product-icon.svg" isLanding="true">}}
46+
{{<card title="F5 NGINXaaS for Azure" titleUrl="/nginxaas/azure/" brandIcon="F5-NGINXaaS-icon.svg" isLanding="true">}}
4747
Infrastructure-as-a-Service (IaaS) version of NGINX Plus for your Microsoft Azure application stack.
4848
{{</card >}}
4949
{{</card-section>}}
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
nd-docs: DOCS-000
3+
---
4+
5+
- Visit [https://console.nginxaas.net/](https://console.nginxaas.net/) to access the NGINXaaS Console.
6+
- Log in to the console with your Google credentials.
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
nd-docs: DOCS-000
3+
---
4+
5+
In the NGINXaaS Console,
6+
7+
1. On the left menu, select **Configurations**.
8+
1. Select **Add Configuration** to add a new NGINX configuration.
9+
1. You can either create a new configuration from scratch or copy an existing configuration:
10+
11+
- Select **New configuration** to create a new config.
12+
- Provide a name for your configuration and an optional description.
13+
- Change the configuration path if needed.
14+
- Select to start with the "NGINXaaS Default" (a basic NGINX setup) or an empty configuration file.
15+
- Select **Next**.
16+
- Select **Copy existing configuration** to use one of the existing configuration files in your account as template.
17+
- Provide a name for your configuration and an optional description.
18+
- Change the configuration path if needed.
19+
- Use the **Choose configuration to copy** list to select the configuration file you want to copy.
20+
- Use the **Choose configuration version to copy** list to select the version of the configuration file you want to copy.
21+
- Select **Next**.
22+
23+
1. Modify the configuration file as needed and select **Save**.
24+
- You can import certificates using the **Add file** option.
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
nd-docs: DOCS-000
3+
---
4+
5+
NGINX access logs are disabled by default. You can enable access logs by adding **access_log** directives to your NGINX configuration to specify the location of the logs and formats. The log path should always be configured to be inside **/var/log/nginx**.
6+
7+
```nginx
8+
http {
9+
log_format myfmt '$remote_addr - $remote_user [$time_local] '
10+
'"$request" $status $body_bytes_sent '
11+
'"$http_referer" "$http_user_agent" "$gzip_ratio"';
12+
13+
access_log /var/log/nginx/nginx-access.log myfmt;
14+
# ...
15+
}
16+
```
17+
18+
{{< call-out "note" >}} The **$time_local** variable includes the date and time for each log. It helps with ordering logs after export. {{< /call-out >}}
19+
20+
To explicitly disable access logs, apply the following config:
21+
22+
```nginx
23+
http {
24+
access_log off;
25+
}
26+
```
27+
28+
or
29+
30+
```nginx
31+
http {
32+
access_log /dev/null;
33+
}
34+
```
35+
36+
To learn more about how to specify `access_log` in different configuration levels and their effect, see [access_log](https://nginx.org/en/docs/http/ngx_http_log_module.html#access_log)
37+
38+
{{< call-out "warning" >}}Keep NGINX logs in the **/var/log/nginx** directory. Otherwise, you may lose data from your logs.
39+
{{< /call-out >}}
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
nd-docs: DOCS-000
3+
---
4+
5+
NGINX error logs are disabled by default. You can enable error logs by adding **error_log** directives to your NGINX configuration to specify the location of the logs and formats. The log path should always be configured to be inside **/var/log/nginx**.
6+
7+
While you should configure log files in the **/var/log/nginx** directory, you can change the filename and severity level. For example, the following line in the NGINX configuration sends errors to the `nginx-error.log` file, and limits messages to a severity level of **emerg**:
8+
9+
```nginx
10+
error_log /var/log/nginx/nginx-error.log emerg;
11+
```
12+
13+
Alternatively, you can disable error logs completely with the following line:
14+
15+
```nginx
16+
error_log /dev/null;
17+
```
18+
19+
To learn more about how to specify `error_log` in different configuration levels, see the documentation of the [error_log](https://nginx.org/en/docs/ngx_core_module.html?#error_log) directive.
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
nd-docs: "DOCS-1476"
3+
---
4+
5+
An NGINX Capacity Unit (NCU) quantifies the capacity of an NGINX instance based on the underlying compute resources. This abstraction allows you to specify the desired capacity in NCUs without having to consider the regional hardware differences.
6+
7+
An NGINX Capacity Unit consists of the following parameters:
8+
9+
* CPU: an NCU provides 20 [Azure Compute Units](https://learn.microsoft.com/en-us/azure/virtual-machines/acu) (ACUs)
10+
* Bandwidth: an NCU provides 60 Mbps of network throughput
11+
* Concurrent connections: an NCU provides 400 concurrent connections. This performance is not guaranteed when NGINX App Protect WAF is used with NGINXaaS
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
nd-docs: DOCS-000
3+
---
4+
5+
TBD SSL Prerequisites for NGINXaaS for Google Cloud
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
nd-docs: DOCS-000
3+
---
4+
5+
- Confirm that you meet the [NGINXaaS Prerequisites]({{< ref "/nginxaas-google/getting-started/prerequisites.md" >}}).
6+
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
nd-docs: DOCS-000
3+
---
4+
5+
TBD NGINXaaS for Google Cloud Terraform resources
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
nd-docs: DOCS-000
3+
---
4+
5+
1. On the left menu, select **Configurations**.
6+
1. On the list of configurations, select the ellipses (three dots) icon next to the configuration you want to update.
7+
1. Select **Edit**.
8+
1. Update the "Description" field as needed and select **Next**.
9+
1. Select the file you want to update in the file tree.
10+
- Certificates can only be copied, moved, or renamed.
11+
1. Modify the configuration file(s) as needed and select **Next**.
12+
1. Review the changes using the "Inline" or "Side-by-side" views and select **Save**.
13+
14+
You will see a notification confirming that the configuration was updated successfully.

0 commit comments

Comments
 (0)