Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page describe the vm_manager tool: https://github.com/seapath/vm_manager

Deploying a virtual machine on a SEAPATH cluster requires to handle many elements: ceph, qemu, libvirt, corosync. vm_manager was created as a wrapper around these components.

Info
vm_manager is not useful for a standalone SEAPATH hypervisor. If you wish to deploy a VM for that use case, refer to the deploy_vms_standalone.yaml playbook.

The cluster_vm Ansible module is  wrapper above vm_manager cliOnce the cluster has been configured you are ready to deploy VMs on it. The cluster_vm Ansible module is present to manage virtual machines. A more detailed documentation can be generated from sources.

It can be called from a playbook to perform actions on VMs. For instance, an example of playbook that creates a VM from a predefined image disk and XML Libvirt configuration would be:

...

This section describes the VM architecture and the cluster_vm commands from a high-level point of view. Please read its documentation on Annex 1. cluster_vm module documentation documentation for further information. Note:

Info
Like other Ansible modules, the cluster_vm documentation can also be displayed by executing ansible-doc cluster_vm command from the Ansible root repository.

You will also find information on how to troubleshoot problems related to VM management on Annex 2. Troubleshooting VM managementpage Troubleshooting with vm_manager.

VM status

In the SEAPATH cluster the VMs can have several statuses:

...