ivandavidov / learn-bosh2

Shell scripts which configure bosh-lite VM (by using bosh CLI v2) and deploy simple web server (nWeb). The scripts and the nWeb release have been designed with simplicity in mind and you can easily reverse engineer the structural dependencies.

Learn BOSH v2 (CLI, relase & deployment)

This project demosntstrates the following:

• How to use BOSH CLI v2 in order to setup bosh-lite VM based on bosh-deployment manifest files.
• How to create, upload and deploy the nWeb release. This release has very simple structure and you can easily reverse engineer the connections between its components.

Prerequisites

• Linux OS - all scripts are designed to run on Linux. The scripts have been tested on Linux Mint but they should work fine on pretty much all major Linux distributions.
• Sudo - in order to create routing rule between your network and the nWeb release network via the BOSH director.
• VirtualBox - you need at least version 5.0.
• BOSH CLI v2 - the CLI should be accessible via bosh.
• Git - for obvious reasons.

Tutorial

Long story short - run the all.sh script, sit down and observe the output. Also, take a look at the script and read the comments. They are quite descriptive. You won't learn anything if you just run the script - you actually need to go through the script, examine the commands and experiment.

At some point you may want to save your work. The bosh-lite VM runs in headless mode and by default you don't get UI. You can manually run virtualbox and then choose Machine => Close => Save State. Then you can run the VM by choosing Machine => Start => Headless Start.

Other resources

Perhaps you'd like to take a look at Maria Shaldibina's BOSH guide. Her tutorial is focused around learn-bosh-release.