mirror of
https://github.com/discourse/discourse.git
synced 2025-04-20 04:29:04 +08:00

* It only imports users and emails so far * It stores mapped IDs and usernames in a SQLite DB. In the future, we might want to copy those into the Discourse DB at the end of a migration. * The importer is split into steps which can mostly be configured with a simple DSL * Data that needs to be shared between steps can be stored in an instance of the `SharedData` class * Steps are automatically sorted via their defined dependencies before they are executed * Common logic for finding unique names (username, group name) is extracted into a helper class * If possible, steps try to avoid loading already imported data (via `mapping.ids` table) * And steps should select the `discourse_id` instead of the `original_id` of mapped IDs via SQL
Migrations Tooling
Command line interface
./bin/cli help
Converters
Public converters are stored in lib/converters/
.
If you need to run a private converter, put its code into a subdirectory of private/converters/
Development
Installing gems
bundle config set --local with migrations
bundle install
Updating gems
bundle update --group migrations
Running tests
You need to execute rspec
in the root of the project.
bin/rspec --default-path migrations/spec