A VirtualBox image that has all the tools needed to begin OpenStack upstream contribution
Go to file
tushargite96 43dbeb3c53 Moving IRC network reference to OFTC
Change-Id: I1f2ecbde7d7477b6e42cea63bb192b1ed0ed511e
2021-07-17 12:34:54 +05:30
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
elements/upstream-training Moving IRC network reference to OFTC 2021-07-17 12:34:54 +05:30
vm-creator-vm Upgrading Virtual Machine to Ubuntu Xenial 2018-11-26 12:12:56 +00:00
.gitignore Upgrading Virtual Machine to Ubuntu Xenial 2018-11-26 12:12:56 +00:00
.gitreview OpenDev Migration Patch 2019-04-19 19:35:57 +00:00
CHANGELOG.md 2020 Virtual ediiton 2020-10-16 16:24:01 +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 Moving IRC network reference to OFTC 2021-07-17 12:34:54 +05:30
create-training-box.sh 2020 Virtual ediiton 2020-10-16 16:24:01 +02:00
import-virsh.sh import-virsh script for qemu/kvm 2018-12-04 21:50:30 +00:00
prereqs.sh Upgrading Virtual Machine to Ubuntu Xenial 2018-11-26 12:12:56 +00:00
upstream-training.ovf Updating pip packages. Enabling VBoxSVGA driver. 2019-10-09 20:29:11 +02:00

README.md

OpenStack Upstream Institute Virtual Environment

bit.ly/upstream-training

bit.ly/vm-2020-virtual-v1

Instructions

Using VirtualBox

  1. Set up VirtualBox version 6 with Extension Pack
  2. Download the latest VM image.
  3. Import the ova file (File -> Import appliance...)

    on Windows? look here.)

  4. Start up the VM

Using VMware player

  1. Set up VMware player
  2. Download the latest VM image.
  3. Open the ova file (File -> Open a Virtual Machine)

    A warning dialog might appear. Click on Retry

  4. Start up the VM

Minimum requirements

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

Getting around in the VM

  1. Run stack.sh to install devstack. It might take 10-20 minutes.

    cd /opt/devstack
    ./stack.sh
    
  2. Explore the environment. The four main software you will be using from the desktop during the training are:

    • Firefox web browser
    • Xfce4-terminal terminal emulator
    • Geany text editor
    • HexChat IRC client

      please make sure that you replace the default user ubuntu upon first start before logging in to OFTC channels.

    • DevStack is run from /opt/devstack
    • OpenStack source code is placed to /opt/stack
  3. When stack.sh finished running, you can open your Horizon Dashboard or on VirtualBox using the DevStack bookmark

    • Login: demo
    • Password: openstack
  1. In the upper left corner, switch from invisible_to_admin to the demo project

  2. Start a VM (no volume needed, use the nano flavor). A CirrOS image is already set up by devstack

  3. Associate a floating IP. Initially, no Floating IP's allocated, you can add one with the + button. An example would be 172.124.4.45. It may stuck at the loading screen - in this case, reload the dashboard.

  4. Enable SSH and ICMP ports on the default security group. Select "Network" -> "Security groups" and "Manage rules" -> "Add rule"

  5. Try to connect with SSH to the floating IP.

    $ ssh root@<FLOATING_IP> -l cirros # password: gocubsgo
    
    # Example: ssh root@172.24.4.45 -l cirros
    
  6. DNS might not work in the cirros vm, in this case:

    echo "nameserver 1.1.1.1" | sudo tee /etc/resolv.conf`
    
  7. IMPORTANT: To keep your devstack environment across reboots, do not reboot / halt the VM, but instead use "Save the machine state" from VirtualBox quit dialog.

Devstack installs using the 99-devstack script.

Using latest devstack

Please do not update your openstack installation during the training. It requires bandwidth.

If you want to keep on using the training VM for devstacking, you should disable offline mode in local.conf. Also reconsider git related settings here.

Screenshots

devstack geany git-hexchat
devstack text editor git and irc

Advanced Topics

This section is mainly for developers of the VM, on the training you won't need this.

Roll your own image

The image can be built using diskimage-builder in a convenience vagrant machine from vm-creator-vm directory

  1. Spin up vm-creator-vm:

    cd vm-creator-vm/
    vagrant up
    vagrant ssh
    cd git-repo # this directory contains the git repository of the upsteram-institute-vm
    

    This will boot up a VirtualBox VM with CentOS 7

  2. Activate the python virtual environment

    . .env/bin/activate
    
  3. Create disk image with provided convenience script

    ./create-training-box.sh
    
  4. The generated image can be found under dist/

License

MIT