Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

NGINX Plus R33 support #2760

Merged
merged 18 commits into from
Nov 19, 2024
Merged

NGINX Plus R33 support #2760

merged 18 commits into from
Nov 19, 2024

Conversation

sjberman
Copy link
Collaborator

@sjberman sjberman commented Nov 8, 2024

Adding support for NGINX Plus R33. The major change with this release is that NGINX Plus now requires a JWT in order to run. A user must create a Secret with this JWT and supply the secret name to NGF when installing. A user can also create client SSL and CA Secrets for NIM connections. All of these Secrets are mounted to the nginx container.

Because of the new usage reporting method, the old usage reporting method has been removed and CLI arguments have been altered. Since this release is a breaking change for N+ users, the choice was made to remove the unused usage reporting flags instead of deprecating them.

Updated documentation to describe this process, while also cleaning up the JWT docker registry process for N+.

Testing: Verified that usage reports are sent when everything is configured properly. Also verified that updates to the Secret are propagated.

Closes #2271
Closes #2709
Closes #2759

Original PR: #2728

Checklist

Before creating a PR, run through this checklist and mark each as complete.

  • I have read the CONTRIBUTING doc
  • I have added tests that prove my fix is effective or that my feature works
  • I have checked that all unit tests pass after adding my changes
  • I have updated necessary documentation
  • I have rebased my branch onto main
  • I will ensure my PR is targeting the main branch and pulling from my branch from my own fork

Release notes

If this PR introduces a change that affects users and needs to be mentioned in the release notes,
please add a brief note that summarizes the change.

Dev note: This should require a full section at the top of the CHANGELOG for breaking changes. The docs link here is invalid until the release goes out.

