manila-test-image/README
Ben Swartzlander cadc0ee391 Create a config drive to test the metadata code
Because it's not possible to test the metadata service
code in an easy way, create a config drive ISO image for
test purposes.

Also speed up the metadata code to not block while waiting
for the metadata service and to exit quickly when there is
no config drive CD present.

Change-Id: If6a5565825b67de58715e3d2de1cbf69b7f9e551
2017-01-30 19:09:43 +00:00

57 lines
1.3 KiB
Plaintext

This project contains scripts and configs to create a small bootable
Linux image, primarily for the purposes of testing Manila.
It uses buildroot to do nearly all of the hard work.
The built Linux image is optimized for size, and targets the i386
platform under QEMU.
The following extra features are enabled:
* SSH server
* NFSv3/4 server
* NFSv3/4 client
* Samba4 Server
* CIFS client
== Dependencies needed ==
On Ubuntu:
# To build
sudo apt-get -y install curl unzip bc python quilt parted qemu-utils \
build-essential gcc-multilib
# For test/dev
sudo apt-get -y install bison flex texinfo gettext ncurses-dev sshpass \
qt-sdk qemu-kvm genisoimage
On Fedora:
# To build
sudo dnf -y install curl unzip bc python quilt parted qemu-img gcc-c++ \
make glibc-devel.i686
# For test/dev
sudo dnf -y install bison flex texinfo gettext ncurses-devel sshpass \
qt-devel qemu-kvm genisoimage
== Building the images ==
To build both images run:
./run-buildroot.sh
== Cleaning up ==
To nuke everything and start over:
rm -rf buildroot output* overlay*
sudo rm *.qcow2
== Detailed Docs ==
More detailed docs are available:
* doc/building.txt - individual build steps
* doc/configuring.txt - how to change the config
* doc/testing.txt - how to test the images