vagrant-swift-all-in-one

A Swift-All-In-One in a few easy steps.

1. vagrant up
2. vagrant ssh
3. echo "awesome" > test
4. swift upload test test
5. swift download test test -o -

This project assumes you have Virtualbox and Vagrant.

• https://www.virtualbox.org/wiki/Downloads
• http://www.vagrantup.com/downloads.html

running-tests

You should be able to run most tests without too much fuss once SSH'ed into the VM.

1. .unittests
2. .functests
3. .probetests
4. vtox -e pep8
5. vtox -e py27
6. vtox # run all gate checks

localrc-template

A few things are configurable, see localrc-template.

1. cp localrc-template localrc
2. vi localrc
3. source localrc
4. vagrant provision
5. vagrant ssh
6. rebuildswift

s3cmd

You know you want to play with s3api, we got you covered.

vagrant ssh
s3cmd mb s3://s3test
s3cmd ls

configure statsd_exporter/prometheus metrics

You should be able to optionally configure statsd_exporter/prometheus metrics for the Swift stack on the VM.

cp localrc-template localrc
sed -i 's/^\(export STATSD_EXPORTER=\)\([^ ]*\) /\1true/g' localrc
source localrc
vagrant provision

These will expose /metrics endpoints on ports 9100-9105 which you can check directly, and configure prometheus to scrape these endpoints every 10s and retain data for up to a day; you can then create ad-hoc graphs at

• http://saio:9090/graph

ninja-dev-tricks

You should add the configured IP from your localrc to your /etc/hosts or use the default:

sudo bash -c 'echo "192.168.8.80    saio" >> /etc/hosts'

Then you can easily share snippets that talk to network services running in your Swift-All-In-One from your host!

curl -s http://saio:8080/info | python -m json.tool

A few scripts are available to make your dev life easier.

1. vagrant up --provision will bring up your VM in working order (useful when your VM is halted)
2. source localrc; vagrant provision on your host to push the new Chef bits in place (useful if you change localrc)
3. rebuildswift to reapply everything like it would be at the end of Chef time (useful to revert local config changes)
4. resetswift will wipe the drives and leave any local config changes in place (useful just to clean out Swift data)
5. reinstallswift will make sure all of the bin scripts are installed correctly and restart the main swift processes (useful if you change branches)
6. autodoc [swift|swiftclient] will build the sphinx docs and watch files for changes, and upload them to a public container on your vm so you can review them as you edit
7. vtox will hack the local tox.ini and setup.py so you can run tox tests successfully on the swift repo in the /vagrant directory
8. reec will rebuild/reinstall all the liberasure/pyeclib[/isa-l] bits!
9. venv py37 will make sure your tox virtualenv is ready and let you py3