open-consul/website/source/docs/agent/config-entries/service-defaults.html.md
2019-08-21 12:29:53 -05:00

1.9 KiB

layout page_title sidebar_current description
docs Configuration Entry Kind: Service Defaults docs-agent-cfg_entries-service_defaults The service-defaults config entry kind controls default global values for a service, such as its protocol.

Service Defaults

The service-defaults config entry kind controls default global values for a service, such as its protocol.

Sample Config Entries

Set the default protocol for a service to HTTP:

Kind = "service-defaults"
Name = "web"
Protocol = "http"

Available Fields

  • Kind - Must be set to service-defaults

  • Name (string: <required>) - Set to the name of the service being configured.

  • Protocol (string: "tcp") - Sets the protocol of the service. This is used by Connect proxies for things like observability features and to unlock usage of the service-splitter (beta) and service-router (beta) config entries for a service.

  • MeshGateway (beta) (MeshGatewayConfig: <optional>) - Controls the default mesh gateway configuration for this service.

    • Mode (string: "") - One of none, local, or remote.
  • ExternalSNI (beta) (string: "") - This is an optional setting that allows for the TLS SNI value to be changed to a non-connect value when federating with an external system.

ACLs

Configuration entries may be protected by ACLs.

Reading a service-defaults config entry requires service:read on itself.

Creating, updating, or deleting a service-defaults config entry requires service:write on itself.