concourse

README

concourse

A BOSH release for concourse. The easiest way to deploy your own instance of concourse on AWS, vSphere, Openstack or with Vagrant.

• Documentation: concourse.ci
• IRC: #concourse on Freenode
• Google Group: Concourse Users
• Roadmap: Pivotal Tracker

Try it on Vagrant

1. Fetch the bosh-release

   git clone https://github.com/concourse/concourse
   cd concourse
   git submodule update --init --recursive
   

2. Install dependencies

   vagrant plugin install vagrant-bosh
   gem install bosh_cli --no-ri --no-rdoc
   go get github.com/concourse/fly
   

3. Create a new VM

   This can take a bit as it will compile everything from source (including Postgres). Later provisions won't take nearly as long.

   vagrant up --provider virtualbox
   

   Currently the only supported provider is VirtualBox. Other providers (AWS, VMware Fusion) should work with minimal changes, but are not tested.

4. Play around with ATC, the web UI.

• Browse to your local ATC and trigger a build.
• Edit manifests/vagrant-bosh.yml and vagrant provision to reconfigure.

1. Play around with Fly, the CLI.

• Write a build config and run it with fly.
• Hop into the container of a running build with fly hijack.