NGINX Plus R33 support added. This release of NGINX Plus requires a valid JSON Web Token (JWT) in order to run. Users of NGINX Plus *must* have this JWT added to a Secret before installing NGINX Gateway Fabric v1.5.0. See the [NGINX Plus JWT](https://docs.nginx.com/nginx-gateway-fabric/installation/nginx-plus-jwt/) guide for information on setting this up.

@github-actions github-actions bot added documentation Improvements or additions to documentation change Pull requests that introduce a change tests Pull requests that update tests helm-chart Relates to helm chart labels Nov 8, 2024
Copy link
Contributor

github-actions bot commented Nov 8, 2024

Deploy Preview will be available once build job completes!

Name Link
😎 Deploy Preview https://frontdoor-test-docs.nginx.com/previews/nginx-gateway-fabric/2760/

Copy link

codecov bot commented Nov 8, 2024

Codecov Report

Attention: Patch coverage is 83.45865% with 66 lines in your changes missing coverage. Please review.

Project coverage is 89.86%. Comparing base (e119fe7) to head (4bdef99).
Report is 138 commits behind head on main.

Files with missing lines Patch % Lines
cmd/gateway/commands.go 74.52% 24 Missing and 3 partials ⚠️
internal/mode/static/manager.go 74.44% 23 Missing ⚠️
internal/mode/static/handler.go 86.04% 4 Missing and 2 partials ⚠️
cmd/gateway/validation.go 91.42% 2 Missing and 1 partial ⚠️
internal/mode/static/nginx/config/main_config.go 95.58% 1 Missing and 2 partials ⚠️
internal/mode/static/nginx/file/folders.go 33.33% 1 Missing and 1 partial ⚠️
internal/mode/static/state/graph/graph.go 86.66% 1 Missing and 1 partial ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main    #2760      +/-   ##
==========================================
+ Coverage   89.40%   89.86%   +0.46%     
==========================================
  Files         110      107       -3     
  Lines       10913    10997      +84     
  Branches       50       50              
==========================================
+ Hits         9757     9883     +126     
+ Misses       1098     1054      -44     
- Partials       58       60       +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@sjberman sjberman force-pushed the change/nplus-reporting branch 2 times, most recently from 8624530 to a0126a6 Compare November 12, 2024 20:34
Copy link
Contributor

@ADubhlaoich ADubhlaoich left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. The documentation changes are very thorough and complete: I have some minor edit suggestions.

docs/developer/quickstart.md Outdated Show resolved Hide resolved
site/content/installation/installing-ngf/helm.md Outdated Show resolved Hide resolved
site/content/installation/installing-ngf/helm.md Outdated Show resolved Hide resolved
site/content/installation/nginx-plus-jwt.md Show resolved Hide resolved
site/content/installation/nginx-plus-jwt.md Outdated Show resolved Hide resolved
site/content/installation/nginx-plus-jwt.md Outdated Show resolved Hide resolved
site/content/installation/nginx-plus-jwt.md Outdated Show resolved Hide resolved
site/content/installation/nginx-plus-jwt.md Outdated Show resolved Hide resolved
site/content/installation/nginx-plus-jwt.md Outdated Show resolved Hide resolved
sjberman and others added 18 commits November 19, 2024 11:16
Adding support for NGINX Plus R33. The major change with this release is that NGINX Plus now requires a JWT in order to run. A user must create a Secret with this JWT and supply the secret name to NGF when installing. A user can also create client SSL and CA Secrets for NIM connections. All of these Secrets are mounted to the nginx container.

Because of the new usage reporting method, the old usage reporting method has been removed and CLI arguments have been altered. Since this release is a breaking change for N+ users, the choice was made to remove the unused usage reporting flags instead of deprecating them.

Updated documentation to describe this process, while also cleaning up the JWT docker registry process for N+.
@sjberman sjberman force-pushed the change/nplus-reporting branch from baa531c to 4bdef99 Compare November 19, 2024 18:16
@sjberman sjberman marked this pull request as ready for review November 19, 2024 18:59
@sjberman sjberman requested review from a team as code owners November 19, 2024 18:59
@sjberman sjberman merged commit 581fd74 into main Nov 19, 2024
49 of 53 checks passed
@sjberman sjberman deleted the change/nplus-reporting branch November 19, 2024 19:36
sjberman added a commit to sjberman/nginx-gateway-fabric that referenced this pull request Nov 19, 2024
Adding support for NGINX Plus R33. The major change with this release is that NGINX Plus now requires a JWT in order to run. A user must create a Secret with this JWT and supply the secret name to NGF when installing. A user can also create client SSL and CA Secrets for NIM connections. All of these Secrets are mounted to the nginx container.

Because of the new usage reporting method, the old usage reporting method has been removed and CLI arguments have been altered. Since this release is a breaking change for N+ users, the choice was made to remove the unused usage reporting flags instead of deprecating them.

Updated documentation to describe this process, while also cleaning up the JWT docker registry process for N+.
sjberman added a commit that referenced this pull request Nov 19, 2024
Adding support for NGINX Plus R33. The major change with this release is that NGINX Plus now requires a JWT in order to run. A user must create a Secret with this JWT and supply the secret name to NGF when installing. A user can also create client SSL and CA Secrets for NIM connections. All of these Secrets are mounted to the nginx container.

Because of the new usage reporting method, the old usage reporting method has been removed and CLI arguments have been altered. Since this release is a breaking change for N+ users, the choice was made to remove the unused usage reporting flags instead of deprecating them.

Updated documentation to describe this process, while also cleaning up the JWT docker registry process for N+.
@sjberman sjberman removed the change Pull requests that introduce a change label Jan 13, 2025
miledxz added a commit to miledxz/nginx-gateway-fabric that referenced this pull request Jan 14, 2025
Adding support for NGINX Plus R33. The major change with this release is that NGINX Plus now requires a JWT in order to run. A user must create a Secret with this JWT and supply the secret name to NGF when installing. A user can also create client SSL and CA Secrets for NIM connections. All of these Secrets are mounted to the nginx container.

Because of the new usage reporting method, the old usage reporting method has been removed and CLI arguments have been altered. Since this release is a breaking change for N+ users, the choice was made to remove the unused usage reporting flags instead of deprecating them.

Updated documentation to describe this process, while also cleaning up the JWT docker registry process for N+.
@sjberman sjberman added enhancement New feature or request and removed enhancement New feature or request labels Jan 15, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation helm-chart Relates to helm chart release-notes tests Pull requests that update tests
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

Docs: Broken links to 3rd party website R33 Support Docs: Improve N+ Images Docs
4 participants