A VirtualBox image that has all the tools needed to begin OpenStack upstream contribution
Go to file
Mark Korondi dfb0c38a52 Updated changelog 2017-04-28 14:28:38 +02:00
dist Vagrant provisioning with XFCE, devstack, and some GUI apps and settings 2016-06-03 14:27:30 +02:00
docs Adding VirtualBox import screen 2016-10-20 17:02:20 +02:00
files Multiple changes to save on disk and memory usage 2017-04-28 14:13:21 +02:00
.gitignore Vagrant provisioning with XFCE, devstack, and some GUI apps and settings 2016-06-03 14:27:30 +02:00
CHANGELOG.md Updated changelog 2017-04-28 14:28:38 +02:00
LICENSE Initial commit 2016-06-03 14:25:26 +02:00
README-virtualbox-import.md Update README-virtualbox-import.md 2017-04-28 09:19:31 +02:00
README.md Multiple changes to save on disk and memory usage 2017-04-28 14:13:21 +02:00
Vagrantfile Multiple changes to save on disk and memory usage 2017-04-28 14:13:21 +02:00
cleanup.sh Multiple changes to save on disk and memory usage 2017-04-28 14:13:21 +02:00
configure-vagrant.sh xenial update 2017-04-08 00:47:05 +02:00
create-training-box.sh Multiple changes to save on disk and memory usage 2017-04-28 14:13:21 +02:00
install-base.sh Multiple changes to save on disk and memory usage 2017-04-28 14:13:21 +02:00
install-devstack.sh Multiple changes to save on disk and memory usage 2017-04-28 14:13:21 +02:00
install-gui.sh Multiple changes to save on disk and memory usage 2017-04-28 14:13:21 +02:00

README.md

OpenStack Upstream Institute Virtual Environment

bit.ly/training-vm

Introduction

What's this?

A Virtual Machine that has installed in it software what you need to start hacking OpenStack. If you're coming to the Upstream Institute two days before OpenStack Summit starts, you are at the right place.

What do I need?

  • 5GB of free RAM (so at least 8GB in your laptop)
  • Recent CPU with at least 4 cores
  • 10GB disk space
  • VirtualBox

What do I want?

A prebuilt image I want to build myself
Takes 15 minutes Takes 45-60 minutes
Instructions Instructions
Download image (2GB)

Instructions

Using a prebuilt image

  1. Set up VirtualBox
  2. Download the pre-built image
  3. Import the ova file (File -> Import appliance...) (More details to import on Windows are here.)
  4. Start up the VM
  5. Open a terminal and start devstack
    cd /opt/devstack
    ./stack.sh
    
    This step takes about 10 minutes, it needs an internet connection, however the expected downloaded data stays low if using a fresh enough appliance.
  6. To lower the memory consumption, run optimize-memory which configures horizon, keystone and mysql to use less memory.

Building your own

  1. Set up VirtualBox
  2. Set up Vagrant
  3. git clone https://github.com/kmARC/openstack-training-virtual-environment
  4. cd openstack-training-virtual-environment
  5. vagrant up
  6. vagrant reload
  7. vagrant ssh

Follow instructions as for the prebuilt image

Roll your own image

Essentially the same procedure, with exporting an ova archive at the end which then can be distributed and easily import into VirtualBox

./create-training-box.sh is a handy tool that sets up everything with Vagrant and then creates the distributable box file.

Requirements

  • sudo apt install libguestfs-tools

  • libssl098:i386 is required for vmware vdiskmanager (shrink disks)

wget http://security.ubuntu.com/ubuntu/ubuntu/pool/universe/o/openssl098/libssl0.9.8_0.9.8o-7ubuntu4_i386.deb sudo dpkg -i libssl0.9.8_0.9.8o-7ubuntu4_i386.deb ```

Learn how to easily set up devstack

Getting around in the VM

After booting up the virtual machine, start setting up devstack. It takes around 10 minutes to finish, until then you can get familiar with the environment the VM provides you with.

To set up an OpenStack installation with devstack, open a terminal and run:

/opt/devstack/stack.sh && optimize-memory

The four main software you will be using from the desktop during the training are

  • a browser (Firefox)
  • a terminal emulator
  • a text editor (Geany, vim)
  • an IRC client (HexChat)

The browser already contains a couple of handy bookmarks on the bookmark bar. This document can be reached via the VM Help bookmark. When stack.sh finished running, you can open the OpenStack Horizon Dashboard using the DevStack bookmark.

DevStack install OpenStack software to /opt/stack. You can edit these files using you preferred editor of choice. You can install any software from the Ubuntu repoistories using the default ubuntu user (password: openstack, however no password needed for sudo).

To log in to IRC, HexChat is set up for you. Please make sure that you replace the default user ubuntu upon first start before logging in to Freenode channels.

The installed OpenStack cloud is capable of running virtual machines. However, please keep in mind, due to the significant memory requirements of running a VM your environment may not be capable to perform this task. Also note that the default security groups are not modified, so if you want to ping or SSH into your VM, you need to add the correct security rules (ICMP In/Egress from all, SSH ingress from all). Also beware that sometimes Horizon logs you in into the wrong project. To use the private networking by default, you need to log in as the default demo user (password: openstack) and select demo as project.

Screenshots

Devstack running Devstack running

Geany with keystone code loaded Geany with keystone code loaded

git and HexChat git and XChat

License

MIT