https://github.com/redhat-cop/openshift_virtualization_migration
Validated Ansible Collection for migrating and maintaining VM's on OpenShift Virtualization
https://github.com/redhat-cop/openshift_virtualization_migration
validated-content
Last synced: about 1 month ago
JSON representation
Validated Ansible Collection for migrating and maintaining VM's on OpenShift Virtualization
- Host: GitHub
- URL: https://github.com/redhat-cop/openshift_virtualization_migration
- Owner: redhat-cop
- License: gpl-3.0
- Created: 2025-12-04T09:51:46.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-05-01T02:45:49.000Z (about 2 months ago)
- Last Synced: 2026-05-01T04:10:49.339Z (about 2 months ago)
- Topics: validated-content
- Language: YAML
- Homepage:
- Size: 385 KB
- Stars: 6
- Watchers: 0
- Forks: 4
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Ansible for OpenShift Virtualization Migration
[](https://github.com/redhat-cop/openshift_virtualization_migration/actions)
[](https://semver.org/)
[](LICENSE)
## Table of Contents
* [Description](#description)
* [Requirements](#requirements)
* [Installation](#installation)
* [Documentation](#documentation)
* [Contributing](CONTRIBUTING.md)
* [Disconnected Environment](docs/disconnected_environment_guide.md)
* [Secure Credential Management](docs/secure_credential_management.md)
* [Secure Credential Practices](docs/secure_credential_practices.md)
* [Roles](#roles)
* [aap_deploy](roles/aap_deploy/README.md)
* [aap_machine_credentials](roles/aap_machine_credentials/README.md)
* [aap_seed](roles/aap_seed/README.md)
* [bootstrap](roles/bootstrap/README.md)
* [create_mf_aap_token](roles/create_mf_aap_token/README.md)
* [mtv_management](roles/mtv_management/README.md)
* [mtv_migrate](roles/mtv_migrate/README.md)
* [network_mgmt](roles/network_mgmt/README.md)
* [operator_management](roles/operator_management/README.md)
* [validate_migration](roles/validate_migration/README.md)
* [vm_backup_restore](roles/vm_backup_restore/README.md)
* [vm_collect](roles/vm_collect/README.md)
* [vm_hot_plug](roles/vm_hot_plug/README.md)
* [vm_lifecycle](roles/vm_lifecycle/README.md)
* [vm_mac_address](roles/vm_mac_address/README.md)
* [vm_networking](roles/vm_networking/README.md)
* [vm_patching](roles/vm_patching/README.md)
* [vm_ssh](roles/vm_ssh/README.md)
* [Use Cases](#use-cases)
* [Testing](#testing)
* [Release Notes](CHANGELOG.md)
* [License](#license)
## Description
This collection enables the migration journey of Virtual Machine (VM) workloads from existing hypervisors to Red Hat OpenShift Virtualization using Ansible Automation Platform. Additionally it provides content for the management and maintenance of VM workloads within Red Hat OpenShift Virtualization.
## Requirements
The following Ansible Collections are required:
```yaml
---
collections:
- name: redhat.openshift_virtualization
- name: redhat.openshift
- name: vmware.vmware_rest
- name: ansible.posix
- name: infra.aap_utilities
- name: kubernetes.core
- name: community.crypto
- name: community.general
- name: community.vmware
# AAP <=2.4
- name: infra.controller_configuration
- name: ansible.controller
version: "<=4.5.12"
# AAP 2.5+
- name: ansible.platform
- name: ansible.controller
- name: infra.aap_configuration
...
```
## Installation
You can install the `infra.openshift_virtualization_migration` collection with the Ansible Galaxy CLI:
```shell
ansible-galaxy collection install infra.openshift_virtualization_migration
```
Note that if you install any collections from Ansible Galaxy, they will not be upgraded automatically when you upgrade the Ansible package.
To upgrade the collection to the latest available version, run the following command:
```
ansible-galaxy collection install infra.openshift_virtualization_migration --upgrade
```
You can also include it in a `requirements.yml` file and install it with `ansible-galaxy collection install -r requirements.yml`, using the format:
```yaml
---
collections:
- name: infra.openshift_virtualization_migration
# If you need a specific version of the collection, you can specify like this:
# version: ...
```
See [using Ansible collections](https://docs.ansible.com/ansible/devel/user_guide/collections_using.html) for more details.
## Use Cases
This collection is ideal for accomplishing the following using Ansible automation:
* Analyzing existing Virtual Machine hypervisor environments.
* Installing and configuring Ansible Automation Platform.
* Preparing OpenShift environments to support Virtual Machines and migrating Virtual Machines from existing hypervisors using the Migration Toolkit for Virtualization (MTV).
* Migrating Virtual Machines using the Migration Toolkit for Virtualization (MTV).
## Testing
[tox](https://tox.wiki) is used to perform tests and verification of this collection.
The following commands can be used to execute the various types of tests implemented:
```shell
tox -av # lists all tests
tox # run them all
tox -e # run specific one
tox -f sanity --ansible -c tox-ansible.ini # run tox-ansible that does our ansible-test sanity suite
```
## Support
The [Ansible Forum](https://forum.ansible.com/tag/openshift_migrate) can be used for additional questions and issues related to this collection.
## License
GNU General Public License v3.0 or later.
See the [LICENSE](https://www.gnu.org/licenses/gpl-3.0.en.html) to see the full text.