summaryrefslogtreecommitdiff
path: root/nodepool/elements/README.rst
blob: 61ee13fa9db30e67ff396985e8ed5129b244b0da (plain)
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
Using diskimage-builder to build devstack-gate nodes
====================================================

In addition to being able to just download and consume images that are the
same as what run devstack-gate, it's easy to make your own for local dev or
testing - or just for fun.

Install diskimage-builder
-------------------------

Install the dependencies:

::

  sudo apt-get install kpartx qemu-utils curl python-yaml debootstrap

Install diskimage-builder:

::

  sudo -H pip install diskimage-builder


Build an image
--------------

Building an image is simple, we have a script!

::

  bash tools/build-image.sh

See the script for environment variables to set distribution, etc. By default
it builds an ubuntu-minimal based image.  You should be left with a .qcow2
image file of your selected distribution.

Infra uses the -minimal build type for building Ubuntu/CentOS/Fedora. For
example: ubuntu-minimal.

It is a good idea to set ``TMP_DIR`` to somewhere with plenty of space
to avoid the disappointment of a full-disk mid-way through the script
run.

While testing, consider exporting DIB_OFFLINE=true, to skip updating the cache.

Mounting the image
------------------

If you would like to examine the contents of the image, you can mount it on
a loopback device using qemu-nbd.

::

  sudo apt-get install qemu-utils
  sudo modprobe nbd max_part=16
  sudo mkdir -p /tmp/newimage
  sudo qemu-nbd -c /dev/nbd1 /path/to/devstack-gate-precise.qcow2
  sudo mount /dev/nbd1p1 /tmp/newimage

or use the scripts

::

  sudo apt-get install qemu-utils
  sudo modprobe nbd max_part=16
  sudo tools/mount-image.sh devstack-gate-precise.qcow2
  sudo tools/umount-image.sh

Other things
------------

It's a qcow2 image, so you can do tons of things with it. You can upload it
to glance, you can boot it using kvm, and you can even copy it to a cloud
server, replace the contents of the server with it and kexec the new kernel.