v3.10.0 - docker-compose up

With Concourse v3.10.0, the home page instructions for getting started have migrated to docker-compose up and we have done the same with this tutorial.

This is fantastic for the Windows users who were struggling with bosh create-env not working.

The docker-compose.yml does not include credhub, so for the secret credentials section we're continuing to promote https://github.com/starkandwayne/bucc as the path to both credhub/secret credentials and towards production deployments.

Concourse v3.8.0 + Big Rewrite + https://concoursetutorial.com/

This Concourse Tutorial book is now published as pretty + printable web app https://concoursetutorial.com/ - previously it was a long README.

There is a new push to teach Secrets Management now that its a first-class feature of Concourse.

The tutorial starts with bosh create-env manifests/concourse-lite.yml (and includes pre-compiled releases so this is fast) and moves to using https://github.com/starkandwayne/bucc - a single vm that includes concourse + credhub for credentials management.

I first wrote the Concourse Tutorial in early 2015 as I was struggling to learn https://concourse.ci. Over the years, the linear methodology for the tutorial has held up well - start with running tasks, which become pipelines, with have input resources, and publish to output resource, which requires user-provided credentials, which are provided by parameters.

I've made a small change during this rewrite. I introduce Parameters immediately after you are told to edit pipeline.yml and insert your secrets, and then we continue to use Concourse parameters ((some-variable)) for the remainder of the book.

After completing the Basics section of lessons in sequential order, the Miscellaneous section can be completed in any order. They are all interesting and highly recommended. The Miscellaneous lessons assume you're using bucc; but importantly they assume that you are using one of the supported Credentials Managers for Concourse (credhub or vault). This is best practise - don't store secrets on your local file system, and don't statically set them with fly set-pipeline.

If you've read Concourse Tutorial before, I definitely would appreciate you reviewing the new https://concoursetutorial.com/ site and giving me any feedback. If it is useful, please recommend it to your friends and coworkers.