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

enhance docs

Browse Source
This commit is contained in:
Manuel Amador (Rudd-O) 2015-06-15 12:12:41 -07:00
parent f2068b17dc
commit 03b2ae2ddd
1 changed files with 15 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
README.md
View File

@ -5,12 +5,20 @@ This is an experimental plug-in mechanism that enables Ansible to connect
to Qubes VMs, either from another Qubes VM, or from a remote host via SSH
(assuming there exists a proxy Qubes VM with SSH listening on it).
You integrate it by (a) placing the `qubes.py` connection plugin in the Ansible
`connection_plugins` directory (b) placing the qrun and qrun-bridge
executables in one of two locations:
**Warning: this is a massive hack.** Please be *absolutely sure* you
have reviewed this code before using it. Contributions welcome.
1. Anywhere on your Ansible machine's `PATH`.
2. In a `../../bin` directory relative to the `qubes.py` file.
How to use this
---------------
You integrate it into your Ansible setup by:
1. placing the `qubes.py` connection plugin in your Ansible
`connection_plugins` directory, then
2. placing the `qrun` and `qrun-bridge` executables in one of two locations:
* Anywhere on your Ansible machine's `PATH`.
* In a `../../bin` directory relative to the `qubes.py` file.
After having done that, you can add Qubes VMs to your Ansible `hosts` file:
@ -19,7 +27,8 @@ workvm ansible_connection=qubes
vmonremotehost ansible_connection=qubes management_proxy=1.2.3.4
```
Please be *absolutely sure* you have reviewed this code before using it.
License
-------
This code is available to you under the terms of the GNU LGPL version 2
or later. The license terms are available on the FSF's Web site.