Page last updated:
Concourse for Pivotal Cloud Foundry (PCF) is a continuous integration and delivery tool that lets you build and monitor scalable pipelines seamlessly. This topic describes how to install Concourse and what you need to install it successfully.
Before you install Concourse for PCF, you must have the following:
- A supported IaaS provider: AWS, Azure, GCP, or vSphere
A BOSH Director. For more information about the BOSH Director, see Deploying BOSH with create-env in the BOSH documentation.
Warning: It is not recommended to use a BOSH Director associated with an existing PCF deployment. This is because Concourse for PCF can conflict with other tiles deploying on Ops Manager at the same time.
BOSH CLI v2. For more information, see Installing the CLI in the BOSH documentation.
Concourse and Garden Run-C BOSH releases. Download these from Pivotal Network.
The stemcell for your IaaS, for when you create your Concourse deployment manifest. To download an Ubuntu Xenial stemcell from Pivotal Network, see Stemcells for PCF (Ubuntu Xenial).
PostgreSQL v9.5 and later. Concourse can be configured to connect to an external PostgreSQL database or a BOSH-managed Cloud Foundry PostgreSQL release. For more information, see postgres/36) in the BOSH documentation.
Note: As of Concourse v3.6.0, the Concourse BOSH release no longer supplies an internal PostgreSQL. You must provide your own PostgreSQL database as of v3.6.0.
To configure and deploy Concourse for PCF, do the following:
- Modify the
cloud-config.ymlfile according to your IaaS environment. For information, see Updating Cloud Config in the BOSH documentation.
- Prepare the Concourse deployment manifest.
You can write your own manifest or modify a template
with your unique configuration. For an example of a manifest template,
see the concourse.yml file
For more information about
Cluster Concourse deployment, see concourse-bosh-deployment in GitHub.
- Configure authentication in your deployment manifest by providing
tls_keyvalues. For instructions, see Authentication.
- Prepare the
cloud-config.ymlfile and upload it to your BOSH Director with
- Deploy Concourse with
bosh deploy. For more information, see Deploying in the BOSH documentation. After Concourse deploys, a success message is displayed.