atc job from concourse/0.72.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:
483f8594
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.
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
(fromatc_ctl.erb
)
Packages¶
Packages are compiled and placed onto corresponding
instances during the deployment process. Packages will be
placed into /var/vcap/packages/
directory.