Skip to content

os-migrate/os-migrate

Repository files navigation


OS Migrate
OS Migrate

OpenStack tenant migration tooling - an Ansible collection

OS Migrate is an open source toolbox for parallel cloud migration between OpenStack clouds. Parallel cloud migration is a way to modernize an OpenStack deployment. Instead of upgrading an OpenStack cluster in place, a second OpenStack cluster is deployed alongside, and tenant content is migrated from the original cluster to the new one. As hardware resources free up in the original cluster, they can be gradually added to the new cluster.

OS Migrate provides a framework for exporting and importing resources between two clouds. It's a collection of Ansible playbooks that provide the basic functionality, but may not fit each use case out of the box. You can craft custom playbooks using the OS Migrate collection pieces (roles and modules) as building blocks.

OS Migrate strictly uses the official OpenStack API and does not utilize direct database access or other methods to export or import data. The Ansible playbooks contained in OS Migrate are idempotent. If a command fails, you can retry with the same command.

Documentation

Refer to the official documentation website for usage docs.

Reporting issues

Please report any issues into the GitHub issue tracker.

Getting help

Feel free to create a GitHub issue with your question.

For a more interactive chat, join the Matrix room #os-migrate:matrix.org.

Contributing

See the OS Migrate developer documentation.