yujunjun/strapi
1
0
Fork 0
mirror of https://github.com/strapi/strapi.git synced 2025-11-02 10:55:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add migration guide

Browse Source
This commit is contained in:
Jim LAURIE 2019-03-14 12:23:14 +01:00
parent a63afc888f
commit 29b5139695
2 changed files with 70 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
docs/3.x.x/migration-guide/README.md
View File

@ -30,3 +30,4 @@
- [Migration guide from alpha.21 to alpha.22](migration-guide-alpha.21-to-alpha.22.md)
- [Migration guide from alpha.22 to alpha.23](migration-guide-alpha.22-to-alpha.23.md)
- [Migration guide from alpha.23 to alpha.24](migration-guide-alpha.23-to-alpha.24.md)
- [Migration guide from alpha.24 to alpha.25](migration-guide-alpha.24-to-alpha.25.md)

69
docs/3.x.x/migration-guide/migration-guide-alpha.24-to-alpha.25.md Normal file
View File

@ -0,0 +1,69 @@
# Migration guide from alpha.24 to alpha.25
**Here are the major changes:**
- Getting started videos helper in the admin
- New getting started
**Useful links:**
- Changelog: [https://github.com/strapi/strapi/releases/tag/v3.0.0-alpha.25](https://github.com/strapi/strapi/releases/tag/v3.0.0-alpha.25)
- GitHub diff: [https://github.com/strapi/strapi/compare/v3.0.0-alpha.23...v3.0.0-alpha.25](https://github.com/strapi/strapi/compare/v3.0.0-alpha.23...v3.0.0-alpha.25)
<br>
::: note
Feel free to [join us on Slack](http://slack.strapi.io) and ask questions about the migration process.
:::
<br>
## Getting started
Install Strapi `alpha.25` globally on your computer. To do so run `npm install strapi@3.0.0-alpha.25 -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.25` version) of your project.
Run `npm install strapi@3.0.0-alpha.25 --save` to update your strapi version.
<br>
## Update the Admin
::: note
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
::: note
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.
## Update Mongoose
Update all your API services by following this update https://github.com/strapi/strapi/pull/2812/files#diff-c36b911d1bc2922e1d7cf93ae692e054R132
## Update Bookshelf
Update all your API services by following this update https://github.com/strapi/strapi/pull/2970/files#diff-61ba361ed6161efcd5f4e583001cc9c9R240 and https://github.com/strapi/strapi/pull/2864/files#diff-61ba361ed6161efcd5f4e583001cc9c9R124
We update the name of the life cycle for the before/after fetch all https://github.com/strapi/strapi/pull/2965/files
You will have to replace `beforeFetchCollection` by `beforeFetchAll` if you added theses functions in you `Model.js` files.
<br>
That's all, you have now upgraded to Strapi `alpha.25`.