base on Vagrant provider for libvirt. # Vagrant Libvirt Provider  [](https://gitter.im/vagrant-libvirt/vagrant-libvirt?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://github.com/vagrant-libvirt/vagrant-libvirt/actions/workflows/unit-tests.yml) [](https://coveralls.io/github/vagrant-libvirt/vagrant-libvirt?branch=main) [](https://badge.fury.io/rb/vagrant-libvirt) This is a [Vagrant](http://www.vagrantup.com) plugin that adds a [Libvirt](http://libvirt.org) provider to Vagrant, allowing Vagrant to control and provision machines via Libvirt toolkit. **Note:** Actual version is still a development one. Feedback is welcome and can help a lot :-) Vagrant-libvirt Documentation is published at [https://vagrant-libvirt.github.io/vagrant-libvirt/](https://vagrant-libvirt.github.io/vagrant-libvirt/) ## QA status We periodically test basic functionality for vagrant-libvirt on various distributions. In the status badges below, build passing means that latest version of Vagrant + Vagrant-libvirt was installed correctly and `vagrant up` is working. Click the badge to review the action workflow. [](https://github.com/vagrant-libvirt/vagrant-libvirt-qa/actions/workflows/distro-install.yml) ## Index <!-- vim-markdown-toc GFM --> * [Installing](#installing) * [Latest development version](#latest-development-version) * [Running](#running) * [Development](#development) * [Contributing](#contributing) <!-- vim-markdown-toc --> ## Installing Installation typically involves a number of distribution package dependencies to ensure that Libvirt is available. Recommend that you follow the [installation guide](https://vagrant-libvirt.github.io/vagrant-libvirt/installation.html). ### Latest development version If you want to try out the very latest development version you can download the gem package from the GitHub rubygems package [repository](https://github.com/vagrant-libvirt/vagrant-libvirt/packages/1659776) under the asserts. Unfortunately it's not yet possible to make the rubygem repositories in GitHub public. To install provide the file directly to the install command: ``` vagrant plugin install ./vagrant-libvirt-<version>.gem ``` It is possible to install directly from the GitHub rubygems package repository, however this will embedded your GitHub token directly into the file `~/.vagrant.d/plugins.json`: ``` vagrant plugin install vagrant-libvirt \ --plugin-source https://${USERNAME}:${GITHUB_TOKEN}@rubygems.pkg.github.com/vagrant-libvirt \ --plugin-version "0.10.9.pre.62" ``` Provided this token is a classic token limited to `read:packages` only, this may be acceptable to you. ## Running Once installed, use vagrant-libvirt through vagrant. Locate a vagrant box containing the distribution you want to use at [Vagrant Cloud](https://app.vagrantup.com/boxes/search?provider=libvirt) and initialize. ```shell vagrant init fedora/32-cloud-base ``` Then run following command: ```shell vagrant up --provider=libvirt ``` Vagrant needs to know that we want to use Libvirt and not default VirtualBox. That's why there is `--provider=libvirt` option specified. Other way to tell Vagrant to use Libvirt provider is to setup environment variable ```shell export VAGRANT_DEFAULT_PROVIDER=libvirt ``` Afterwards to enter the VM simply use: ```shell vagrant ssh ``` If you can't find a box that works as you need, have a look at our documentation on [creating boxes](https://vagrant-libvirt.github.io/vagrant-libvirt/boxes.html#creating-boxes) on how to take existing ones, customize them and repackage. ## Development To work on the `vagrant-libvirt` plugin, clone this repository out, and use [Bundler](http://gembundler.com) to get the dependencies: ```shell git clone https://github.com/vagrant-libvirt/vagrant-libvirt.git cd vagrant-libvirt bundle config --local with development bundle config --local path 'vendor/bundle' bundle install ``` Once you have the dependencies, verify the unit tests pass with `rspec`: ```shell bundle exec rspec --fail-fast --color --format documentation ``` If those pass, you're ready to start developing the plugin. Additionally if you wish to test against a specific version of vagrant you can control the version using the following before running the tests: ```shell export VAGRANT_VERSION=v2.2.14 bundle update && bundle exec rspec --fail-fast --color --format documentation ``` To run the acceptance tests which involve bringing up VMs and exercising various functionality aspects run the following (warning, may have issues if distro ruby is newer than supported by vagrant): ```shell bundle exec rspec --fail-fast --color --format documentation --tag acceptance ``` **Note** rvm is used by the maintainers to help provide an environment to test against multiple ruby versions that align with the ones used by vagrant for their embedded ruby depending on the release. You can see what version is used by looking at the current [unit tests](.github/workflows/unit-tests.yml) workflow. By default if you have rvm installed and enabled it this project looks to use ruby 3.1.2 and configures a separate gemset, both of which will be switched to each time you enter the project directory. It should be considered sufficient just to get any tests passing with your system ruby, and as long as you ensure that the option to allow maintainers can update your PR, we will fix up any issues with the remaining combinations. You can test the plugin without installing it into your Vagrant environment by just creating a `Vagrantfile` in the top level of this directory (it is gitignored) that uses it. You can add the following line to your Vagrantfile while in development to ensure vagrant checks that the plugin is installed: ```ruby Vagrant.configure("2") do |config| config.vagrant.plugins = "vagrant-libvirt" end ``` Or add the following to the top of the file to ensure that any required plugins are installed globally: ```ruby REQUIRED_PLUGINS = %w(vagrant-libvirt) exit unless REQUIRED_PLUGINS.all? do |plugin| Vagrant.has_plugin?(plugin) || ( puts "The #{plugin} plugin is required. Please install it with:" puts "$ vagrant plugin install #{plugin}" false ) end ``` Now you can use bundler to execute Vagrant: ```shell bundle exec vagrant up --provider=libvirt ``` **IMPORTANT NOTE:** bundle is crucial. You need to use bundled Vagrant. ## Contributing [](https://github.com/vagrant-libvirt/vagrant-libvirt/issues) 1. Fork it 2. Create your feature branch (`git checkout -b my-new-feature`) 3. Commit your changes (`git commit -am 'Add some feature'`) 4. Push to the branch (`git push origin my-new-feature`) 5. Create new Pull Request For future work take a look at [open issues](https://github.com/vagrant-libvirt/vagrant-libvirt/issues?state=open). <!-- # styling for TOC vim: expandtab shiftwidth=2 --> ", Assign "at most 3 tags" to the expected json: {"id":"12161","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"