Skip to content

Commit

Permalink
Apply suggestions from code review
Browse files Browse the repository at this point in the history
Co-authored-by: Alan Dooley <[email protected]>
  • Loading branch information
sjberman and ADubhlaoich authored Nov 14, 2024
1 parent a0126a6 commit 706ddd4
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 7 deletions.
4 changes: 2 additions & 2 deletions site/content/installation/installing-ngf/helm.md
Original file line number Diff line number Diff line change
Expand Up @@ -209,8 +209,8 @@ To upgrade the CRDs, take the following steps:
### Upgrade NGINX Gateway Fabric release
{{<important>}}NGINX Plus users that are upgrading from version 1.4.0 to 1.5.0 need to install an NGINX Plus JWT
Secret before upgrading. Follow the steps in the [Before you begin](#before-you-begin) section to create the Secret. If you use a different name than the default `nplus-license` name, specify the Secret name by setting `--set nginx.usage.secretName=<secret-name>` when running `helm upgrade`.{{</important>}}
{{< important >}} NGINX Plus users that are upgrading from version 1.4.0 to 1.5.0 need to install an NGINX Plus JWT
Secret before upgrading. Follow the steps in the [Before you begin](#before-you-begin) section to create the Secret. If you use a different name than the default `nplus-license` name, specify the Secret name by setting `--set nginx.usage.secretName=<secret-name>` when running `helm upgrade`. {{</ important >}}
#### Upgrade from the OCI registry
Expand Down
10 changes: 5 additions & 5 deletions site/content/installation/nginx-plus-jwt.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,15 @@ docs: "DOCS-000"

## Overview

NGINX Gateway Fabric with NGINX Plus requires a valid JSON Web Token (JWT) to download the container image from the F5 registry. In addition, starting with version 1.5.0, this JWT token is also required to run NGINX Plus.
NGINX Gateway Fabric with NGINX Plus requires a valid JSON Web Token (JWT) to download the container image from the F5 registry. From version 1.5.0, this JWT token is also required to run NGINX Plus.

This requirement is part of F5’s broader licensing program and aligns with industry best practices. The JWT will streamline subscription renewals and usage reporting, helping you manage your NGINX Plus subscription more efficiently. The [telemetry](#telemetry) data we collect helps us improve our products and services to better meet your needs.

The JWT is required for validating your subscription and reporting telemetry data. For environments connected to the internet, telemetry is automatically sent to F5’s licensing endpoint. In offline environments, telemetry is routed through [NGINX Instance Manager](https://docs.nginx.com/nginx-instance-manager/). Usage is reported every hour and on startup whenever NGINX is reloaded.

## Setting up the JWT
## Set up the JWT

The JWT needs to be configured before deploying NGINX Gateway Fabric. We'll store the JWT in two Kubernetes Secrets. One will be used for downloading the NGINX Plus container image, and the other for running NGINX Plus.
The JWT needs to be configured before deploying NGINX Gateway Fabric. The JWT will be stored in two Kubernetes Secrets: one for downloading the NGINX Plus container image, and the other for running NGINX Plus.

{{< include "installation/jwt-password-note.md" >}}

Expand Down Expand Up @@ -172,7 +172,7 @@ ssl_certificate_key /etc/nginx/certs-bootstrap/tls.key;

**Once these Secrets are created and configuration options are set, you can now [install NGINX Gateway Fabric]({{< relref "installation/installing-ngf" >}}).**

## Installation flags for configuring usage reporting {#flags}
## Installation flags to configure usage reporting {#flags}

When installing NGINX Gateway Fabric, the following flags can be specified to configure usage reporting to fit your needs:

Expand Down Expand Up @@ -215,7 +215,7 @@ All communication between your NGINX Plus instances, NGINX Instance Manager, and

Only **operational metrics** are reported — no **personally identifiable information (PII)** or **sensitive customer data** is transmitted.

## Pulling an image for local use
## Pull an image for local use

To pull an image for local use, use this command:

Expand Down

0 comments on commit 706ddd4

Please sign in to comment.