Skip to content

groundcrew job from concourse/0.69.0

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: 5bec8850 or master branch

Properties

blackbox

syslog

sources
garden

files whose contents blackbox will emit to its syslog drain

Default
  - /var/vcap/sys/log/garden/garden.stdout.log
  - /var/vcap/sys/log/garden/garden.stderr.log
  - /var/vcap/sys/log/monit/garden_ctl.log
  - /var/vcap/sys/log/monit/garden_ctl.err.log
groundcrew

files whose contents blackbox will emit to its syslog drain

Default
  - /var/vcap/sys/log/groundcrew/beacon.stdout.log
  - /var/vcap/sys/log/groundcrew/beacon.stderr.log
  - /var/vcap/sys/log/groundcrew/jettison.stdout.log
  - /var/vcap/sys/log/groundcrew/jettison.stderr.log
  - /var/vcap/sys/log/monit/beacon_ctl.out.log
  - /var/vcap/sys/log/monit/beacon_ctl.err.log
  - /var/vcap/sys/log/monit/jettison_ctl.out.log
  - /var/vcap/sys/log/monit/jettison_ctl.err.log

consul

agent

services
garden

this property auto-registers Garden as a service

Default
{}

groundcrew

additional_resource_types

additional resource types that will be merged into groundcrew.resource_types (the same format is used)

Default
[]

baggageclaim

forward_address

baggageclaim server connection address to forward through SSH to the TSA

url

baggageclaim server URL to advertise to the TSA

garden

address

garden server connection address to advertise to the TSA

forward_address

garden server connection address to forward through SSH to the TSA

platform

platform of the worker to advertise

Default
linux

resource_types

resource types supported by the worker, in [{type: type, image: image}] form

Default
  - image: /var/vcap/packages/archive_resource
    type: archive
  - image: /var/vcap/packages/cf_resource
    type: cf
  - image: /var/vcap/packages/docker_image_resource
    type: docker-image
  - image: /var/vcap/packages/git_resource
    type: git
  - image: /var/vcap/packages/s3_resource
    type: s3
  - image: /var/vcap/packages/semver_resource
    type: semver
  - image: /var/vcap/packages/time_resource
    type: time
  - image: /var/vcap/packages/tracker_resource
    type: tracker
  - image: /var/vcap/packages/pool_resource
    type: pool
  - image: /var/vcap/packages/vagrant_cloud_resource
    type: vagrant-cloud
  - image: /var/vcap/packages/github_release_resource
    type: github-release
  - image: /var/vcap/packages/bosh_io_release_resource
    type: bosh-io-release
  - image: /var/vcap/packages/bosh_io_stemcell_resource
    type: bosh-io-stemcell
  - image: /var/vcap/packages/bosh_deployment_resource
    type: bosh-deployment

tags

an array of tags to advertise for the worker

Default
[]

tsa

host

host of the TSA server to register with

Default
tsa.service.dc1.consul
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

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 from yeller 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/jettison_ctl (from jettison_ctl.erb)
  • config/known_hosts (from known_hosts.erb)
  • config/private_key (from private_key.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.