Skip to content

dns job from dns/0.0.1

Github source: b7c10ce or master branch

Properties

address

Address in which the DNS server will bind

Default
169.254.0.2

alias_files_glob

Glob for any files to look for DNS alias information

Default
/var/vcap/jobs/*/dns/aliases.json

aliased_address

Address that will be added by default

Default
169.254.0.2

aliases

Hash of domain key to target domains array for aliased DNS lookups

Example
cc.cf.consul:
- one
- two
- '...'
third.internal:
- four

health

ca_tls_cert

Root CA for the health service.

enabled

Enable healthchecks for DNS resolution

Default
false

server_port

Port to run healthchecks server on

Default
8080

server_tls_cert

The health daemon’s TLS cert.

server_tls_key

Private key for the health daemon’s TLS cert.

healthcheck_domains

Domain names that the dns server should respond to with successful answers. Answer ip will always be 127.0.0.1

Default
  - healthcheck.bosh-dns.
  - consul.service.cf.internal.

override_nameserver

Configure ourselves as the system nameserver (e.g. /etc/resolv.conf will be watched and overwritten)

Default
true

port

Port that the DNS server will bind to

Default
53

records_file

Path to the file containing information that the DNS server will use to create DNS records

Default
/var/vcap/instance/dns/records.json

recursor_timeout

A timeout value for when dialing, writing and reading from the configured recursors

Default
2s

recursors

Addresses of upstream DNS servers used for recursively resolving queries

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

  • bin/dns_ctl (from dns_ctl.erb)
  • bin/dns_healthcheck_ctl (from dns_healthcheck_ctl.erb)
  • bin/dns_resolvconf_ctl (from dns_resolvconf_ctl.erb)
  • bin/post-start (from post-start.erb)
  • config/certs/ca.pem (from ca.pem.erb)
  • config/certs/server.key (from server.key.erb)
  • config/certs/server.pem (from server.pem.erb)
  • config/config.json (from config.json.erb)
  • config/healthcheck_server_config.json (from healthcheck_server_config.json.erb)
  • dns/aliases.json (from aliases.json.erb)

Packages

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