Skip to content

Conversation

arussellf5
Copy link
Contributor

This will help users who have outgrown their basic plan deployment and wish to recreate their deployment on the standard plan.

I also grouped all the migration and plan change docs together. The existing migration doc was always out of place within the "Getting Started" section of our docs. We plan to use the "Change pricing plan" section to include more details about changing from basic to standard plans. There may be further docs here about migrating from standard v2 to v3.

@arussellf5 arussellf5 requested a review from a team as a code owner October 22, 2025 21:05
@github-actions github-actions bot added documentation Improvements or additions to documentation product/nginxaas-azure Issues related to NGINX as a Service for Azure labels Oct 22, 2025
@github-actions
Copy link

Deploy Preview will be available once build job completes!

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

Copy link
Contributor

@JTorreG JTorreG left a comment

Choose a reason for hiding this comment

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

Approved with nits

Copy link
Contributor

@mjang mjang left a comment

Choose a reason for hiding this comment

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

Non-blocking suggestion. If true, we can explicitly refer to the template file as template.json

@arussellf5 arussellf5 force-pushed the nginxaas-migrate-to-standard-plan branch from c73b4b3 to 00fd888 Compare October 22, 2025 21:23
…plan

This will help users who have outgrown their basic plan deployment and wish to recreate their deployment on the standard plan. Also moved the existing standard -> standard v2 migration doc. This was always out of place within the "Getting Started" section of our docs. We plan to use the "Change pricing plan" section to include more details about changing from basic to standard plans. There may be further docs here about migrating from standard v2 to v3.
@arussellf5 arussellf5 force-pushed the nginxaas-migrate-to-standard-plan branch from 00fd888 to 21c11db Compare October 23, 2025 15:42
@arussellf5 arussellf5 merged commit 708f1e5 into main Oct 23, 2025
8 checks passed
@arussellf5 arussellf5 deleted the nginxaas-migrate-to-standard-plan branch October 23, 2025 15:43
1. Decompress the template archive.
1. Open the `template.json` file and verify that the data in the template is correct.
1. In the `resources` section, change `sku.name` to `standardv2_Monthly`. This recreates the deployment as a standard plan deployment.
1. Delete the original basic plan deployment.
Copy link
Contributor

Choose a reason for hiding this comment

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

Is it necessary to do this step first? Won't the new deployment have a new IP address? I would think they'd want to change the DNS mapping first (which we can't be specific about) and then when they know it's rerouting traffic, they can delete the original basic plan deployment.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

If they care that much about preserving existing traffic, then they can refer to the recreate deployment guide (which I reference in this page). My intention was to give users a quick and easy way to recreate the deployment. The order of the step is intentional. If they wish to preserve the backing resources, such as the deployment's frontend IP address, there would be conflicts if they did not delete the original deployment first. FYI this PR is now merged, so I'll need to open a new PR with any emendations we wish to make.

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 product/nginxaas-azure Issues related to NGINX as a Service for Azure

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants