Concourse for PCF

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.

Back Up and Restore

Backing up Concourse databases is a best practice that helps protect pipelines, build history, and team information over time. You can also use backed up versions of databases to restore database states after unexpected problems, like database failure, corruption, or interference from malicious third parties.

For more information, see Backing Up and Restoring a Concourse Database.

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.

Note:These pipelines are Open Source reference pipelines that are built and maintained by Pivotal R&D and Pivotal Services teams. These are not yet officially supported by Pivotal.

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.

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