Skip to content

atc job from concourse/0.71.0

The ATC (Air Traffic Controller) provides UI and API access. It is responsible for scheduling builds and detecting versions of your resources.

Github source: c24fc6e2 or master branch

Properties

atc

basic_auth_password

Password for HTTP basic auth, in plaintext.

Default
""

basic_auth_username

Username for HTTP basic auth.

Default
""

default_check_interval

The interval, in Go duration format (1m = 1 minute), on which to check for new versions of resources.

This can also be specified on a per-resource basis by specifying check_every on the resource config.

Default
1m

development_mode

Loosen up security for development purposes. This allows the ATC to be configured with no authentication methods.

Default
false

external_url

Externally reachable URL of the ATCs. Required for OAuth.

Typically this is the URL that you as a user would use to reach your CI. For multiple ATCs it would go to some sort of load balancer.

Default
""

github_auth

authorize

An array of different criteria to check for when authorizing a GitHub user. If empty, GitHub authorization is effectively disabled.

Default
[]
Example
- organization: org1
  teams: all
- organization: org2
  teams:
  - Team 1
  - Team 2
- user: user1
- user: user2
client_id

GitHub client ID to use for OAuth.

The application must be configured with its callback URL as {atc.external_url}/auth/github/callback (replacing {atc.external_url} with the actual value).

Default
""
client_secret

GitHub client secret to use for OAuth.

The application must be configured with its callback URL as {atc.external_url}/auth/github/callback (replacing {atc.external_url} with the actual value).

Default
""

old_resource_grace_period

How long to cache the result of a get step after a newer version of the resource is found. Use Go duration format (1m = 1 minute).

Default
5m

peer_url

Address used internally to reach the ATC. This will be auto-generated using the IP of each ATC VM if not specified.

Note that this refers to an individual ATC, not the whole cluster. This property is only useful if you’re deploying in a way that cannot autodetect its own IP, e.g. a bosh-init deployment.

You should otherwise leave this value blank.

postgresql

address

Address of the PostgreSQL server, in HOST:PORT format.

Default
postgresql.service.dc1.consul:5432
database

Name of the database to use.

Default
atc
role
name

Name of role to connect with.

Default
atc
password

password to use when connecting.

publicly_viewable

Allow viewing of pipelines as an anonymous user. Destructive operations still require auth, and the output of builds will only be visible if their job is configured with public: true.

This is useful for open-source projects, or as a convenience to make monitoring your pipeline status easier.

Default
false

resource_cache_cleanup_interval

The interval, in Go duration format (1m = 1 minute), on which to check for and release old caches of resource versions.

Default
30s

riemann

host

If configured, detailed metrics will be emitted to the specified Riemann server.

Default
""
port

Port of the Riemann server to emit events to.

Default
5555

web_bind_ip

IP address for the web server to listen on.

Default
0.0.0.0

web_bind_port

Port for the web server to listen on.

Default
8080

yeller

api_key

If configured, errors emitted to the logs will also be emitted to Yeller. This is only really useful for Concourse developers.

Default
""
environment_name

Environment name to specify for errors emitted to Yeller.

Default
""

blackbox

syslog

sources
atc

This property auto-configures blackbox to emit ATC’s logs to its syslog drain. You shouldn’t need to touch it.

Default
  - /var/vcap/sys/log/atc/atc.stdout.log
  - /var/vcap/sys/log/atc/atc.stderr.log
  - /var/vcap/sys/log/monit/atc_ctl.out.log
  - /var/vcap/sys/log/monit/atc_ctl.err.log

consul

agent

services
atc

This property auto-configured consul-agent to register the ATC as a service. You shouldn’t need to touch it.

Default
{}

Templates

Templates are rendered and placed onto corresponding instances during the deployment process. This job's templates will be placed into /var/vcap/jobs/atc/ directory (learn more).

  • bin/atc_ctl (from atc_ctl.erb)

Packages

Packages are compiled and placed onto corresponding instances during the deployment process. Packages will be placed into /var/vcap/packages/ directory.