Skip to content

bosh-dns-windows job from bosh-dns/0.0.12

Github source: 86dfaf1 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
C:\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
- '...'
consul.internal:
- 127.0.0.1
third.internal:
- four

cache

enabled

When enabled bosh-dns will cache up to a max of 1000 recursed entries

Default
false

enable_os_dns_caching

allow the Windows dns caching service to remain in operation on this VM

Default
false

handlers

Array of handler configurations

Default
[]
Example
- cache:
    enabled: true
  domain: local.internal.
  source:
    type: http
    url: http://some.endpoint.local

handlers_files_glob

Glob for any files to look for DNS handler information

Default
C:\var\vcap\jobs\*\dns\handlers.json

health

client

tls

Client-side mutual TLS configuration for healthchecking

enabled

Enable healthchecks for DNS resolution

Default
false

max_tracked_queries

Maximum number of DNS resolved FQDNs to maintain live health info for

Default
2000

server

port

Port to run health server on

Default
8853
tls

Server-side mutual TLS configuration for healthchecking

override_nameserver

Configure ourselves as the system nameserver (e.g. network server addresses will be watched and overwritten)

Default
true

records_file

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

Default
C:\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
[]

upcheck_domains

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

Default
- upcheck.bosh-dns.

Templates

Templates are rendered and placed onto corresponding instances during the deployment process. This job's templates will be placed into /var/vcap/jobs/bosh-dns-windows/ directory (learn more).

  • bin/post-start.ps1 (from post-start.ps1.erb)
  • bin/pre-start.ps1 (from pre-start.ps1.erb)
  • config/certs/client.crt (from client.crt.erb)
  • config/certs/client.key (from client.key.erb)
  • config/certs/client_ca.crt (from client_ca.crt.erb)
  • config/certs/server.crt (from server.crt.erb)
  • config/certs/server.key (from server.key.erb)
  • config/certs/server_ca.crt (from server_ca.crt.erb)
  • config/config.json (from config.json.erb)
  • config/health_server_config.json (from health_server_config.json.erb)
  • dns/aliases.json (from aliases.json.erb)
  • dns/handlers.json (from handlers.json.erb)

Packages

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