You can work on the ATC without a full Concourse deployment. This is useful for testing changes to the web UI. The only limitation is that any builds you run will fail with the no workers error. To test your local changes with a full deployment, follow the instructions in the concourse/concourse CONTRIBUTING.md instead.
You need to checkout the concourse/concourse repo. atc will be picked up as a submodule.
git clone https://github.com/concourse/concourse
cd concourse
git submodule update --init --recursive
Concourse is built with Go and Elm. You also need Node and few modules. Assuming you're using a mac:
- Install Elm 0.18 from http://install.elm-lang.org/Elm-Platform-0.18.pkg
- Install homebrew from http://brew.sh/
Then use homebrew to install the following:
brew install go node postgres
Finally use Node to install the javascript tools:
npm install -g elm uglify-js less less-plugin-clean-css
You need a running postgres database named atc. The ATC itself takes care of creating and upgrading the schema, so you just need to create an empty database. If it's the first time you've installed postgres you need to run initdb
initdb /usr/local/var/postgres -E utf8
After that you can start the server and create the empty atc database:
postgres -D /usr/local/var/postgres/
createdb atc
To configure your GOPATH make sure you are in the root concourse checkout directory and run:
source .envrc
NOTE: You need to be in the correct directory. Don't run source .envrc from a different location.
Next, cd to the atc submodule, and checkout the master branch (the submodules have no develop branch):
cd src/github.com/concourse/atc
git checkout master
To build the web code:
go get github.com/jteeuwen/go-bindata/...
cd ./web
make -B
Finally you can run the ATC:
cd ..
go run cmd/atc/*.go --no-really-i-dont-want-any-auth
Concourse should be live at http://localhost:8080