gaschz/ansible-qubes
1
0
Fork 0
mirror of https://github.com/Rudd-O/ansible-qubes.git synced 2025-03-01 14:22:33 +01:00
Code Issues Packages Projects Releases Wiki Activity

improve intro

Browse Source
This commit is contained in:
Manuel Amador (Rudd-O) 2015-12-21 02:01:00 +00:00
parent 2d21027f20
commit d00d019949
1 changed files with 23 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
examples/ansible/README.md
View File

@ -2,18 +2,31 @@ Qubes OS DevOps automation toolkit: Ansible example
================================================== ==================================================
This is an example of Ansible automation that leverages this toolkit to This is an example of Ansible automation that leverages this toolkit to
let you manage Qubes VMs. These instructions assume that you have already: let you manage Qubes VMs. With it, you'll be managing dozens of VMs
(as well as any SSH-based remote host) in a fraction of the time it would
take to do so by hand or with shell scripts.
1. cloned this entire project into directory `/home/user/ansible-qubes` Hitting the ground running
2. installed Ansible (`yum install ansible`) in the TemplateVM of that AppVM --------------------------
3. opened a terminal window and changed to the directory containing this file
They also assume a bit of familiarity with Ansible as well. If you would like Get yourself ready to test this example:
to get an introduction on Ansible concepts, this examples directory is ripe
for a compare-and-contrast exercise with the
[Ansible introduction](https://docs.ansible.com/ansible/intro_getting_started.html).
Now, let's do a quick walkthrough of these files. 1. Create or designate an AppVM where you'll run this example. We'll assume
it will be called `manager` in this text.
2. Install the `git` and the `ansible` programs on the TemplateVM of that
designated `manager` VM.
3. Power off both the `manager` and its Template VM.
4. Start the `manager` VM.
5. Open a terminal window on it.
6. `git clone` or untar this project into `/home/user/ansible-qubes`.
You're ready to continue with this tutorial. If you would like to get an
introduction on Ansible concepts parallel to reading this document, a
compare-and-contrast exercise with the
[Ansible introduction](https://docs.ansible.com/ansible/intro_getting_started.html)
would probably work very well.
Now, let's dive into this example Ansible setup.
Ansible configuration Ansible configuration
--------------------- ---------------------
@ -99,7 +112,7 @@ If you're running a bit ahead of these instructions, you may have noticed
that running `ansible dom0 -m shell whoami` actually results in an error. that running `ansible dom0 -m shell whoami` actually results in an error.
This is by design from the Qubes team -- the `qubes.VMShell` service does This is by design from the Qubes team -- the `qubes.VMShell` service does
not ship in the `dom0` VM at all. If you'd lik to be able to manage `dom0` not ship in the `dom0` VM at all. If you'd like to be able to manage `dom0`
from your configuration management system, all you need to do is deploy from your configuration management system, all you need to do is deploy
the necessary configuration to `dom0`. the necessary configuration to `dom0`.