strapi/docs/3.0.0-beta.x/migration-guide/migration-guide-alpha.12.6-to-alpha.12.7.md
2019-11-07 12:05:39 +01:00

60 lines
1.8 KiB
Markdown

# Migration guide from alpha.12.6 to alpha.12.7
**Here are the major changes:**
- Yarn support
- Search in generated API
**Useful links:**
- Changelog: [https://github.com/strapi/strapi/releases/tag/v3.0.0-alpha.12.7](https://github.com/strapi/strapi/releases/tag/v3.0.0-alpha.12.7)
- GitHub diff: [https://github.com/strapi/strapi/compare/v3.0.0-alpha.12.6...v3.0.0-alpha.12.7](https://github.com/strapi/strapi/compare/v3.0.0-alpha.12.6...v3.0.0-alpha.12.7)
<br>
::: tip
Feel free to [join us on Slack](http://slack.strapi.io) and ask questions about the migration process.
:::
<br>
## Getting started
Install Strapi `alpha.12.7` globally on your computer. To do so run `npm install strapi@3.0.0-alpha.12.7 -g`.
When it's done, generate a new empty project `strapi new myNewProject` (don't pay attention to the database configuration).
<br>
## Update node modules
Update the Strapi's dependencies version (move Strapi's dependencies to `3.0.0-alpha.12.7` version) of your project.
Run `npm install strapi@3.0.0-alpha.12.7 --save` to update your strapi version and then run the same command for `strapi-mongoose` or `strapi-bookshelf` depending on the module you use in your application.
<br>
## Update the Admin
::: tip
If you performed updates in the Admin, you will have to manually migrate your changes.
:::
Delete your old admin folder and replace it with the new one.
<br>
## Update the Plugins
::: tip
If you did a custom update on one of the plugins, you will have to manually migrate your update.
:::
Copy the fields and relations you had in your `/plugins/users-permissions/models/User.settings.json` and `/plugins/users-permissions/config/jwt.json` file in the new one.
Then, delete your old `plugins` folder and replace it with the new one.
<br>
That's all, you have now upgraded to Strapi `alpha.12.7`.