docs: add upgrade guide for 1.3.8 (#2170)

* add upgrade guide for 1.3.8

* added to sidebar

* added announcement bar
This commit is contained in:
Shahed Nasser
2022-09-09 13:26:19 +03:00
committed by GitHub
parent 866ba8287d
commit c66e908099
3 changed files with 46 additions and 0 deletions

View File

@@ -0,0 +1,33 @@
# v1.3.8
Updating your medusa server to version `1.3.8` may cause issues when using NPM. Please refer to this guide for more details on how to resolve it.
## Update Using Yarn
We highly recommend using [yarn](https://yarnpkg.com/) when working with Medusa. Updating with yarn should resolve any issues you might run into during the update.
## Resolving Update Issues with NPM
### Update All Medusa Dependencies
If you face any errors during your update to version `1.3.8`, make sure to update all Medusa dependencies youre using on your server. This includes `medusa-interfaces`, `@medusajs/medusa-cli`, or any of Medusas official plugins.
You can update to the latest version of these using the `@latest` version tag. For example:
```bash
npm install medusa-interfaces@latest
```
### Use Legacy Peer Dependencies Option
:::caution
This solution can be used as a workaround and should be used with caution to avoid any issues while using Medusa.
:::
If all fails, you can use the `--legacy-peer-deps` option while updating Medusa:
```bash
npm install @medusajs/medusa@latest --legacy-peer-deps
```