Setting Up Your Environment for Wallaroo in Vagrant
To get you up and running quickly with Wallaroo, we have provided a Vagrantfile which includes Wallaroo and related tools needed to run and modify a few example applications. We should warn that this Vagrantfile was created with the intent of getting users started quickly with Wallaroo and is not intended to be suitable for production. Wallaroo in Vagrant runs on Ubuntu Linux Xenial.
Note: For Windows users, this section of the guide assumes you are using Powershell.
Set up Environment for the Wallaroo Tutorial
Linux Ubuntu, MacOS, and Windows via Powershell
If you haven't already done so, create a directory called
~/wallaroo-tutorial and navigate there by running:
cd ~/ mkdir ~/wallaroo-tutorial cd ~/wallaroo-tutorial
This will be our base directory in what follows. Download the Wallaroo sources (this will create a subdirectory called
curl -L -o wallaroo-0.5.2.tar.gz 'https://wallaroo-labs.bintray.com/wallaroolabs-ftp/wallaroo/0.5.2/wallaroo-0.5.2.tar.gz' mkdir wallaroo-0.5.2 tar -C wallaroo-0.5.2 --strip-components=1 -xzf wallaroo-0.5.2.tar.gz rm wallaroo-0.5.2.tar.gz cd wallaroo-0.5.2
The Wallaroo Vagrant environment is dependent on the default provider,VirtualBox. To install VirtualBox, download a installer or package for your OS here. Linux users can also use
apt-get as documented below.
sudo apt-get install virtualbox
Linux Ubuntu, MacOS, and Windows
Download links for the appropriate installer or package for each supported OS can be found on the Vagrant downloads page.
Provision the Vagrant Box
Provisioning should take about 10 to 15 minutes. When it finishes, you will have a complete Wallaroo development environment. You won’t have to go through the provisioning process again unless you destroy the Wallaroo environment by running
To provision, run the following commands:
cd ~/wallaroo-tutorial/wallaroo-0.5.2/vagrant vagrant up
What's Included in the Wallaroo Vagrant Box
Go Compiler: for compiling Wallaroo Go applications.
Giles Sender: supplies data to Wallaroo applications over TCP.
Giles Receiver: receives data from Wallaroo over TCP.
Cluster Shutdown tool: notifies the cluster to shut down cleanly.
Metrics UI: receives and displays metrics for running Wallaroo applications.
Wallaroo Source Code: full Wallaroo source code is provided, including Go example applications.
Shutdown the Vagrant Box
You can shut down the Vagrant Box by running the following on your host machine:
cd ~/wallaroo-tutorial/wallaroo-0.5.2/vagrant vagrant halt
Restart the Vagrant Box
If you need to restart the Vagrant Box you can run the following command from the same directory:
Register today and receive a Wallaroo T-shirt and a one-hour phone consultation with Sean, our V.P. of Engineering, to discuss your streaming data questions. Not sure if you have a streaming data problem? Not sure how to go about architecting a streaming data system? Looking to improve an existing system? Not sure how Wallaroo can help? Sean has extensive experience and is happy to help you work through your questions.
Please register here: https://www.wallaroolabs.com/register.
Your email address will only be used to facilitate the above.
Awesome! All set. Time to try running your first Wallaroo application in Vagrant.