Images for testing Manila (infrastructure project)
Go to file
Ben Swartzlander 3c8053515a Install packages automatically on Ubuntu
For gate jobs, we need to automate the installing of
dependencies, so check if we're on Ubuntu and handle that
case automatically. Other distros can still use the script
but need to manually take care of dependencies.

Change-Id: Id2c6a815c018cdfe3b288c38c7033275f25d8f13
2017-01-27 19:59:07 -05:00
common-files Initial commit 2016-10-19 11:36:17 -04:00
conf Initial commit 2016-10-19 11:36:17 -04:00
doc Split out one-time steps into their own script 2016-10-19 14:59:38 -04:00
patches Initial commit 2016-10-19 11:36:17 -04:00
server-files/etc Initial commit 2016-10-19 11:36:17 -04:00
.gitignore Fix bashate job 2017-01-27 15:02:06 -05:00
COPYING Initial commit 2016-10-19 11:36:17 -04:00
README Add parted as a dependency 2016-10-21 08:55:53 -04:00
init-buildroot.sh Install packages automatically on Ubuntu 2017-01-27 19:59:07 -05:00
make-bootable-disk.sh Initial commit 2016-10-19 11:36:17 -04:00
run-buildroot.sh Split out one-time steps into their own script 2016-10-19 14:59:38 -04:00
setup.cfg Fix bashate job 2017-01-27 15:02:06 -05:00
setup.py Fix bashate job 2017-01-27 15:02:06 -05:00
tox.ini Fix bashate job 2017-01-27 15:02:06 -05:00

README

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 unzip bc python quilt parted qemu-utils \
     build-essential gcc-multilib
 # For test/dev
 sudo apt-get -y bison flex texinfo gettext ncurses-dev sshpass \
     qt-sdk qemu-kvm

On Fedora:

 # To build
 sudo dnf -y install unzip bc python quilt parted qemu-img gcc-c++ \
     make glibc-devel.i686
 # For test/dev
 sudo apt-get -y bison flex texinfo gettext ncurses-devel sshpass \
     qt-devel qemu-kvm

== 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