1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
|
.TH dman 1 "10 Oct 2011" bikeshed "bikeshed"
.SH NAME
cloud-sandbox \- launch a cloud instance and ssh directly into it, as a 'sandbox' system
.SH SYNOPSIS
\fBcloud-sandbox\fP [instance-type [ubuntu-release]] [ec2-run-instance-options]
.SH DESCRIPTION
\fBcloud-sandbox\fP is a program that launches a cloud instance (EC2 by default), automatically generates ssh host keys, ssh's into the launched system, and prompts the user for instance termination on exit.
\fBcloud-sandbox\fP does the following:
- conveniently supports simple parameters for instance-type and ubuntu-release, by passing those to \fBubuntu-ec2-run\fP(1)\fP
- generates ssh-host keys locally using \fBssh-keygen\fP(1)\fP, and passes them to the instance
- automatically adds host key fingerprints to a local host keys file, \fI$HOME/.ssh/known_hosts.cloud\fP, which removes the interactive fingerprint prompt
- uses \fBssh-import-id\fP(1)\fP in the instance to import the user's public SSH key, if the environment variable $LAUNCHPAD_ID exists
- uses \fBbootmail\fP(1) to send the user email noting that the instance has booted, if the environment variable $BOOTMAIL exists and is a valid email address
- waits in a loop for \fBsshd\fP(8) to start on the cloud instance
- execs an \fBssh\fP(1) session to the instance
- upon exit, interactively prompts the user if they want to immediately terminate the instance and remote the ssh known host key
.SH EXAMPLE
cloud-sandbox
cloud-sandbox m1.large
cloud-sandbox t1.micro lucid
.SH CAVEATS
Note that the network operations will be a little slower than perhaps you are used to, when reading a manpage. Also note that you must be internet-connected, and able to access manpages.ubuntu.com for this utility to be useful. Finally, the algorithm that \fBdman\fP uses to retrieve remote pages is considerably simpler than that of \fBman\fP(1).
.SH SEE ALSO
\fBubuntu-ec2-run\fP(1)\fP, \fBssh-import-id\fP(1)\fP, \fBbootmail\fP(1)\fP, \fBssh-keygen\fP(1)\fP
.SH AUTHOR
This manpage and the utility was written by Dustin Kirkland <kirkland@ubuntu.com> for Ubuntu systems (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL, or on the web at \fIhttp://www.gnu.org/licenses/gpl.txt\fP.
|