General Upgrade Steps
This guide takes you through the recommended steps to take when upgrading your Panfactum version.
Before you being, please ensure you have reviewed the guide for pinning the Panfactum version.
Review the Changelogs
Some version upgrades require taking specific actions that we call out in the new release's changelog. Make sure you have reviewed the changes and understand what steps you need to take.
Update Local Development Environment
-
Update the version in your
flake.nix
file. -
Run
nix flake update
. This will update your lockfile and then download the new versions of all utilities. -
If you receive some warnings when your
devenv
reloads, run the recommended commands to update your repo files.
Update your Infrastructure
-
If you use Panfactum terraform modules in your organization's terraform modules, update the
ref
across all of your modules. -
If you deploy Panfactum modules directly via terragrunt, update the
ref
across only your lowest environment level 1. -
Ensure that the terragrunt
version
for that environment is set tolocal
(review these docs) 2. -
On your local machine, run
terragrunt apply
across all modules in that environment. -
Check to ensure that the environment is functioning as expected.
-
Once you are satisfied, cut a new release of your stack repository indicating you have updated the Panfactum version.
-
Repeat step 2-5 for all environments in sequence, testing each environment before moving on to the next. For step 3, set the
version
to the release ref that you created in step 6.