[DOCU-3215] 3.3 upgrade guide #5590
Merged
Conversation
This file contains 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
Signed-off-by: Diana <[email protected]>
Signed-off-by: Diana <[email protected]>
Signed-off-by: Diana <[email protected]>
cloudjumpercat
added
the
review:sme
✅ Deploy Preview for kongdocs ready!
To edit notification comments on pull requests, go to your Netlify site settings. |
Signed-off-by: Diana <[email protected]>
2 tasks
cloudjumpercat
commented
May 17, 2023
cloudjumpercat
commented
May 17, 2023
|
❗ Reviewers: Also, got this feedback from Slack and I'm not sure which path is the correct one: "Current the upgrade page says if you are on 2.8 upgrade to 3.1.x then to 3.2.x BUT if you click on the link which takes you to the 3.1.x upgrade page it then says, go 2.8->3.0->3.1 - honestly that is very confusing for users and I think we need to make that a bit clearer" |
cloudjumpercat
added
review:copyedit
lena-larionova
approved these changes
May 18, 2023
Co-authored-by: lena-larionova <[email protected]>
lena-larionova
added a commit
that referenced
this pull request
May 19, 2023
* gateway 3.3 metadata * feat(proxy-cache): add ignore_uri_case to configuring cache-key uri to be handled as lowercase (#5270) * feat(proxy-cache): add cache_lowercase_uri param * renaming parameter to ignore_uri_case * feat(proxy-cache): apply suggestions from code review Co-authored-by: Diana <[email protected]> * feat(proxy-cache): removed in proxy-cache-advanced * feat(proxy-cache): apply suggestions from code review Co-authored-by: Samuele Illuminati <[email protected]> * feat(proxy-cache): add param to plugin-ignore --------- Co-authored-by: Diana <[email protected]> Co-authored-by: Samuele Illuminati <[email protected]> * docs(acme): add account_key for acme plugin (#5222) * docs(acme): add account_key for acme plugin * docs(acme): add keys/keyset configuration for acme plugin * Update app/_hub/kong-inc/acme/_index.md Co-authored-by: lena-larionova <[email protected]> * Update app/_hub/kong-inc/acme/_index.md Co-authored-by: lena-larionova <[email protected]> * Update app/_hub/kong-inc/acme/_index.md Co-authored-by: lena-larionova <[email protected]> * Update app/_hub/kong-inc/acme/_index.md Co-authored-by: lena-larionova <[email protected]> --------- Co-authored-by: lena-larionova <[email protected]> * feat(logging): add workspace name in the logging payload (#5251) Co-authored-by: lena.larionova <[email protected]> * docs(http-log): plugin schema update for 3.3 (#5326) * feat(plugins): added second available content-type option to http-log plugin * add version tags and a changelog entry --------- Co-authored-by: lena-larionova <[email protected]> * docs(proxy-cache-advanced): add ignore_uri_case (#5458) * docs(proxy-cache-advanced): add ignore_uri_case add ignore_uri_case parameter to proxy-cache-advanced docs * Update app/_hub/kong-inc/proxy-cache-advanced/_index.md Co-authored-by: lena-larionova <[email protected]> * Set minimum version on param --------- Co-authored-by: lena-larionova <[email protected]> * docs(request-transformer): untrusted_lua (#5499) add changelog for untrusted lua to request transformer and request transformer advanced plugins * docs(aws-lambda): add new disable_https field (#5486) * docs(aws-lambda): add new disable_https field * add changelog entry * phrasing adjustment for changelog --------- Co-authored-by: lena-larionova <[email protected]> * docs(3.3) remove references to 'default tracing_sampling_rate' (#5517) * docs(acme): support redis namespace (#5366) * docs(acme): support redis namespace correspond to [Kong/kong#10562](Kong/kong#10562) `namespace` will be treated as a prefix of key and is default to empty string `""` for backward compatibility. `namespace` must not be prefixed with any of the reserved words. [KAG-615](https://konghq.atlassian.net/browse/KAG-615) * update * Fix Vale errors Signed-off-by: Diana <[email protected]> * Apply suggestions from code review --------- Signed-off-by: Diana <[email protected]> Co-authored-by: Diana <[email protected]> * feat(proxy-cache): add wildcard and parameter match support for content_type (#5420) * feat(proxy-cache): add wildcard and parameter match support for content_type * Apply suggestions from code review Co-authored-by: Michael Heap <[email protected]> * set version tags for 3.3; add missing changelog entry for proxy cache --------- Co-authored-by: lena-larionova <[email protected]> Co-authored-by: Michael Heap <[email protected]> Co-authored-by: lena.larionova <[email protected]> * datadog: now host is referenceable (#5353) * datadog: now host is referenceable * Update app/_hub/kong-inc/datadog/_index.md Co-authored-by: lena-larionova <[email protected]> * kubernetes section * Apply suggestions from code review Co-authored-by: lena-larionova <[email protected]> * Update app/_hub/kong-inc/datadog/_index.md Co-authored-by: Harry <[email protected]> * - fix indents - add changelog entry - adjust phrasing for intro to kubernetes section and add navtabs - set version tags --------- Co-authored-by: lena-larionova <[email protected]> Co-authored-by: Victor Yu <[email protected]> Co-authored-by: Harry <[email protected]> Co-authored-by: lena.larionova <[email protected]> * [DOCU-3216] Status Endpoint link (#5541) * add status endpoint * add absolute_url * Fix description of routing priorities with multiple paths (#5533) * Fix description of routing priorities with multiple paths * Apply suggestions from code review --------- Co-authored-by: Diana <[email protected]> * Revert "feat(logging): add workspace name in the logging payload (#52… (#5547) Revert "feat(logging): add workspace name in the logging payload (#5251)" This reverts commit 37df8eb. * fix(oauth2): add a changelog entry (#5548) * fix(oauth2): add a changelog entry * rephrase for clarity --------- Co-authored-by: lena-larionova <[email protected]> * [DOCU-2921] Status endpoint + Kong health check (#5419) * Create health-check.md New page + tutorial tempalte for KAG-76 * docs: health check * Update health-check.md * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Chrono <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Chrono <[email protected]> * Update health-check.md * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Chrono <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Update app/_src/gateway/production/monitoring/health-check.md Co-authored-by: Datong Sun <[email protected]> * Change some phrasing These are all small adjustments. * Update status_listen enablement step * s/configured/enabled/ to match other updates * Add response examples to usage instructions * Fixup code blocks * Add health check link to navbar * Fixup response code/messages * Use the correct link syntax * Add reference to monitoring index/overview * Inline port number comment in yaml block * Prettify JSON for readability * Update app/_src/gateway/production/monitoring/index.md Co-authored-by: Vinicius Mignot <[email protected]> * readiness instead of health * Apply suggestions from code review Co-authored-by: Vinicius Mignot <[email protected]> * s/ready to work/ready to accept requests/ * add control_plane explanation * apply review suggestions * more review comments addressing * Update app/_src/gateway/production/monitoring/readiness-check.md Co-authored-by: Harry <[email protected]> * Revert "Update app/_src/gateway/production/monitoring/readiness-check.md" This reverts commit d68d904. * wording and formatting * Copy edit * link --------- Co-authored-by: pluveto <[email protected]> Co-authored-by: Zijing Zhang <[email protected]> Co-authored-by: Chrono <[email protected]> Co-authored-by: Datong Sun <[email protected]> Co-authored-by: Michael Martin <[email protected]> Co-authored-by: Michael Martin <[email protected]> Co-authored-by: Chrono <[email protected]> Co-authored-by: Vinicius Mignot <[email protected]> Co-authored-by: Harry <[email protected]> Co-authored-by: Angel <[email protected]> * Reworked plugin queues (#5088) * Reworked plugin queues documentation * Add queueing parameters to relevant plugin docs * Mention queues in sizing guidelines * Add batch queue overview and reference * Remove consumer batching section, add results sentence to why queues are needed Signed-off-by: Diana <[email protected]> * Apply copy edits Co-authored-by: Hans Hübner <[email protected]> * Rework how queue parameters are included in plugin docs * Can't include paramters * Quote queue parameter names * remove comment * remove comment * Change batch queue to queue, fix links, add link to Zipkin to about plugin queues Signed-off-by: Diana <[email protected]> * Fix links to queue reference Signed-off-by: Diana <[email protected]> * Apply conditional rendering to queue content * Add conditional rendering to queue parameters * Fix minimum_version spacing Signed-off-by: Diana <[email protected]> * Fix queue param spacing in http log plugin doc Signed-off-by: Diana <[email protected]> * Apply suggestions from code review Co-authored-by: Diana <[email protected]> Co-authored-by: Angel <[email protected]> * Update app/_src/gateway/production/sizing-guidelines.md Co-authored-by: Angel <[email protected]> * Fix link and add conditional rendering to sizing guidelines page --------- Signed-off-by: Diana <[email protected]> Co-authored-by: Diana <[email protected]> Co-authored-by: Angel <[email protected]> * [DOCU-3051] Auto docs 3.3 (#5549) * autodocs * Apply suggestions from code review * config.md add EE info * Update app/_src/gateway/reference/configuration.md Co-authored-by: lena-larionova <[email protected]> --------- Co-authored-by: lena-larionova <[email protected]> * Timeout support for dynamic log levels (#5550) * Timeout support for dynamic log levels KAG-5 DOCU-2903 * Update app/_src/gateway/production/logging/update-log-level-dynamically.md * Update app/_src/gateway/production/logging/update-log-level-dynamically.md --------- Co-authored-by: Angel <[email protected]> * Spec links (#5553) add links to specs * chore: update 3.3 nav to include all updates in 3.2 * [DOCU-3065] Data plane labels in konnect (#5554) * document using custom dp labels in konnect * Update app/konnect/runtime-manager/runtime-instances/custom-dp-labels.md --------- Co-authored-by: Angel <[email protected]> * [DOCU-3167] Add Amazon Linux 2023 to support page (#5536) * Add Amazon Linux 2023 to support page Signed-off-by: Diana <[email protected]> * Add Amazon Linux 2023 tab to install instructions Signed-off-by: Diana <[email protected]> * Apply suggestions from code review Co-authored-by: lena-larionova <[email protected]> * Add 3.3 to browser and third-party support, add AL2023 Yum repo tab Signed-off-by: Diana <[email protected]> * Update app/_data/tables/support/gateway/versions/33.yml Co-authored-by: lena-larionova <[email protected]> * Add Amazon Graviton note to install pages Signed-off-by: Diana <[email protected]> * Remove mentions of Graviton Signed-off-by: Diana <[email protected]> * Fix EOL date for 3.3 Signed-off-by: Diana <[email protected]> --------- Signed-off-by: Diana <[email protected]> Co-authored-by: lena-larionova <[email protected]> * Revert "[DOCU-3167] Add Amazon Linux 2023 to support page" (#5559) Revert "[DOCU-3167] Add Amazon Linux 2023 to support page (#5536)" This reverts commit 9c64603. * Fixes to log level doc (#5570) fixes * Support page updates for 3.3 (#5569) * update support pages for 3.3 * update one more version Co-authored-by: Angel <[email protected]> --------- Co-authored-by: Angel <[email protected]> * Fix errors after rebase * feat: add aws iam authentication to rds feature document (#5503) * feat: add aws iam authentication to rds feature document * refine doc * add more tips * ssl maximum version is limited by rds * add mentioning cluster resource id syntax for aurora * adjust a bit about IAM role assignment and add the case of running kong locally * make onboarding smoother by providing ways to connect to rds using psql; refine the wording on read/write and read/only mode description * mention tlsv1.3 not supported one more time in the limitations; refine wording of the highlight of this feature * Edit title, introduction, and start of prereqs section Signed-off-by: Diana <[email protected]> * Finish copy edits Signed-off-by: Diana <[email protected]> * Apply tech review feedback Signed-off-by: Diana <[email protected]> * Fix some grammar errors and spelling Signed-off-by: Diana <[email protected]> * Apply suggestions from code review Co-authored-by: Qirui(Keery) Nie <[email protected]> * Update app/_src/gateway/kong-enterprise/aws-iam-auth-to-rds-database.md Co-authored-by: Qirui(Keery) Nie <[email protected]> * Fix limitations descriptions based on tech review feedback Signed-off-by: Diana <[email protected]> --------- Signed-off-by: Diana <[email protected]> Co-authored-by: Diana <[email protected]> * Plugin queuing diagrams (#5583) * Add plugin queue diagrams Signed-off-by: Diana <[email protected]> * Fix Figure number on second one Signed-off-by: Diana <[email protected]> --------- Signed-off-by: Diana <[email protected]> * add 3.3 compatibility table updates (#5573) add 3.3 compatability issues Adds compatability issues for release 3.3. * Remove centos from 3.3 support table * [DOCU-3169] Changelog for gateway 3.3.0.0 (#5562) * changelog for gateway 3.3.0.0 * added reminders about deprecations and links to API specs * set release date * [DOCU-3215] 3.3 upgrade guide (#5590) * Add upgrade table for 3.3 Signed-off-by: Diana <[email protected]> * Fix rolling upgrades column for 3.1.x releases * Add info about plugin queue breaking changes to upgrade doc Signed-off-by: Diana <[email protected]> * Add traditional_compat and Plugins to breaking changes section Signed-off-by: Diana <[email protected]> * Fix changelog link Signed-off-by: Diana <[email protected]> * Apply suggestions from code review Co-authored-by: lena-larionova <[email protected]> --------- Signed-off-by: Diana <[email protected]> Co-authored-by: lena-larionova <[email protected]> * [docu-3186] SOBM page (#5558) * add page * Apply suggestions from code review Co-authored-by: lena-larionova <[email protected]> * rename --------- Co-authored-by: lena-larionova <[email protected]> * [fix] 3.2.2 changelog (#5605) * fix 3.2.2 changelog * move content into the right places --------- Co-authored-by: lena.larionova <[email protected]> * Add known issues to 3.3 changelog (#5599) * lmdb known issue * adding more known issues * spacing * Apply suggestions from code review Co-authored-by: Datong Sun <[email protected]> --------- Co-authored-by: Angel <[email protected]> Co-authored-by: Datong Sun <[email protected]> --------- Signed-off-by: Diana <[email protected]> Co-authored-by: Tobias Lindberg <[email protected]> Co-authored-by: Diana <[email protected]> Co-authored-by: Samuele Illuminati <[email protected]> Co-authored-by: Steve Zesch <[email protected]> Co-authored-by: Xiaoyan Rao <[email protected]> Co-authored-by: Jack Tysoe <[email protected]> Co-authored-by: Qirui(Keery) Nie <[email protected]> Co-authored-by: Enrique García Cota <[email protected]> Co-authored-by: Zhefeng C <[email protected]> Co-authored-by: Yusheng Li <[email protected]> Co-authored-by: Michael Heap <[email protected]> Co-authored-by: Xumin <[email protected]> Co-authored-by: Victor Yu <[email protected]> Co-authored-by: Harry <[email protected]> Co-authored-by: Angel <[email protected]> Co-authored-by: Hans Hübner <[email protected]> Co-authored-by: Amy Goldsmith <[email protected]> Co-authored-by: pluveto <[email protected]> Co-authored-by: Zijing Zhang <[email protected]> Co-authored-by: Chrono <[email protected]> Co-authored-by: Datong Sun <[email protected]> Co-authored-by: Michael Martin <[email protected]> Co-authored-by: Michael Martin <[email protected]> Co-authored-by: Chrono <[email protected]> Co-authored-by: Vinicius Mignot <[email protected]> Co-authored-by: Murillo <[email protected]> Co-authored-by: Fabian Rodriguez <[email protected]> Co-authored-by: Alex Gaesser <[email protected]>
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.
Description
What did you change and why?
Include any supporting resources, e.g. link to a Jira ticket, GH issue, FTI, Slack, Aha, etc.
DOCU-3215
Note: I recreated this PR from #5557 because that one had issues with a rebase and added a bunch of unnecessary commits.
Testing instructions
Netlify link:
Checklist
mainfor immediate publishing, or a release branch: e.g.release/gateway-3.2,release/deck-1.17)