strapi/docs/v3.x/migration-guide/migration-guide-alpha.12.7-to-alpha.13.md

66 lines
2.1 KiB
Markdown
Raw Normal View History

2018-12-14 17:06:05 +01:00
# Migration guide from alpha.12.7 to alpha.13
**Here are the major changes:**
- Rename hook name
- New settings for content manager plugin
**Useful links:**
2019-11-07 12:05:39 +01:00
2018-12-14 17:06:05 +01:00
- Changelog: [https://github.com/strapi/strapi/releases/tag/v3.0.0-alpha.13](https://github.com/strapi/strapi/releases/tag/v3.0.0-alpha.13)
- GitHub diff: [https://github.com/strapi/strapi/compare/v3.0.0-alpha.12.7...v3.0.0-alpha.13.0.1](https://github.com/strapi/strapi/compare/v3.0.0-alpha.12.7...v3.0.0-alpha.13.0.1)
<br>
2019-11-07 12:05:39 +01:00
::: tip
2018-12-14 17:06:05 +01:00
Feel free to [join us on Slack](http://slack.strapi.io) and ask questions about the migration process.
:::
<br>
## Getting started
Install Strapi `alpha.13` globally on your computer. To do so run `npm install strapi@3.0.0-alpha.13.0.1 -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.13.0.1` version) of your project.
Run `npm install strapi@3.0.0-alpha.13.0.1 --save` to update your strapi version.
<br>
## Update the Admin
2019-11-07 12:05:39 +01:00
::: tip
2018-12-14 17:06:05 +01:00
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
2019-11-07 12:05:39 +01:00
::: tip
2018-12-14 17:06:05 +01:00
If you did a custom update on one of the plugins, you will have to manually migrate your update.
:::
2019-01-06 14:00:04 +01:00
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.
2018-12-14 17:06:05 +01:00
Then, delete your old `plugins` folder and replace it with the new one.
<br>
## ⚠️ Update hook name
We update the name of the hook and the way we load them. `strapi-mongoose` is now `strapi-hook-mongoose`. This rename is needed for `strapi-bookshelf` and `strapi-knex`.
As you can imagine, you also will have to update your hooks' dependencies in the `package.json` of your application.
You also will have to update connectors of you database connections. Update in `./config/environments/**/database.json` file the `connector` key.
That's all, you have now upgraded to Strapi `alpha.13`.