Formula to setup and configure libvirt.

See the full SaltStack Formulas installation and usage instructions.

If you are interested in writing or contributing to formulas, please pay attention to the Writing Formula Section.

If you want to use this formula, please pay attention to the FORMULA file and/or git tag, which contains the currently released version. This formula is versioned according to Semantic Versioning.

See Formula Versioning Section for more details.

More information SALT AS A CLOUD CONTROLLER.

Commit message formatting is significant!!

Please see How to contribute for more details.

Meta-state (This is a state that includes other states).

Install libvirt, qemu and extra packages; configure and start the libvirtd service, and creates the certificates for migration.

Meta-state (This is a state that includes other states).

Clean the extra and qemu packages, the server and the python package.

Meta-state (This is a state that includes other states).

Install libvirt packages; configure and start the libvirtd service, and creates the certificates for migration.

Meta-state (This is a state that includes other states).

Clean the service, the configuration files and the packages. Any generated certificates is not handled.

This state install the libvirt package only.

This state remove the libvirt package only and depends on libvirt.server.config.clean.

Configures libvirtd.conf and /etc/sysconfig, /etc/default, /etc/conf.d daemon files.

Delete libvirtd.conf and /etc/sysconfig, /etc/default, /etc/conf.d daemon files and depends on libvirt.server.service.clean.

Starts the libvirtd service

Disable and stop the libvirtd service.

Installs the libvirt certificates to allow virtual machine migration.

This state install the qemu package only.

This state remove the qemu package only.

This state install the extra packages only.

This state remove the extra packages only.

Installs the python bindings for libvirt

This state remove the python bindings package for libvirt only.

Linux testing is done with kitchen-salt.

• Ruby
• Docker

$ gem install bundler
$ bundle install
$ bin/kitchen test [platform]

Where [platform] is the platform name defined in kitchen.yml, e.g. debian-9-2019-2-py3.

Creates the docker instance and runs the libvirt main state, ready for testing.

Runs the inspec tests on the actual instance.

Removes the docker instance.

Runs all of the stages above in one go: i.e. destroy + converge + verify + destroy.

Gives you SSH access to the instance for manual testing.