-
Notifications
You must be signed in to change notification settings - Fork 19
/
Copy pathinstalling.html.md.erb
78 lines (65 loc) · 4.25 KB
/
installing.html.md.erb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
---
title: Installing Concourse
owner: Concourse
---
<strong><%= modified_date %></strong>
Pivotal provides step-by-step upgrade guides for moving to supported versions of
Concourse for PCF.
For instructions on installing Concourse for PCF v5.2.x, see the pages below:
* Install v5.2.0
* [Introduction](http://docs.pivotal.io/concourse-pcf/v5/installation/)
* [Prerequisites](http://docs.pivotal.io/concourse-pcf/v5/installation/prerequisites/)
* [Install Concourse](http://docs.pivotal.io/concourse-pcf/v5/installation/install-concourse/)
<!-- Concourse for Pivotal Cloud Foundry (PCF) is a continuous integration and
delivery tool that enables you to build and monitor scalable pipelines seamlessly.
This topic describes how to install Concourse and what you need to install it successfully.
## Prerequisites
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](http://bosh.io/docs/init.html) in the BOSH documentation.
<p class="note warning"><strong>Warning:</strong> Pivotal discourages the use of 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.</p>
* BOSH CLI v5.x and earlier. For more information, see
[Installing the CLI](https://bosh.io/docs/cli-v2-install/) in the BOSH documentation.
* Concourse BOSH release. Download this from
[Pivotal Network](https://network.pivotal.io/products/p-concourse/).
* 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)](https://network.pivotal.io/products/stemcells-ubuntu-xenial/).
* PostgreSQL v9.5 and later.
<p class="note warning"><strong>Warning: </strong>If you are using PostgreSQL v11.1 or v11.2, set
<code>max_parallel_workers_per_gather</code> to <code>0</code>. This corrects a PostgreSQL infinite parallel
query issue.</p>
* A load balancer with multiple Air Traffic Controllers (ATCs), if you expect a heavy load on your Concourse installation.
## Set Up and Install Concourse
To configure and deploy Concourse for PCF, do the following:
1. Modify the `cloud-config.yml` file according to your IaaS environment.
For information, see [Usage](https://bosh.io/docs/cloud-config/)
in the BOSH documentation.
1. 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](https://github.com/concourse/concourse-bosh-deployment/blob/master/cluster/concourse.yml) file in GitHub.
For more information about `Cluster Concourse deployment`, see
[concourse-bosh-deployment](https://github.com/concourse/concourse-bosh-deployment/blob/master/cluster/README.md) in GitHub.
1. Configure authentication in your deployment manifest by providing `tls_cert` and `tls_key` values.
For instructions, see [Configuring Local Users](./authenticating/local-auth.html).
1. Prepare the `cloud-config.yml` file and upload it to your BOSH Director with `bosh update-cloud-config`.
1. Deploy Concourse with `bosh deploy`. For more information,
see [Deploying](https://bosh.io/docs/deploying/) in the BOSH documentation.
After Concourse deploys, a success message is displayed.
1. Configure Concourse to connect it to an external PostgreSQL database or a BOSH-managed Cloud Foundry PostgreSQL release.
For more information, see [postgres/37](http://bosh.io/releases/github.com/cloudfoundry/postgres-release)
in the BOSH documentation.
1. Configure the <code>postgresql</code> properties of the ATC job for your database.
For a list of these properties, see
<a href="https://bosh.io/jobs/web?source=github.com/concourse/concourse-bosh-release&version=5.2.0#p%3dpostgresql">postgresql</a>
in the BOSH documentation.
For more information about using the Concourse BOSH release, see the
<a href="https://github.com/concourse/concourse-bosh-deployment">Concourse BOSH Deployment</a>
GitHub repository.
It includes sample manifest files, references to prerequisite BOSH knowledge, IaaS-specific configurations,
and more. -->