{"id":19871897,"url":"https://github.com/saltstack-formulas/libvirt-formula","last_synced_at":"2025-03-01T00:50:16.592Z","repository":{"id":10474713,"uuid":"12650994","full_name":"saltstack-formulas/libvirt-formula","owner":"saltstack-formulas","description":null,"archived":false,"fork":false,"pushed_at":"2025-01-06T23:08:48.000Z","size":451,"stargazers_count":19,"open_issues_count":8,"forks_count":42,"subscribers_count":38,"default_branch":"master","last_synced_at":"2025-01-07T00:25:06.154Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/saltstack-formulas.png","metadata":{"files":{"readme":"docs/README.rst","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-09-06T18:09:31.000Z","updated_at":"2024-02-29T19:48:25.000Z","dependencies_parsed_at":"2025-01-07T04:18:44.534Z","dependency_job_id":null,"html_url":"https://github.com/saltstack-formulas/libvirt-formula","commit_stats":null,"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack-formulas%2Flibvirt-formula","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack-formulas%2Flibvirt-formula/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack-formulas%2Flibvirt-formula/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack-formulas%2Flibvirt-formula/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saltstack-formulas","download_url":"https://codeload.github.com/saltstack-formulas/libvirt-formula/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241296605,"owners_count":19940066,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T16:13:56.444Z","updated_at":"2025-03-01T00:50:16.566Z","avatar_url":"https://github.com/saltstack-formulas.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":".. _readme:\n\nlibvirt\n=======\n\n|img_travis| |img_sr|\n\n.. |img_travis| image:: https://travis-ci.com/saltstack-formulas/libvirt-formula.svg?branch=master\n   :alt: Travis CI Build Status\n   :scale: 100%\n   :target: https://travis-ci.com/saltstack-formulas/libvirt-formula\n.. |img_sr| image:: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg\n   :alt: Semantic Release\n   :scale: 100%\n   :target: https://github.com/semantic-release/semantic-release\n\nFormula to setup and configure ``libvirt``.\n\n.. contents:: **Table of Contents**\n   :depth: 1\n\nGeneral notes\n-------------\n\nSee the full `SaltStack Formulas installation and usage instructions\n\u003chttps://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html\u003e`_.\n\nIf you are interested in writing or contributing to formulas, please pay attention to the `Writing Formula Section\n\u003chttps://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html#writing-formulas\u003e`_.\n\nIf you want to use this formula, please pay attention to the ``FORMULA`` file and/or ``git tag``,\nwhich contains the currently released version. This formula is versioned according to `Semantic Versioning \u003chttp://semver.org/\u003e`_.\n\nSee `Formula Versioning Section \u003chttps://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html#versioning\u003e`_ for more details.\n\nMore information `SALT AS A CLOUD CONTROLLER\n\u003chttps://docs.saltstack.com/en/latest/topics/tutorials/cloud_controller.html\u003e`_.\n\nContributing to this repo\n-------------------------\n\n**Commit message formatting is significant!!**\n\nPlease see `How to contribute \u003chttps://github.com/saltstack-formulas/.github/blob/master/CONTRIBUTING.rst\u003e`_ for more details.\n\nAvailable states\n----------------\n\n.. contents::\n   :local:\n\n``libvirt``\n^^^^^^^^^^^\n\n*Meta-state (This is a state that includes other states)*.\n\nInstall libvirt, qemu and extra packages; configure and start the\nlibvirtd service, and creates the certificates for migration.\n\n``libvirt.clean``\n^^^^^^^^^^^^^^^^^\n\n*Meta-state (This is a state that includes other states)*.\n\nClean the extra and qemu packages, the server and the python package.\n\n``libvirt.server``\n^^^^^^^^^^^^^^^^^^\n\n*Meta-state (This is a state that includes other states)*.\n\nInstall libvirt packages; configure and start the libvirtd service,\nand creates the certificates for migration.\n\n``libvirt.server.clean``\n^^^^^^^^^^^^^^^^^^^^^^^^\n\n*Meta-state (This is a state that includes other states)*.\n\nClean the service, the configuration files and the packages. Any\ngenerated certificates is not handled.\n\n``libvirt.server.package``\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nThis state install the libvirt package only.\n\n``libvirt.server.package.clean``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nThis state remove the libvirt package only and depends on\n``libvirt.server.config.clean``.\n\n``libvirt.server.config``\n^^^^^^^^^^^^^^^^^^^^^^^^^\n\nConfigures libvirtd.conf and /etc/sysconfig, /etc/default, /etc/conf.d daemon\nfiles.\n\n``libvirt.server.config.clean``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nDelete libvirtd.conf and /etc/sysconfig, /etc/default, /etc/conf.d daemon\nfiles and depends on ``libvirt.server.service.clean``.\n\n``libvirt.server.service``\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nStarts the libvirtd service\n\n``libvirt.server.service.clean``\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nDisable and stop the libvirtd service.\n\n``libvirt.server.tls``\n^^^^^^^^^^^^^^^^^^^^^^\n\nInstalls the libvirt certificates to allow virtual machine migration.\n\n``libvirt.qemu``\n^^^^^^^^^^^^^^^^\n\nThis state install the qemu package only.\n\n``libvirt.qemu.clean``\n^^^^^^^^^^^^^^^^^^^^^^\n\nThis state remove the qemu package only.\n\n``libvirt.extra``\n^^^^^^^^^^^^^^^^^\n\nThis state install the extra packages only.\n\n``libvirt.extra.clean``\n^^^^^^^^^^^^^^^^^^^^^^^\n\nThis state remove the extra packages only.\n\n``libvirt.python``\n^^^^^^^^^^^^^^^^^^\n\nInstalls the python bindings for libvirt\n\n``libvirt.python.clean``\n^^^^^^^^^^^^^^^^^^^^^^^^\n\nThis state remove the python bindings package for libvirt only.\n\nTesting\n-------\n\nLinux testing is done with ``kitchen-salt``.\n\nRequirements\n^^^^^^^^^^^^\n\n* Ruby\n* Docker\n\n.. code-block:: bash\n\n   $ gem install bundler\n   $ bundle install\n   $ bin/kitchen test [platform]\n\nWhere ``[platform]`` is the platform name defined in ``kitchen.yml``,\ne.g. ``debian-9-2019-2-py3``.\n\n``bin/kitchen converge``\n^^^^^^^^^^^^^^^^^^^^^^^^\n\nCreates the docker instance and runs the ``libvirt`` main state, ready for testing.\n\n``bin/kitchen verify``\n^^^^^^^^^^^^^^^^^^^^^^\n\nRuns the ``inspec`` tests on the actual instance.\n\n``bin/kitchen destroy``\n^^^^^^^^^^^^^^^^^^^^^^^\n\nRemoves the docker instance.\n\n``bin/kitchen test``\n^^^^^^^^^^^^^^^^^^^^\n\nRuns all of the stages above in one go: i.e. ``destroy`` + ``converge`` + ``verify`` + ``destroy``.\n\n``bin/kitchen login``\n^^^^^^^^^^^^^^^^^^^^^\n\nGives you SSH access to the instance for manual testing.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaltstack-formulas%2Flibvirt-formula","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaltstack-formulas%2Flibvirt-formula","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaltstack-formulas%2Flibvirt-formula/lists"}