@gosquared/es-migrate
v1.1.4
Published
Tool to migrate documents from one cluster to another.
Downloads
6
Readme
Tool to help set up and run elasticsearch migrations.
Install
npm i -g @gosquared/es-migrate
Usage
Create a new migration project:
es-migrate init es-migrate-1
Change to project directory. See readme for further instructions.
cd es-migrate-1
cat README.md
Rationale
We were finally upgrading our 2.3 cluster to 7.x. Due to breaking changes, some mappings needed to be changed and documents reindexed. It is easier to migrate direct from 2.x to 7.x than stepping through 5.x and 6.x, although not 'easy' to do either!
Breaking changes that affected us:
- "_type" field deprecated / no longer supported.
The Elasticsearch Reindex API is useful but has limited transform options.
Since we work in Javascript we found it easiest to write our transforms in JS.
Why direct was preferable
If we were to upgrade via 5.x and 6.x, we would need to make our services compatible with each version. Also, each node in the cluster would need to be cycled, involving manual patching and restarting the node - a labour intensive process.
Ignore linting
git config blame.ignoreRevsFile .ignore-revs
https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current/installation.html#js-compatibility-matrix
https://opensearch.org/docs/clients/index/