mirror of
				https://github.com/Rudd-O/ansible-qubes.git
				synced 2025-11-04 13:38:55 +01:00 
			
		
		
		
	Fixed typos.
This commit is contained in:
		
							parent
							
								
									3747abc0f9
								
							
						
					
					
						commit
						4ad208c863
					
				
							
								
								
									
										12
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										12
									
								
								README.md
									
									
									
									
									
								
							@ -19,7 +19,7 @@ The software in this kit includes the following:
 | 
				
			|||||||
3. A [set of commands for SaltStack `salt-ssh`](./bin/) that fake SSH
 | 
					3. A [set of commands for SaltStack `salt-ssh`](./bin/) that fake SSH
 | 
				
			||||||
   and SCP using `bombshell-client` to enable SaltStack management
 | 
					   and SCP using `bombshell-client` to enable SaltStack management
 | 
				
			||||||
   of Qubes OS VMs.
 | 
					   of Qubes OS VMs.
 | 
				
			||||||
4. A set of [action plugions for Ansible](./ansible/action_plugins/) that
 | 
					4. A set of [action plugins for Ansible](./ansible/action_plugins/) that
 | 
				
			||||||
   interface with the new
 | 
					   interface with the new
 | 
				
			||||||
   [Qubes OS 3.1 Salt management stack](https://www.qubes-os.org/news/2015/12/14/mgmt-stack/).
 | 
					   [Qubes OS 3.1 Salt management stack](https://www.qubes-os.org/news/2015/12/14/mgmt-stack/).
 | 
				
			||||||
5. A [set of DevOps automation skeletons / examples](./examples/) to get you up and
 | 
					5. A [set of DevOps automation skeletons / examples](./examples/) to get you up and
 | 
				
			||||||
@ -29,12 +29,12 @@ The software in this kit includes the following:
 | 
				
			|||||||
depend on it, can be used to run operations from one VM to another,
 | 
					depend on it, can be used to run operations from one VM to another,
 | 
				
			||||||
in the following combinations:
 | 
					in the following combinations:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* Qubes VM  -> Qubes VM
 | 
					* Qubes VM -> Qubes VM
 | 
				
			||||||
* Qubes VM -> Qubes `dom0` (see below for enablement instructions)
 | 
					* Qubes VM -> Qubes `dom0` (see below for enablement instructions)
 | 
				
			||||||
* Qubes `dom0` -> Qubes VM
 | 
					* Qubes `dom0` -> Qubes VM
 | 
				
			||||||
* Qubes VM -> network (SSH) -> Qubes VM in another machine (see below for
 | 
					* Qubes VM -> network (SSH) -> Qubes VM on another Qubes host (see below for
 | 
				
			||||||
   enablement instructions)
 | 
					   enablement instructions)
 | 
				
			||||||
* normal desktop Linux -> network (SSH) -> Qubes VM in another machine
 | 
					* normal desktop Linux -> network (SSH) -> Qubes VM on another Qubes host
 | 
				
			||||||
 | 
					
 | 
				
			||||||
What this means for you is quite simple.  With this toolkit, you can completely
 | 
					What this means for you is quite simple.  With this toolkit, you can completely
 | 
				
			||||||
script the setup and maintenance of an entire network of Qubes OS machines.
 | 
					script the setup and maintenance of an entire network of Qubes OS machines.
 | 
				
			||||||
@ -52,7 +52,7 @@ Contributions always welcome.
 | 
				
			|||||||
Bombshell remote shell technology
 | 
					Bombshell remote shell technology
 | 
				
			||||||
---------------------------------
 | 
					---------------------------------
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Bombshell is a way to run commands in other VMs, that employs the `bombshell-client` script on this repository.  Said method is now integrated in these programs and will only work with Qubes OS 3.
 | 
					Bombshell is a way to run commands in other VMs, that employs the `bombshell-client` script from this repository.  Said method is now integrated in these programs and will only work with Qubes OS 3.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Direct (non-Ansible and non-SaltStack) usage instructions:
 | 
					Direct (non-Ansible and non-SaltStack) usage instructions:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@ -69,7 +69,7 @@ Fairly simple:
 | 
				
			|||||||
    ./bombshell-client vmname bash
 | 
					    ./bombshell-client vmname bash
 | 
				
			||||||
 | 
					
 | 
				
			||||||
starts an interactive bash shell (without a prompt, as there is no tty)
 | 
					starts an interactive bash shell (without a prompt, as there is no tty)
 | 
				
			||||||
on the machine `vmname`.  Any progran can be run in this way.  For
 | 
					on the machine `vmname`.  Any program can be run in this way.  For
 | 
				
			||||||
example:
 | 
					example:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    ./bombshell-client vmname hostname
 | 
					    ./bombshell-client vmname hostname
 | 
				
			||||||
 | 
				
			|||||||
@ -157,7 +157,7 @@ Playbooks
 | 
				
			|||||||
---------
 | 
					---------
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Everything you've seen so far applies to simple `ansible` runs.  But the real
 | 
					Everything you've seen so far applies to simple `ansible` runs.  But the real
 | 
				
			||||||
worth of Ansible is the possiblity to weave repeatable, idempotent scripts
 | 
					worth of Ansible is the possibility to weave repeatable, idempotent scripts
 | 
				
			||||||
that involve multiple machines, so you're not constantly repeating yourself.
 | 
					that involve multiple machines, so you're not constantly repeating yourself.
 | 
				
			||||||
Enter [`ansible-playbook`](https://docs.ansible.com/ansible/playbooks.html),
 | 
					Enter [`ansible-playbook`](https://docs.ansible.com/ansible/playbooks.html),
 | 
				
			||||||
generously documented there, and exemplified here.
 | 
					generously documented there, and exemplified here.
 | 
				
			||||||
@ -185,6 +185,6 @@ We ship several different sample playbooks:
 | 
				
			|||||||
   your template VM, which can later be turned on via the Services tab
 | 
					   your template VM, which can later be turned on via the Services tab
 | 
				
			||||||
   of the properties window of VMs based on the template.  In the example,
 | 
					   of the properties window of VMs based on the template.  In the example,
 | 
				
			||||||
   the service is named `qubes-helloworld`, so that would be the name
 | 
					   the service is named `qubes-helloworld`, so that would be the name
 | 
				
			||||||
   of the service toadd and enable on the Services tab. 
 | 
					   of the service to add and enable on the Services tab.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
More will come as time goes by.  For now, that's all.  Happy hacking!
 | 
					More will come as time goes by.  For now, that's all.  Happy hacking!
 | 
				
			||||||
 | 
				
			|||||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user