Installation from Galaxy (recommended)

This document describes the recommended method of installing OS Migrate, from Ansible Galaxy. Alternatively, you can install from source.

Prerequisites

Ansible 2.9 or newer.
Ansible must run using Python 3. (When using Ansible from RHEL packages, this means running on RHEL 8 or newer.)
Additional package requirements from Ansible modules: iputils python3-openstackclient python3-openstacksdk

Using virtualenv for prerequisites

If your distribution doesn’t ship the required dependency versions, you can use virtualenv, e.g.:

python3 -m venv $HOME/os_migrate_venv
source $HOME/os_migrate_venv/bin/activate
python3 -m pip install --upgrade 'openstacksdk'
python3 -m pip install --upgrade 'ansible-core'

Installation of OS Migrate collection

To install latest release:

ansible-galaxy collection install os_migrate.os_migrate

To install a particular release:

ansible-galaxy collection install os_migrate.os_migrate:<VERSION>

You can find available releases at OS Migrate Galaxy page.