neingeist/virssh
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

use markdown in readme

Browse source
This commit is contained in:
neingeist 2011-03-23 14:35:23 +01:00
parent f37d155d9f
commit d6d1e689dd
1 changed files with 11 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

16
README.md
View file

@ -5,34 +5,40 @@ their libvirt VM(s) through SSH. Currently supported is starting/stopping VMs,
serial console and listing all VMs to get their status. Authorization is done
using SSH public keys.
Configuration:
Configuration
=============
1. Create a user "vmadmin".
2. Give that user sudo permissions for calling virsh, so she may control (all)
VMs:
Defaults:vmadmin !requiretty
vmadmin ALL = (root) NOPASSWD: /usr/bin/virsh
<pre>
Defaults:vmadmin !requiretty
vmadmin ALL = (root) NOPASSWD: /usr/bin/virsh
</pre>
3. For every one of your users, create a line in vmadmin's .ssh/authorized_keys
using their SSH public keys:
command="/usr/local/bin/virssh myfancyvm",permitopen="localhost:5915",no-X11-forwarding,no-agent-forwarding ssh-rsa AAAAB...== myfancyuser@hjome
<pre>command="/usr/local/bin/virssh myfancyvm",permitopen="localhost:5915",no-X11-forwarding,no-agent-forwarding ssh-rsa AAAAB...== myfancyuser@hjome</pre>
Instead of specifying only one VM "myfancyvm", you may also specify multiple
VMs by regex, for example "(myfancyvm|myothervm)".
Usage:
Usage
=====
The user may now control her VM using the following commands:
<pre>
ssh -t vmadmin@vmserver sudo virsh list
ssh -t vmadmin@vmserver sudo virsh console myfancyvm
ssh -t vmadmin@vmserver sudo virsh destroy myfancyvm
ssh -t vmadmin@vmserver sudo virsh shutdown myfancyvm
ssh -t vmadmin@vmserver sudo virsh start myfancyvm
ssh -t vmadmin@vmserver sudo virsh start myfancyvm --console
</pre>
If you use a "permitopen" directive, that user may also use the console
command to keep an SSH tunnel open to use VNC.