What you’ll learn
- how to upgrade Webiny from 5.8.0 to 5.9.0
Before continuing, make sure to take the necessary precautions, listed in the Overview section.
Make sure to check out the 5.9.0 changelog to get familiar with all the changes introduced in this release.
First, we need to prepare your project for the upgrade process. With security packages refactor, some packages no longer exist, and if we try to upgrade dependencies straight away,
yarn will complain. To fix that, we need to clean up your project first, to eliminate references to those deprecated packages.
In your project root, run the following:
We're now ready to upgrade all
@webiny/* packages! Run the following command:
Once the upgrade has finished, running the
yarn webiny --version command in your terminal should return
Before moving on, make sure you commit all your changes.
Now let's run the project upgrade:
The upgrade script will make a couple of changes to your existing API project application's code (located within the
api folder). Once the upgrade command has finished, you can run the
git status command to see all changes that the command performed.
To finalize the upgrade, run the following command:
This takes care of a small glitch in the upgrade process, which we noticed after we released the 5.9.0 code. Gists to the rescue!
Finally, proceed by re-deploying your Webiny project:
As stated in the Overview section, we recommend that you first deploy your changes into one of your pre-production environments, like
Learn more about different deployment environments in the CI/CD / Environments key topic.
If you've been using the GraphQL API Package scaffold in your Webiny project prior to the
5.9.0 release, you will have to revisit the created
types.ts file for each created package, and replace the following line:
Replace it with the following import statement:
This change is required simply because the
@webiny/api-security-tenancy package doesn't exist anymore. Note that the new
@webiny/api-tenancy package should already exist in your project, so there's no need to add it manually.