Fixes #6273
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 toservice-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 theservice-splitter
(beta) andservice-router
(beta) config entries for a service. -
MeshGateway
(beta)(MeshGatewayConfig: <optional>)
- Controls the default mesh gateway configuration for this service.Mode
(string: "")
- One ofnone
,local
, orremote
.
-
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.