Concourse for PCF v4.x

Concourse for PCF

Page last updated:

Concourse for Pivotal Cloud Foundry (PCF) is a continuous integration tool that lets you build, scale, and monitor pipelines outside of your PCF deployment. Using Concourse, you can set up production pipelines to deploy and manage your apps in real time.

Installing Concourse for PCF

Concourse for PCF is a BOSH release that requires the operator to install and maintain an independent BOSH Director.

If you are unfamiliar with BOSH, Pivotal recommends that you review the BOSH documentation before continuing with the installation of Concourse for PCF.

Note: Use the BOSH CLI v2 or v3 with Concourse for PCF. Pivotal does not recommend using the old BOSH CLI v1 with Concourse for PCF.

When you are ready to install Concourse for PCF, see Preparing an Environment for Concourse and Installing Concourse for PCF.

Additional Considerations

Database Encryption

Concourse lets you encrypt sensitive information before it reaches the database. By using encryption, you ensure that plaintext credentials do not exist in memory for longer than absolutely necessary.

For more information, see Encrypting Concourse Databases.

Credential Management

With Concourse credential management, pipeline credentials can be parameterized with ((parameters)) in your pipeline or task config files. Credential management also allows for credentials to be rotated and managed from outside the pipeline or team, and prevents them from being revealed by get-pipeline.

For more information, see Credential Management in Concourse .

Team Authentication

In order to protect confidential or sensitive data, Concourse provides options for team authorization.

For more information, see Configuring Team Authentication.

Monitoring and Troubleshooting

Concourse can emit metrics about both the system health itself and about the builds that it is running. Operators can tap into these metrics in order to observe the health of the system.

For more information, see Monitoring and Troubleshooting.

Concourse Architecture

Concourse is composed of two major sub-components: the web service (ATC and TSA) and workers.

For information about the architecture of Concourse and its components, see Concourse Architecture.

Monitoring and Troubleshooting Your Installation

If you’re having trouble with your Concourse for PCF installation, this topic may help.

For more information, see Troubleshooting.

Concourse Compatibility

Concourse Version RunC PostgreSQL Tested Stemcell Supported Stemcells Tested CredHub
v3.3.3 1.6.0 Internal pgdb Trusty 3421.11 3421.x Not Supported
v3.5.0 1.6.0 Internal pgdb Trusty 3445.11 3445.x 1.3.x
v3.6.0 1.9.0 9.5+ External Trusty 3468 3468.x 1.3.x
v3.8.0 1.9.0 9.5+ External Trusty 3468.11 3468.x 1.3.x
v3.9.2 1.12.0 9.5+ External Trusty 3468.22 3468.x 1.7.1
v3.13.0 1.13.1 9.5+ External Trusty 3541.12 3541.x 1.8.3
v4.2.1 1.16.3 9.5+ External Xenial 97.16 97.x 1.9.5
v4.2.2 1.16.0 & 1.17.2 9.5+ External Xenial 97 & 170.13 97.x & 170.x 1.9.5

Note: The values in the “Tested” columns indicate that Concourse was tested with the listed stemcell or product version upon release. This does not mean that Concourse is restricted to those dependancies.

Additional Documentation

You can also read the documentation for the open source Concourse project, which powers Concourse for PCF.

Create a pull request or raise an issue on the source for this page in GitHub