libvirt
1. General notes
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.
2. Contributing to this repo
Commit message formatting is significant!!
Please see How to contribute for more details.
3. Available states
3.1. libvirt
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.
3.2. libvirt.clean
Meta-state (This is a state that includes other states).
Clean the extra and qemu packages, the server and the python package.
3.3. libvirt.server
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.
3.4. libvirt.server.clean
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.
3.6. libvirt.server.package.clean
This state remove the libvirt package only and depends on
libvirt.server.config.clean
.
3.7. libvirt.server.config
Configures libvirtd.conf and /etc/sysconfig, /etc/default, /etc/conf.d daemon files.
4. Testing
Linux testing is done with kitchen-salt
.
4.1. Requirements
-
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
.
4.2. bin/kitchen converge
Creates the docker instance and runs the libvirt
main state, ready for
testing.