test

README

flynn-test

flynn-test contains full-stack acceptance tests for Flynn.

Usage

Bootstrap Flynn

The tests need a running Flynn cluster, so you will need to boot one first.

To run Flynn locally, first boot and SSH to the Flynn dev box:

vagrant up
vagrant ssh

then build and bootstrap Flynn (this may take a few minutes):

make
script/bootstrap-flynn

Run the tests

Run the flynn cluster add command from the bootstrap output to add the cluster to your ~/.flynnrc file, then run the tests:

flynn cluster add ...
cd ~/go/src/github.com/flynn/flynn/test
bin/flynn-test --flynnrc ~/.flynnrc --cli `pwd`/../cli/bin/flynn

Auto booting clusters

The test binary is capable of booting its own cluster to run the tests against, provided you are using a machine capable of running KVM.

Build root filesystem + kernel

Before running the tests, you need a root filesystem and a Linux kernel capable of building and running Flynn.

To build these into /tmp/flynn:

mkdir -p /tmp/flynn
sudo rootfs/build.sh /tmp/flynn

You should now have /tmp/flynn/rootfs.img and /tmp/flynn/vmlinuz.

Build the tests

go build -o flynn-test

Download Flynn CLI

The tests interact with the VM cluster using the Flynn CLI, so you will need it locally.

Download it into the current directory:

curl -sL -A "`uname -sp`" https://dl.flynn.io/cli | zcat >flynn
chmod +x flynn

Run the tests

sudo ./flynn-test \
  --user `whoami` \
  --rootfs /tmp/flynn/rootfs.img \
  --kernel /tmp/flynn/vmlinuz \
  --cli `pwd`/flynn

CI

Install the runner

Install Git if not already installed, then check out the Flynn git repo and run the following to install the runner into /opt/flynn-test:

sudo test/scripts/install

Add the following credentials to /opt/flynn-test/.credentials:

export AUTH_KEY=XXXXXXXXXX
export GITHUB_TOKEN=XXXXXXXXXX
export AWS_ACCESS_KEY_ID=XXXXXXXXXX
export AWS_SECRET_ACCESS_KEY=XXXXXXXXXX

Now start the runner:

sudo start flynn-test

Updating the runner

If the runner code has been changed, restart the Upstart job to pull in the new changes:

sudo restart flynn-test

If the rootfs needs rebuilding, you will need to remove the existing image before starting the runner again:

sudo stop flynn-test
sudo rm -rf /opt/flynn-test/build/{rootfs.img,vmlinuz}
sudo start flynn-test