Skip to content

groundcrew job from concourse/2.7.5

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: 9c15261 or master branch

Properties

additional_resource_types

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

Default
[]

baggageclaim

forward_address

Baggageclaim server connection address to forward through SSH to the TSA.

If not specified, the Baggageclaim server address is registered directly.

url

Baggageclaim server URL to advertise directly to the TSA.

If not specified, either the baggageclaim link is used.

certificates_path

Path to certificates on the worker VM. It will be bind-mounted into containers created on the worker.

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.

forward_address

Garden server connection address to forward through SSH to the TSA.

If not specified, the Garden server address is registered directly.

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

Host key to verify for the TSA server. If not specified, a deployment-scoped default is used.

Default
""

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

private_key

Private key to use when authenticating with the TSA.

If not specified, a deployment-scoped default is used.

Default
""

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/private_key (from private_key.erb)
  • config/static_known_hosts (from static_known_hosts.erb)
  • config/worker.json (from worker.json.erb)

Packages

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