Skip to main content

libvirt Molecule Plugin :: run molecule tests on libvirt

Project description

PyPI Package https://zuul-ci.org/gated.svg Python Black Code Style Ansible Code of Conduct Ansible mailing lists Repository License

Molecule libvirt is designed to allow use of libvirt for provisioning test resources.

Please note that this driver is currently in its early stage of development, do not even try to install or use it until this message is removed.

Quickstart

Installation

pip install molecule-libvirt

Create a scenario

With a new role

molecule init role -d libvirt my-role

This will create a new folder my-role containing a bare-bone generated role like you would do with ansible-galaxy init command.

It will also contain a molecule folder with a default scenario using the libvirt driver (using ansible community.libvirt collection).

Install the collection using:

ansible-galaxy install -r test_requirements.yml.

Example

This is a molecule.yml example file

dependency:
name: galaxy
driver:
  name: libvirt
platforms:
  - name: instance-1
    cpu: 1
    cpu_model: "qemu64"
    image_url: "https://download.fedoraproject.org/pub/fedora/linux/releases/34/Cloud/x86_64/images/Fedora-Cloud-Base-34-1.2.x86_64.qcow2"
    disk_size: "10G"
    ssh_port: 22
    memory_size: "1" # in GB
  - name: instance-2
    memory: "1"
    cpus: 1
    image_url: "https://download.fedoraproject.org/pub/fedora/linux/releases/34/Cloud/x86_64/images/Fedora-Cloud-Base-34-1.2.x86_64.qcow2"
    libvirt_host: "server.home.lan"
    libvirt_user: "james"
    bridge_name: "bridge0"
  - name: instance-3
    memory: "1"
    cpus: 1
    image_url: "https://download.fedoraproject.org/pub/fedora/linux/releases/34/Cloud/x86_64/images/Fedora-Cloud-Base-34-1.2.x86_64.qcow2"
    libvirt_host: "server.home.lan"
    libvirt_user: "james"
    bridge_name: "bridge0"
provisioner:
  name: ansible
verifier:
  name: ansible

Optional parameters

molecule_bridge: existing bridge on local host. Can be useful if you want to set network interface name created for molecule. default value is: molecule-br0.

molecule_network_cidr: ip address range that should be bind to molecule virtual network. default value is: 10.10.10.0/24.

qemu_user: qemu process user. On RHEL like system qemu user is qemu. On Debian like, qemu user is libvirt-qemu. default value is: qemu.

cpu_model: specifies CPU model requested by the guest virtual machine. default is : qemu64.

arch: specifying the CPU architecture to virtualization. default is x86_64.

timezone: vm’s timezone. default is America/Toronto.

bridge_name: existing bridge on remote host. This bridge should allow VM being reachable with an ip address.

libvirt_host and libvirt_user: remote host parameters. libvirt_user should belongs to libvirt group.

Once set, you will have to run:

molecule test

Documentation

Read the documentation and more at https://molecule.readthedocs.io/.

Get Involved

Authors

  • James Regis

  • Gaëtan Trellu

  • Gariele Cerami

  • Sorin Sbarnea

License

The MIT License.

The logo is licensed under the Creative Commons NoDerivatives 4.0 License.

If you have some other use in mind, contact us.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

molecule-libvirt-0.0.6.tar.gz (24.0 kB view details)

Uploaded Source

Built Distribution

molecule_libvirt-0.0.6-py3-none-any.whl (22.6 kB view details)

Uploaded Python 3

File details

Details for the file molecule-libvirt-0.0.6.tar.gz.

File metadata

  • Download URL: molecule-libvirt-0.0.6.tar.gz
  • Upload date:
  • Size: 24.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for molecule-libvirt-0.0.6.tar.gz
Algorithm Hash digest
SHA256 0a4847a758ebe511c51179d847c54e98b4bd2e66984368e404b0590d7e981141
MD5 bde75f1770610ff5c29b75a3473b53e1
BLAKE2b-256 6c4b250a3157a71f64ab41aae61b136064a644541a6bdfcee8e4e7ead27e73dd

See more details on using hashes here.

Provenance

File details

Details for the file molecule_libvirt-0.0.6-py3-none-any.whl.

File metadata

File hashes

Hashes for molecule_libvirt-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 aa4713056d1b5ca68d59070ef24c04c8eff2599e3d155fd1f8bb46b48ffe3159
MD5 3a17e341ad0bacf5c7502430b44760e4
BLAKE2b-256 aa3e0661b0fcb7b57d0ec52022eb574b92b93f33fffb36d196e89bf04f16ae3d

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page