Skip to content

Commit d9ded07

Browse files
danielledeleodanielledeleo
committed
Chore: Add example tables
1 parent afe61f3 commit d9ded07

File tree

7 files changed

+522
-0
lines changed

7 files changed

+522
-0
lines changed

‎exampleSite/content/test-product/tables/_index.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
description: Example tables
3+
title: Tables
4+
weight: 300
5+
---

‎exampleSite/content/test-product/tables/examples/_index.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
---
2+
title: Live examples
3+
---

‎exampleSite/content/test-product/tables/examples/config-sharing.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: Synchronizing NGINX Configuration in a Cluster
3+
weight: 300
4+
---
5+
6+
## Creating the nginx-sync.conf Configuration File on the Primary Node
7+
8+
On the primary node, create the file **/etc/nginx-sync.conf** with these contents:
9+
10+
```none
11+
NODES="node2.example.com node3.example.com node4.example.com"
12+
CONFPATHS="/etc/nginx/nginx.conf /etc/nginx/conf.d"
13+
EXCLUDE="default.conf"
14+
```
15+
16+
### Common Parameters
17+
18+
Use a space or newline character to separate the items in each list:
19+
20+
21+
{{<bootstrap-table "table table-striped table-bordered">}}
22+
23+
| Parameter | Description |
24+
| ------------------------ | -------------------------------------------------------------------------------------|
25+
| `NODES` | List of peers that receive the configuration from the primary. |
26+
| `CONFPATHS` | List of files and directories to distribute from the primary to the peers. |
27+
| `EXCLUDE` | (Optional) List of configuration files on the primary not to distribute to the peers.|
28+
29+
{{</bootstrap-table>}}
30+
31+
### Advanced Parameters
32+
33+
{{<bootstrap-table "table table-striped table-bordered">}}
34+
35+
| Parameter | Description | Default |
36+
| ------------------------ | ---------------------------------------------------------------------------------------|-------------------------|
37+
| `BACKUPDIR` | Location of backup on each peer | **/var/lib/nginx-sync** |
38+
| `DIFF` | Location of `diff` binary | **/usr/bin/diff** |
39+
| `LOCKFILE` | Location of the lock file used to ensure only one `nginx-sync` operation runs at a time| **/tmp/nginx-sync.lock**|
40+
| `NGINX` | Location of the **nginx-plus** binary | **/usr/sbin/nginx** |
41+
| `POSTSYNC` | Space-separated list of file substitutions to make on each remote node in the format: </br>`'\<filename\>\|\<sed-expression\>'`<br/> The substitution is applied in place: </br>`sed -i' ' \<sed-expression\> \<filename\>` </br> For example, to substitute the IP address of *node2.example.com* (*192.168.2.2*) for the IP address of *node1.example.com* (*192.168.2.1*) in *keepalived.conf*:</br> `POSTSYNC="/etc/keepalived/keepalived.conf\|'s/192\.168\.2\.1/192.168.2.2/'"` | |
42+
| `RSYNC` | Location of the `rsync` binary | **/usr/bin/rsync** |
43+
| `SSH` | Location of the `ssh` binary | **/usr/bin/ssh** |
44+
45+
{{</bootstrap-table>}}

