You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Aidan Oldershaw 1472a3116c
Merge pull request #6605 from concourse/issue/6542
9 hours ago
.github use smaller vehicle for patches 3 weeks ago
atc lidar: check parent resource type 5 days ago
cmd S: extract common Ginkgo setup 3 weeks ago
fly update fake files generated by latest version of counterfeiter. 1 week ago
go-concourse added missing go-concourse fake files. 1 week ago
hack default to containerd in docker-compose 1 week ago
integration cmdtest: Run/Output/OutputJSON asserts success 1 month ago
screenshots add 2x scaled screenshot for hidpi laptops 2 years ago
skymarshal update fake files generated by latest version of counterfeiter. 1 week ago
testflight fixed testflight tests. 1 month ago
topgun topgun: skip Vault tests 1 month ago
tracing update fake files generated by latest version of counterfeiter. 1 week ago
tsa update fake files generated by latest version of counterfeiter. 1 week ago
vars update fake files generated by latest version of counterfeiter. 1 week ago
web Merge pull request #6605 from concourse/issue/6542 9 hours ago
worker B: mount gdn-init after other default mounts 1 week ago
.deepsource.toml add deepsource config 5 months ago
.dockerignore ignore test suites in .dockerignore 1 month ago
.env run watsjs/testflight against prebuilt Concourse 2 years ago
.gitignore integration: re-add docker-compose.yml 1 month ago
CODE_OF_CONDUCT.md update notice and concourse email 7 months ago
CONTRIBUTING.md bump Go version in CONTRIBUTING.md 1 week ago
Dockerfile web: behavior: use go:embed, re-parse index.html 1 week ago
LICENSE.md re-init 2 years ago
NOTICE.md update notice and concourse email 7 months ago
README.md v10: update instanced pipelines status 4 weeks ago
SECURITY.md add SECURITY.md 7 months ago
docker-compose.yml default to containerd in docker-compose 1 week ago
go.mod added missing go-concourse fake files. 1 week ago
go.sum added missing go-concourse fake files. 1 week ago
package.json fix uglifyjs cli 4 months ago
tools.go Add tools.go to keep track of tool versions 1 year ago
versions.go bump worker version to 2.3. 3 months ago
webpack.config.js web: babel-ify javascript bundle 1 year ago
yarn.lock After a rebase 4 weeks ago

README.md

Concourse: the continuous thing-doer.

Discord
Build
Contributors
Help Wanted

Concourse is an automation system written in Go. It is most commonly used for
CI/CD, and is built to scale to any kind of automation pipeline, from simple to
complex.

booklit pipeline

Concourse is very opinionated about a few things: idempotency, immutability,
declarative config, stateless workers, and reproducible builds.

The road to Concourse v10

Concourse v10 is the code name for a set of features which, when used
in combination, will have a massive impact on Concourse's capabilities as a
generic continuous thing-doer. These features, and how they interact, are
described in detail in the Core roadmap: towards v10 and Re-inventing
resource types
blog posts. (These posts are slightly out of
date, but they get the idea across.)

Notably, v10 will make Concourse not suck for multi-branch and/or
pull-request driven workflows
- examples of spatial change, where the set
of things to automate grows and shrinks over time.

Because v10 is really an alias for a ton of separate features, there's a lot
to keep track of - here's an overview:

Feature RFC Status
set_pipeline step #31 ✔ v5.8.0 (experimental), TODO: #5814
Var sources for creds #39 ✔ v5.8.0 (experimental), TODO: #5813
Archiving pipelines #33 ✔ v6.5.0
Instanced pipelines #34 ✔ v7.0.0 (experimental, not released yet)
Static across step 🚧 #29 ✔ v6.5.0 (experimental)
Dynamic across step 🚧 #29 🙏 RFC needs feedback!
Projects 🚧 #32 🙏 RFC needs feedback!
load_var step #27 ✔ v6.0.0 (experimental)
get_var step #27 🚧 #5815 in progress!
Prototypes #37 ⚠ Pending first use of protocol (any of the below)
run step 🚧 #37 ⚠ Pending its own RFC, but feel free to experiment
Resource prototypes #38 🙏 #5870 looking for volunteers!
Var source prototypes 🚧 #6275 planned, may lead to RFC
Notifier prototypes 🚧 #28 ⚠ RFC not ready

The Concourse team at VMware will be working on these features, however in the
interest of growing a healthy community of contributors we would really
appreciate any volunteers. This roadmap is very easy to parallelize, as it is
comprised of many orthogonal features, so the faster we can power through it,
the faster we can all benefit. We want these for our own pipelines too! 😆

If you'd like to get involved, hop in Discord or leave a comment on
any of the issues linked above so we can coordinate. We're more than happy to
help figure things out or pick up any work that you don't feel comfortable
doing (e.g. UI, unfamiliar parts, etc.).

Thanks to everyone who has contributed so far, whether in code or in the
community, and thanks to everyone for their patience while we figure out how to
support such common functionality the "Concoursey way!" 🙏

Installation

Concourse is distributed as a single concourse binary, available on the Releases page.

If you want to just kick the tires, jump ahead to the Quick Start.

In addition to the concourse binary, there are a few other supported formats.
Consult their GitHub repos for more information:

Quick Start

$ wget https://concourse-ci.org/docker-compose.yml
$ docker-compose up
Creating docs_concourse-db_1 ... done
Creating docs_concourse_1    ... done

Concourse will be running at 127.0.0.1:8080. You can
log in with the username/password as test/test.

Next, install fly by downloading it from the web UI and target your local
Concourse as the test user:

$ fly -t ci login -c http://127.0.0.1:8080 -u test -p test
logging in to team 'main'

target saved

Configuring a Pipeline

There is no GUI for configuring Concourse. Instead, pipelines are configured as
declarative YAML files:

resources:
- name: booklit
  type: git
  source: {uri: "https://github.com/vito/booklit"}

jobs:
- name: unit
  plan:
  - get: booklit
    trigger: true
  - task: test
    file: booklit/ci/test.yml

Most operations are done via the accompanying fly CLI. If you've got Concourse
installed, try saving the above example
as booklit.yml, target your Concourse
instance
, and then run:

fly -t ci set-pipeline -p booklit -c booklit.yml

These pipeline files are self-contained, maximizing portability from one
Concourse instance to the next.

Learn More

Contributing

Our user base is basically everyone that develops software (and wants it to
work).

It's a lot of work, and we need your help! If you're interested, check out our
contributing docs.