Skip to content

routing-api job from routing/0.151.0

Github source: 28e24f74 or master branch

Properties

consul

servers

comma-separated list of consul server URLs (scheme://ip:port)

Default
http://127.0.0.1:8500

dns_health_check_host

Host to ping for confirmation of DNS resolution

Default
consul.service.cf.internal

metron

port

The port used to emit dropsonde messages to the Metron agent.

Default
3457

routing_api

auth_disabled

Disables UAA authentication

Default
false

debug_address

Address at which to serve debug info

Default
127.0.0.1:17002

etcd

ca_cert

Certificate authority used to sign cert hosted by etcd

Default
""
client_cert

Client certificate for communication between clients and etcd

Default
""
client_key

Client key for communication between clients and etcd

Default
""
require_ssl

etcd requires client to communicate via TLS

Default
false
servers

When require_ssl:true, this must be an array of the internal DNS name for the etcd cluster. When require_ssl:false this must be an array of either the DNS name or the IP addresses of the etcd servers.

lock_retry_interval

interval to wait before retrying a failed lock acquisition

Default
5s

lock_ttl

TTL for service lock

Default
10s

locket

api_location

Hostname and port of the Locket server. Used to obtain a lock so only one instance of Routing API is active at a time. Requires Locket, which is not deployed with cf-release by default.

Default
""
ca_cert

CA cert for the Locket server. Requires Locket, which is not deployed with cf-release by default.

Default
""
client_cert

Client cert for the Locket server. Requires Locket, which is not deployed with cf-release by default.

Default
""
client_key

Client key for the Locket server. Requires Locket, which is not deployed with cf-release by default.

Default
""

log_level

Log level

Default
info

max_ttl

String representing the maximum TTL a client can request for route registration.

Default
120s

metrics_reporting_interval

String representing interval for reporting the following metrics: total_http_subscriptions, total_http_routes, total_tcp_subscriptions, total_tcp_routes, total_token_errors, key_refresh_events. Units: ms, s, m h

Default
30s

port

Port on which Routing API is running. If this is changed and routing_api.enabled:true in cf-release, it will break management of routes and domains until routing_api.port is updated in cf-release.

Default
3000

router_groups

Array of router groups that will be seeded into routing_api database. Once some value is included with a deploy, subsequent changes to this property will be ignored. TCP Routing requires a router group of type: tcp.

Default
[]
Example
|+
  - name: default-tcp
    reservable_ports: 1024-10000,12000
    type: tcp

skip_consul_lock

When false, Routing API will obtain a lock from both Consul and Locket. When true, Routing API will obtain the lock from Locket only. Requires locket.api_location to be set and Locket, which is not deployed with cf-release by default.

Default
false

sqldb

host

Host for SQL database

password

Password used for connecting to SQL database

port

Port on which SQL database is listening

schema

Database name for routing api

Example
routing_api
type

Type of SQL database

Example
mysql
username

Username used for connecting to SQL database

statsd_client_flush_interval

Buffered statsd client flush interval

Default
300ms

statsd_endpoint

The endpoint for the statsd server used to translate the following metrics from statsd to dropsonde: total_http_subscriptions, total_http_routes, total_tcp_subscriptions, total_tcp_routes, total_token_errors, key_refresh_events.

Default
localhost:8125

system_domain

Domain reserved for CF operator; base URL where the UAA, Cloud Controller, and other non-user apps listen

skip_ssl_validation

Skip TLS verification when talking to UAA

Default
false

uaa

ca_cert

Certificate authority for communication between clients and UAA.

Default
""

tls_port

Port on which UAA is listening for TLS connections. This is required for obtaining a key to verify client OAuth tokens.

token_endpoint

UAA token endpoint host name. Do not include a scheme in this value; TCP Router will always use TLS to connect to UAA.

Default
uaa.service.cf.internal

Templates

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

  • bin/dns_health_check (from dns_health_check.erb)
  • bin/pre-start (from pre-start)
  • bin/routing-api_ctl (from routing-api_ctl.erb)
  • config/certs/etcd/ca.crt (from etcd_ca.crt.erb)
  • config/certs/etcd/client.crt (from etcd_client.crt.erb)
  • config/certs/etcd/client.key (from etcd_client.key.erb)
  • config/certs/locket/ca.crt (from locket_ca.crt.erb)
  • config/certs/locket/client.crt (from locket_client.crt.erb)
  • config/certs/locket/client.key (from locket_client.key.erb)
  • config/certs/uaa/ca.crt (from uaa_ca.crt.erb)
  • config/routing-api.yml (from routing-api.yml.erb)

Packages

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