‎exampleSite/content/test-product/tables/examples/installing-plus.md

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
description: Install and upgrade F5 NGINX Plus with step-by-step instructions for
3+
the base package and dynamic modules on all supported Linux distributions.
4+
title: Installing NGINX Plus
5+
weight: 100
6+
---
7+
8+
## Install Dynamically Loadable Modules {#install_modules}
9+
10+
NGINX Plus functionality can be extended with dynamically loadable modules. They can be added or updated independently of the core binary, enabling powerful capabilities such as advanced security, traffic shaping, telemetry, embedded scripting, geolocation, and many more.
11+
12+
Dynamic modules are shared object files (`.so`) that can be loaded at runtime using the [`load_module`](https://nginx.org/en/docs/ngx_core_module.html#load_module) directive in the NGINX configuration.
13+
14+
### Types of dynamic modules
15+
16+
{{< bootstrap-table "table table-striped table-bordered" >}}
17+
| Type | Description | Distribution Method | F5 NGINX Support|
18+
|-------------------------|--------------------|-----------------------|-----------------|
19+
| [NGINX-authored](#nginx-authored-dynamic-modules) | Developed and distributed by NGINX | Packaged binaries from `nginx-plus` official repo | Full support |
20+
| [NGINX-certified Community](#nginx-certified-community-dynamic-modules) | Tested and distributed by NGINX | Packaged binaries from `nginx-plus` official repo | Installation and basic configuration support |
21+
| [NGINX Certified Partner](#nginx-certified-partner-dynamic-modules) | Partner-built modules verified through [NGINX’s certification](https://www.f5.com/go/partner/nginx-certified-module-program-documentation) | Provided by partners | Provided by partners |
22+
| [Community](#community-dynamic-modules) | Developed and distributed by third‑party contributors | [Self-compiled](#install_modules_oss) | No support|
23+
{{< /bootstrap-table >}}
24+
25+
### NGINX-authored dynamic modules
26+
27+
NGINX-authored dynamic modules are developed and officially maintained by the F5 NGINX team. These modules are available as packaged binaries for various operating systems and can be installed [from the `nginx-plus` repository](#install-from-official-repository).
28+
29+
{{< bootstrap-table "table table-striped table-bordered" >}}
30+
| Name | Description | Package name |
31+
|---------------------------------|-----------------------------------|--------------------|
32+
| [GeoIP](https://nginx.org/en/docs/http/ngx_http_geoip_module.html) | Enables IP-based geolocation using the precompiled MaxMind databases. | [`nginx-plus-module-geoip`](#) |
33+
| [Image-Filter](https://nginx.org/en/docs/http/ngx_http_image_filter_module.html) | Adds on-the-fly support for JPEG, GIF, PNG, and WebP image resizing and cropping. | [`nginx-plus-module-image-filter`](#) |
34+
| [njs Scripting Language](https://nginx.org/en/docs/njs/) | Adds JavaScript-like scripting for advanced server-side logic in NGINX configuration file. | [`nginx-plus-module-njs`](#) |
35+
| [OpenTelemetry](https://github.com/nginxinc/nginx-otel) | Adds distributed tracing support via OpenTelemetry. | [`nginx-plus-module-otel`](#) |
36+
| [Perl](https://nginx.org/en/docs/http/ngx_http_perl_module.html)| Integrates Perl scripting for advanced customization. | [`nginx-plus-module-perl`](#) |
37+
| [XSLT](https://nginx.org/en/docs/http/ngx_http_xslt_module.html) | Applies XSLT transformations to XML responses. | [`nginx-plus-module-xslt`](#) |
38+
{{< /bootstrap-table >}}
39+
40+
### NGINX-certified community dynamic modules
41+
42+
NGINX-certified community dynamic modules are popular third‑party modules tested and distributed by F5 NGINX, with installation and basic configuration support provided. They are also distributed as precompiled packages for various operating systems and can be installed [from the `nginx-plus` repository](#install-from-official-repository).
43+
44+
{{< bootstrap-table "table table-striped table-bordered" >}}
45+
| Name | Description | Package name |
46+
|---------------------------------|-----------------------------------|--------------------|
47+
| [Brotli](https://github.com/google/ngx_brotli) | Brotli compression support with modules for dynamic compression and for serving pre-compressed `.br` files. | [`nginx-plus-module-brotli`](#) |
48+
| [Encrypted-Session](https://github.com/openresty/encrypted-session-nginx-module) | AES-256 based encryption/decryption of NGINX variables. | [`nginx-plus-module-encrypted-session`](#) |
49+
| [FIPS Status Check](https://github.com/ogarrett/nginx-fips-check-module) | Verifies if OpenSSL is operating in FIPS mode. | [`nginx-plus-module-fips-check`](#)|
50+
| [GeoIP2](https://github.com/leev/ngx_http_geoip2_module) | Uses MaxMind GeoIP2 for enhanced geolocation. | [`nginx-plus-module-geoip2`](#)|
51+
| [Headers-More](https://github.com/openresty/headers-more-nginx-module) | Extends the NGINX [Headers](https://nginx.org/en/docs/http/ngx_http_headers_module.html) module to modify request and response headers. | [`nginx-plus-module-headers-more`](#) |
52+
| [HTTP Substitutions Filter](https://github.com/yaoweibin/ngx_http_substitutions_filter_module) | Enables regex and string-based substitutions in response bodies. | [`nginx-plus-module-subs-filter`](#) |
53+
| [Lua](https://github.com/openresty/lua-nginx-module) | Embeds Lua programming language. | [`nginx-plus-module-lua`](#)|
54+
| [NGINX Developer Kit](https://github.com/vision5/ngx_devel_kit) | Provides helper macros for module development. | [`nginx-plus-module-ndk`](#) |
55+
| [Phusion Passenger](https://www.phusionpassenger.com/library/install/nginx/) | Application server for Node.js, Python, Ruby. | [`nginx-plus-module-passenger`](#) |
56+
| [Prometheus-njs](https://github.com/nginx/nginx-prometheus-exporter) | Converts [NGINX Plus metrics](https://demo.nginx.com/swagger-ui/) into Prometheus format. | [`nginx-plus-module-prometheus`](#) |
57+
| [RTMP](https://github.com/arut/nginx-rtmp-module) | Adds streaming capabilities (RTMP, HLS, MPEG-DASH, FFmpeg support).| [`nginx-plus-module-rtmp`](#) |
58+
| [Set-Misc](https://github.com/openresty/set-misc-nginx-module) | Adds `set_*` directives for scripting (extend NGINX [Rewrite](https://nginx.org/en/docs/http/ngx_http_rewrite_module.html) module). | [`nginx-plus-module-set-misc`](#) |
59+
| [SPNEGO for Kerberos](https://github.com/stnoonan/spnego-http-auth-nginx-module) | Adds support for [GSS‑API based](https://www.rfc-editor.org/rfc/rfc2743) SPNEGO/Kerberos authentication. | [`nginx-plus-module-auth-spnego`](#) |
60+
{{< /bootstrap-table >}}

0 commit comments

Comments
 (0)