NGF: Upgrade NGF from 1.x to 2.x #564
Open
+108
−1
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
github-actions
bot
added
documentation
salonichf5
force-pushed
the
docs/upgrade-ngf
branch
from
c9bc7ef to
201fb04
Compare
salonichf5
force-pushed
the
docs/upgrade-ngf
branch
2 times, most recently
from
7147105 to
527d8d9
Compare
sjberman
reviewed
May 20, 2025
| @@ -0,0 +1,96 @@ | |||
| --- | |||
There was a problem hiding this comment.
I'm thinking this doc should be top level of our docs for now. It probably won't be a permanent doc, though users are slow to upgrade, so it'll be around for awhile. But I want it to be obvious for users. @ADubhlaoich what do you think?
|
|
||
| With this release, NGINX Gateway Fabric adopts a new architecture that separates the control plane and data plane into independent deployments. This separation improves scalability, security, and operational clarity. | ||
|
|
||
| The control plane is a Kubernetes controller built with `controller-runtime`. It watches Gateway API and Kubernetes resources (e.g., Services, Endpoints, Secrets) and dynamically provisions NGINX data plane deployments for each Gateway. |
There was a problem hiding this comment.
This context isn't necessary for this doc.
salonichf5
force-pushed
the
docs/upgrade-ngf
branch
from
6a8f7be to
482e8c2
Compare
sjberman
reviewed
May 20, 2025
salonichf5
changed the title
salonichf5
force-pushed
the
docs/upgrade-ngf
branch
2 times, most recently
from
16ee0c1 to
13be7da
Compare
✅ Deploy Preview will be available once build job completes!
|
salonichf5
force-pushed
the
docs/upgrade-ngf
branch
2 times, most recently
from
c4fec32 to
7ab7aed
Compare
Co-authored-by: Saylor Berman <s.berman@f5.com>
salonichf5
force-pushed
the
docs/upgrade-ngf
branch
from
7ab7aed to
93f159b
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Proposed changes
Write a clear and concise description that helps reviewers understand the purpose and impact of your changes. Use the
following format:
Problem: Users need documentation to upgrade from NGF v1.6.x to v2.0.x
Solution: Adds an upgrade document with instructions to upgrade
Testing: Describe any testing that you did.
Please focus on (optional): If you any specific areas where you would like reviewers to focus their attention or provide
specific feedback, add them here.
If this PR addresses an issue on GitHub, ensure that you link to it here:
Closes #ISSUE
nginx/nginx-gateway-fabric#3241
Checklist
Before merging a pull request, run through this checklist and mark each as complete.
README.mdandCHANGELOG.mdFootnotes
Potentially sensitive changes include anything involving code, personally identify information (PII), live URLs or significant amounts of new or revised documentation. Please refer to our style guide for guidance about placeholder content. ↩