~ubuntu-branches/ubuntu/trusty/openstack-debian-images/trusty

« back to all changes in this revision

Viewing changes to build-openstack-debian-image.1

  • Committer: Package Import Robot
  • Author(s): Thomas Goirand
  • Date: 2013-06-11 16:47:18 UTC
  • Revision ID: package-import@ubuntu.com-20130611164718-r5ft087j5nx1va92
Tags: 0.2
* Also unmount the /proc of the image folder in /tmp in case we abort due to
  the .deb files missing if building a Wheezy image.
* Review the script man page.
* Adds the installation of the kbd package, and disabling of consol blanking.
* Don't setup a password for root.
* Fixes the sources.list which had whatever was used for the debootstrap.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH build\-openstack\-debian\-image 1
 
2
.SH NAME
 
3
build\-openstack\-debian\-image \- build a Debian image to be used with OpenStack
 
4
.SH SYNOPSIS
 
5
.B build\-openstack\-debian\-image
 
6
.B \-\-release|\-r <jessie|wheezy>
 
7
[ OPTIONS ]
 
8
 
 
9
.SH DESCRIPTION
 
10
.LP
 
11
The
 
12
.I build\-openstack\-debian\-image
 
13
shell script will build a Debian image which can be used in an OpenStack IaaS
 
14
cloud. The resulting (Qcow2 and raw images) contains initramfs\-growroot so
 
15
that the root partition will be resized (during the initramfs phase, before
 
16
mouting anything) to match the flavor selected when using "nova boot". Later on
 
17
during the boot process, cloud\-init will resize the root partition on the fly
 
18
(resize is performed when the partition is already mounted read\-write, since
 
19
recent kernel allow that for ext3).
 
20
 
 
21
Cloud\-init is setup to use an Ec2 metadata server, which is what OpenStack is
 
22
compatible with. A "debian" user will be used to receive the ssh key from the
 
23
user data blob. This user is setup without a password (eg: adduser
 
24
\-\-disabled\-password).  Once logged as this "debian" user in your new virtual
 
25
machine, you can "sudo" to root from that user, without needing a password. The
 
26
root password is "password" by default, and ssh into the root user without
 
27
using an ssh keypair is disabled by default (PermitRootLogin without-password
 
28
is set in /etc/ssh/sshd_config).
 
29
 
 
30
.SH "PARAMETERS"
 
31
 
 
32
.LP
 
33
.B \-\-release|\-r
 
34
.I wheezy|jessie
 
35
.IP
 
36
 
 
37
Sets the
 
38
.I release
 
39
name to be installed. Currently only 2 values a possible:
 
40
.I wheezy
 
41
and
 
42
.I jessie.
 
43
 
 
44
.SH "OPTIONS"
 
45
 
 
46
.LP
 
47
.B \-\-debootstrap\-url|\-u
 
48
.I http://<debian\-mirror>/debian
 
49
.IP
 
50
 
 
51
Select the
 
52
.I URL
 
53
of the Debian mirror to use to perform the debootstrap. For example:
 
54
.I http://ftp.fr.debian.org/debian
 
55
 
 
56
.LP
 
57
.B \-\-minimal
 
58
.IP
 
59
 
 
60
Without this option, the following packages will also be installed:
 
61
bash\-completion (and /etc/bash.bashrc will be setup to use bash\-completion),
 
62
joe (the text editor), most, GNU screen, less and vim. If you believe that
 
63
more things should be added in the non\-minimal image, suggestions are
 
64
welcome.
 
65
 
 
66
.SH AUTHORS
 
67
 
 
68
build\-openstack\-debian\-image has been written by Thomas Goirand
 
69
<zigo@debian.org>.