NuKVM/vagrant-libvirt
3
0
Fork 0
mirror of https://github.com/vagrant-libvirt/vagrant-libvirt.git synced 2025-02-25 18:55:27 -06:00
Code Issues Packages Projects Releases Wiki Activity
Files
bfb8b378f7631ea47b957a870fa93831c16edabf
vagrant-libvirt/version/0.11.1/about/index.html

2 lines
11 KiB
HTML
Raw Blame History

<!DOCTYPE html> <html lang="en-US"> <head> <meta charset="UTF-8"> <meta http-equiv="X-UA-Compatible" content="IE=Edge"> <title>About - Vagrant Libvirt Documentation</title> <link rel="shortcut icon" href="/vagrant-libvirt/version/0.11.1/favicon.ico" type="image/x-icon"> <link rel="stylesheet" href="/vagrant-libvirt/version/0.11.1/assets/css/just-the-docs-default.css"> <script type="text/javascript" src="/vagrant-libvirt/version/0.11.1/assets/js/vendor/lunr.min.js"></script> <script type="text/javascript" src="/vagrant-libvirt/version/0.11.1/assets/js/just-the-docs.js"></script> <meta name="viewport" content="width=device-width, initial-scale=1"> <!-- Begin Jekyll SEO tag v2.8.0 --> <title>About | Vagrant Libvirt Documentation</title> <meta name="generator" content="Jekyll v3.9.2" /> <meta property="og:title" content="About" /> <meta property="og:locale" content="en_US" /> <meta name="description" content="Create and manage Vagrant machines using Libvirt/QEMU" /> <meta property="og:description" content="Create and manage Vagrant machines using Libvirt/QEMU" /> <link rel="canonical" href="https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/about/" /> <meta property="og:url" content="https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/about/" /> <meta property="og:site_name" content="Vagrant Libvirt Documentation" /> <meta property="og:type" content="website" /> <meta name="twitter:card" content="summary" /> <meta property="twitter:title" content="About" /> <script type="application/ld+json"> {"@context":"https://schema.org","@type":"WebSite","description":"Create and manage Vagrant machines using Libvirt/QEMU","headline":"About","name":"Vagrant Libvirt Documentation","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/assets/images/logo.png"}},"url":"https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/about/"}</script> <!-- End Jekyll SEO tag --> <link rel="stylesheet" href="/vagrant-libvirt/version/0.11.1/assets/css/just-the-docs-light.css" media="(prefers-color-scheme: light)"> <link rel="stylesheet" href="/vagrant-libvirt/version/0.11.1/assets/css/just-the-docs-dark.css" media="(prefers-color-scheme: dark)"> </head> <body> <svg xmlns="http://www.w3.org/2000/svg" style="display: none;"> <symbol id="svg-link" viewBox="0 0 24 24"> <title>Link</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link"> <path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path> </svg> </symbol> <symbol id="svg-search" viewBox="0 0 24 24"> <title>Search</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-search"> <circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> </symbol> <symbol id="svg-menu" viewBox="0 0 24 24"> <title>Menu</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-menu"> <line x1="3" y1="12" x2="21" y2="12"></line><line x1="3" y1="6" x2="21" y2="6"></line><line x1="3" y1="18" x2="21" y2="18"></line> </svg> </symbol> <symbol id="svg-arrow-right" viewBox="0 0 24 24"> <title>Expand</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-chevron-right"> <polyline points="9 18 15 12 9 6"></polyline> </svg> </symbol> <symbol id="svg-doc" viewBox="0 0 24 24"> <title>Document</title> <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-file"> <path d="M13 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V9z"></path><polyline points="13 2 13 9 20 9"></polyline> </svg> </symbol> </svg> <div class="side-bar"> <div class="site-header"> <a href="https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/" class="site-title lh-tight"> <div class="site-logo"></div> Vagrant Libvirt Documentation </a> <a href="#" id="menu-button" class="site-button"> <svg viewBox="0 0 24 24" class="icon"><use xlink:href="#svg-menu"></use></svg> </a> </div> <nav role="navigation" aria-label="Main" id="site-nav" class="site-nav"> <ul class="nav-list"><li class="nav-list-item"><a href="https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/" class="nav-list-link">Quickstart</a> </li><li class="nav-list-item"><a href="https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/installation.html" class="nav-list-link">Installation</a> </li><li class="nav-list-item"><a href="https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/configuration.html" class="nav-list-link">Configuration</a> </li><li class="nav-list-item"><a href="https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/boxes.html" class="nav-list-link">Boxes</a> </li><li class="nav-list-item"><a href="https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/examples.html" class="nav-list-link">Examples</a> </li><li class="nav-list-item"><a href="https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/packaging.html" class="nav-list-link">Packaging</a> </li><li class="nav-list-item"><a href="https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/troubleshooting.html" class="nav-list-link">Troubleshooting</a> </li><li class="nav-list-item active"><a href="https://vagrant-libvirt.github.io/vagrant-libvirt/version/0.11.1/about/" class="nav-list-link active">About</a> </li></ul> </nav> <footer class="site-footer"> This site uses <a href="https://github.com/pmarsceill/just-the-docs">Just the Docs</a>, a documentation theme for Jekyll. </footer> </div> <div class="main" id="top"> <div id="main-header" class="main-header"> <div class="search"> <div class="search-input-wrap"> <input type="text" id="search-input" class="search-input" tabindex="0" placeholder="Search Vagrant Libvirt Documentation" aria-label="Search Vagrant Libvirt Documentation" autocomplete="off"> <label for="search-input" class="search-label"><svg viewBox="0 0 24 24" class="search-icon"><use xlink:href="#svg-search"></use></svg></label> </div> <div id="search-results" class="search-results"></div> </div> <script src="/vagrant-libvirt/version/0.11.1/assets/js/site_constants-e1ac483f8cbbb2d44940348129b4f096317606c1e27aa57fe14734259e395fe6.js"></script> <div id="plugin-version-menu" class="site-footer"></div> <script src="/vagrant-libvirt/assets/js/plugin_versions_menu.js"></script> </div> <div id="main-content-wrap" class="main-content-wrap"> <div id="main-content" class="main-content" role="main"> <p>Vagrant-libvirt is a <a href="http://www.vagrantup.com">Vagrant</a> plugin that adds a <a href="http://libvirt.org">Libvirt</a> provider to Vagrant, allowing Vagrant to control and provision machines via Libvirt toolkit.</p> <p class="info">Actual version is still a development one. Feedback is welcome and can help a lot :-)</p> <p>You can find the source code for Vagrant Libvirt plugin at GitHub: <a href="https://github.com/vagrant-libvirt/vagrant-libvirt">https://github.com/vagrant-libvirt/vagrant-libvirt</a></p> <p>You can find the source code for Vagrant Libvirt QA testing of install instructions at GitHub: <a href="https://github.com/vagrant-libvirt/vagrant-libvirt-qa">https://github.com/vagrant-libvirt/vagrant-libvirt-qa</a></p> <p>Creating issues can be done via GitHub: <a href="https://github.com/vagrant-libvirt/vagrant-libvirt/issues">https://github.com/vagrant-libvirt/vagrant-libvirt/issues</a></p> <p>To ask questions or discuss a problem ahead of logging an issue you can use:</p> <ul> <li>Gitter <a href="https://gitter.im/vagrant-libvirt/vagrant-libvirt">https://gitter.im/vagrant-libvirt/vagrant-libvirt</a></li> <li>Github Discussions <a href="https://github.com/vagrant-libvirt/vagrant-libvirt/discussions">https://github.com/vagrant-libvirt/vagrant-libvirt/discussions</a></li> </ul> <h2 id="features"> <a href="#features" class="anchor-heading" aria-labelledby="features"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> Features </h2> <ul> <li>Control local Libvirt hypervisors.</li> <li>Vagrant <code class="language-plaintext highlighter-rouge">up</code>, <code class="language-plaintext highlighter-rouge">destroy</code>, <code class="language-plaintext highlighter-rouge">suspend</code>, <code class="language-plaintext highlighter-rouge">resume</code>, <code class="language-plaintext highlighter-rouge">halt</code>, <code class="language-plaintext highlighter-rouge">ssh</code>, <code class="language-plaintext highlighter-rouge">reload</code>, <code class="language-plaintext highlighter-rouge">package</code> and <code class="language-plaintext highlighter-rouge">provision</code> commands.</li> <li>Upload box image (qcow2 format) to Libvirt storage pool.</li> <li>Create volume as COW diff image for domains.</li> <li>Create private networks.</li> <li>Create and boot Libvirt domains.</li> <li>SSH into domains.</li> <li>Setup hostname and network interfaces.</li> <li>Provision domains with any built-in Vagrant provisioner.</li> <li>Synced folder support via <code class="language-plaintext highlighter-rouge">rsync</code>, <code class="language-plaintext highlighter-rouge">nfs</code>, <code class="language-plaintext highlighter-rouge">9p</code> or <code class="language-plaintext highlighter-rouge">virtiofs</code>.</li> <li>Snapshots</li> <li>Package caching via <a href="http://fgrehm.viewdocs.io/vagrant-cachier/">vagrant-cachier</a>.</li> <li>Use boxes from other Vagrant providers via <a href="https://github.com/sciurus/vagrant-mutate">vagrant-mutate</a>.</li> <li>Support VMs with no box for PXE boot purposes (Vagrant 1.6 and up)</li> </ul> <h2 id="how-a-machine-is-created"> <a href="#how-a-machine-is-created" class="anchor-heading" aria-labelledby="how-a-machine-is-created"><svg viewBox="0 0 16 16" aria-hidden="true"><use xlink:href="#svg-link"></use></svg></a> How a Machine Is Created </h2> <p>Vagrant goes through steps below when creating new project:</p> <ol> <li>Connect to Libvirt locally or remotely via SSH.</li> <li>Check if box image is available in Libvirt storage pool. If not, upload it to remote Libvirt storage pool as new volume.</li> <li>Create COW diff image of base box image for new Libvirt domain.</li> <li>Create and start new domain on Libvirt host.</li> <li>Check for DHCP lease from dnsmasq server.</li> <li>Wait till SSH is available.</li> <li>Sync folders and run Vagrant provisioner on new domain if setup in Vagrantfile.</li> </ol> <hr> <footer> <div class="d-flex mt-2"> <p class="text-small text-grey-dk-000 mb-0"> <a href="https://github.com/vagrant-libvirt/vagrant-libvirt/tree/main/about.markdown" id="edit-this-page">Edit this page on GitHub</a> </p> </div> </footer> </div> </div> <div class="search-overlay"></div> </div> </body> </html>
Reference in New Issue View Git Blame Copy Permalink