aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorErik Skultety <eskultet@redhat.com>2022-07-14 13:34:46 +0200
committerErik Skultety <eskultet@redhat.com>2022-07-14 15:14:19 +0200
commit7a99efd0d6e8aaf927b82e2e3926e9693b1cb09a (patch)
tree241e16315f1e306708b0a9908f02cbddb07d6713 /docs
parent5d21175965f20ecda0dac8bafe08831f6da296ea (diff)
downloadlibvirt-ci-7a99efd0d6e8aaf927b82e2e3926e9693b1cb09a.zip
libvirt-ci-7a99efd0d6e8aaf927b82e2e3926e9693b1cb09a.tar.gz
libvirt-ci-7a99efd0d6e8aaf927b82e2e3926e9693b1cb09a.tar.bz2
docs: vms: Move the Ansible inventory section to Configuration
Setting up an inventory for Ansible is still a configuration step. Signed-off-by: Erik Skultety <eskultet@redhat.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/vms.rst55
1 files changed, 27 insertions, 28 deletions
diff --git a/docs/vms.rst b/docs/vms.rst
index 2454b49..52cca45 100644
--- a/docs/vms.rst
+++ b/docs/vms.rst
@@ -27,34 +27,8 @@ such as this one
in your crontab.
-
-Installing local VMs
-====================
-
-In order to install a local VM with lcitool, run the following:
-
-::
-
- lcitool install $host --target $target_os
-
-where ``$host`` is the name for the VM and ``$target_os`` is one of the
-supported target OS plaforms (see `Usage and examples`_ below).
-Another option of installing guests with lcitool is by adding a managed host
-entry in the Ansible inventory in which case lcitool's invocation would look
-like this:
-
-::
-
- lcitool install $host
-
-Refer to the `Ansible inventory`_ and `Managed hosts`_ sections below on how to
-use an inventory with lcitool. Note that not all guests can be installed using
-the ways described above, e.g. FreeBSD or Alpine guests.
-See the `FreeBSD`_ section below to know how to add such a host in that case.
-
-
Ansible inventory
-=================
+-----------------
In addition to creating a configuration file as described in `Configuration`_,
you may also need to provide an Ansible inventory depending on whether
@@ -75,7 +49,7 @@ Ansible will complain by issuing a warning about this which may in turn result
in an unexpected Ansible behaviour.
Managed hosts
--------------
+~~~~~~~~~~~~~
Since hosts may come from a public cloud environment, we don't execute all the
Ansible tasks which set up the VM environment by default because some of the
@@ -101,6 +75,31 @@ An example of a simple INI inventory:
192.168.1.30
+Installing local VMs
+====================
+
+In order to install a local VM with lcitool, run the following:
+
+::
+
+ lcitool install $host --target $target_os
+
+where ``$host`` is the name for the VM and ``$target_os`` is one of the
+supported target OS plaforms (see `Usage and examples`_ below).
+Another option of installing guests with lcitool is by adding a managed host
+entry in the Ansible inventory in which case lcitool's invocation would look
+like this:
+
+::
+
+ lcitool install $host
+
+Refer to the `Ansible inventory`_ and `Managed hosts`_ sections respectively on
+how to use an inventory with lcitool. Note that not all guests can be installed
+using the ways described above, e.g. FreeBSD or Alpine guests. See
+`Installing FreeBSD VMs`_ to know how to add such a host in that case.
+
+
Usage and examples
==================