Concourse for PCF v5.x

Concourse for PCF

Page last updated:

Concourse for Pivotal Cloud Foundry (PCF) is a continuous integration tool that enables you to 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: Pivotal recommends using BOSH CLI v5 or later with Concourse for PCF. Pivotal discourages using BOSH CLI v1.

When you are ready to install Concourse for PCF, see 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, you can parameterize pipeline credentials with parameters in your pipeline or task config files. For more information, see the Concourse documentation. Credential management also allows for credentials to be rotated and managed from outside the pipeline or team and prevents them from being revealed by the get-pipeline command. For more information about get-pipeline, see the Concourse documentation.

For more detail, see Credential Management in Concourse.

Team Authentication

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

For more information, see Configuring Local Users.

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 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

To troubleshoot your Concourse for PCF installation, see Monitoring and Troubleshooting.

Concourse Compatibility

Concourse Version PostgreSQL Tested Stemcell Supported Stemcells Tested CredHub
v5.2.0 9.6+ External Xenial 315.26 315.x 2.4.0

Warning: If you are using PostgreSQL v11.1 or v11.2, set max_parallel_workers_per_gather to 0. This corrects a PostgreSQL infinite parallel query issue.

For more information, see max_parallel_workers_per_gather (integer) and BUG #15585: infinite DynamicSharedMemoryControlLock waiting in parallel query in the PostgreSQL documentation.

Note: Concourse is compatible with CredHub versions 2.1.2 and later. It is not compatible with versions 2.0.0 to 2.1.1.

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 dependencies.

Additional Documentation

For more information about the open source Concourse project that powers Concourse for PCF, see the Concourse documentation.

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