Skip to content

groundcrew job from concourse/3.9.1

The ground crew registers a Garden worker with the ATC on an interval, advertises supported resource types, and cleans up ephemeral containers on shutdown.

Github source: 0ecf374 or master branch

Properties

additional_resource_types

Additional resource types supported by the workers in [{type: string, image: string}] format.

Default
[]

baggageclaim

url

Baggageclaim server URL to advertise directly to the TSA.

If not specified, either the baggageclaim link is used.

certs_path

A path to a directory on the instance to create the resource certificates volume from.

Default
/etc/ssl/certs

drain_timeout

Maximum wait time in Go duration format (1m = 1 minute) for worker drain to be finished. Only applies when worker is getting shutdown.

If not specified, it will be indefinite.

garden

address

Garden server connection address to advertise directly to the TSA.

If not specified, either the garden link is used, or the instance’s address is advertised if the link is not found.

http_proxy_url

Proxy to use for outgoing http requests from containers.

https_proxy_url

Proxy to use for outgoing https requests from containers.

no_proxy

A list domains and IPs with optional port for which the proxy should be bypassed, e.g. [localhost, 127.0.0.1, example.com, domain.com:8080]

Default
[]

platform

Platform to advertise for each worker.

Default
linux

tags

An array of tags to advertise for each worker.

Default
[]

team

Register the worker for a single team.

If not specified, the worker will be shared across all teams.

Default
""

tsa

host

IP or DNS address of the TSA server to register with.

If not specified, the tsa link is used.

host_public_key

Public key to verify for the TSA server. If not specified, the tsa link is used.

Example
ssh-rsa ...

port

Port of the TSA server to register with.

Only used when tsa.host is also specified. Otherwise the port is autodiscovered via the tsa link.

Default
2222

registration_mode

The registration ‘mode’ (direct, or forward), to use when registering the worker with the ATC. If “forward” is specified, the worker’s Baggageclaim and Garden address will be forwarded through SSH to the TSA.

If “direct” is specified, the worker will be registered directly without forwarding over SSH.

Default
direct

worker_key

SSH key to use when authenticating with the TSA.

Example
private_key: |+
  -----BEGIN RSA PRIVATE KEY-----
  ...
  -----END RSA PRIVATE KEY-----
public_key: ssh-rsa ...

yeller

api_key

API key to output errors from Concourse to Yeller.

Default
""

environment_name

Environment name you wish to group errors under in yeller.

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/groundcrew/ directory (learn more).

  • bin/beacon_ctl (from beacon_ctl.erb)
  • bin/drain (from drain.erb)
  • config/known_hosts (from known_hosts.erb)
  • config/tsa_host_key.pub (from tsa_host_key.pub.erb)
  • config/worker.json (from worker.json.erb)
  • config/worker_key (from worker_key.erb)

Packages

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