We need to build a general purpose tool for moving a category from one Discourse instance to another.
This has come up on one of our customers and is also useful for a variety of use cases:
Use cases for category import / export
(current need) During huge migrations we may need to avoid long term downtime, so we need to run a temporary site on one domain and then ship the content (eventually) to the new imported site
In some cases category partitioning is not strong enough, we have seen this issue at the site @BCHK hosts. In cases like this it may be desirable to partition a site into 2 seperate sites.
In some cases many tiny Discourse sites are created unnecessarily and an amalgamation is desirable
A CLI tool only
The scope of this spec is for a command line tool only. There will be no GUI at all for the first version.
Topic export with layered category export
At the heart of it we need a mechanism to export a single topic as a stand alone unit that can be imported into another instance. Format wise we need to export all users , user actions and posts as single tar-csv, xml or json blob.
We are only interested in exporting “involved” users, that is, users that have tracking state, user actions or direct involvement with the topic.
Once applied to a category the export will avoid double exporting users, the format should specify users first and then content in each of the exported entities.
For v1 we need to cover user case (1) and have an importer.
discourse export some_category > my_export.tar
discourse import < my_export.tar