diff --git a/website/content/docs/connect/config-entries/service-resolver.mdx b/website/content/docs/connect/config-entries/service-resolver.mdx index dcea59805499..b4218d6d0614 100644 --- a/website/content/docs/connect/config-entries/service-resolver.mdx +++ b/website/content/docs/connect/config-entries/service-resolver.mdx @@ -35,12 +35,14 @@ The following list outlines field hierarchy, language-specific data types, and r - [`ServiceSubset`](#redirect-servicesubset): string - [`Namespace`](#redirect-namespace): string - [`Partition`](#redirect-partition): string | `default` + - [`SamenessGroup`](#redirect-samenessgroup): string - [`Datacenter`](#redirect-datacenter): list - [`Peer`](#redirect-peer): string - [`Failover`](#failover): map - [`Service`](#failover-service): string - [`ServiceSubset`](#failover-servicesubset): string - [`Namespace`](#failover-namespace): string + - [`SamenessGroup`](#failover-samenessgroup): string - [`Datacenters`](#failover-datacenters): list - [`Targets`](#failover-targets): list - [`Service`](#failover-targets-service): string @@ -87,12 +89,14 @@ The following list outlines field hierarchy, language-specific data types, and r - [`serviceSubset`](#spec-redirect-servicesubset): string - [`namespace`](#spec-redirect-namespace): string - [`partition`](#spec-redirect-partition): string + - [`samenessGroup`](#spec-redirect-samenessgroup): string - [`datacenter`](#spec-redirect-datacenter): string - [`peer`](#spec-redirect-peer): string - [`failover`](#spec-failover): map - [`service`](#spec-failover-service): string - [`serviceSubset`](#spec-failover-servicesubset): string - [`namespace`](#spec-failover-namespace): string + - [`samenessGroup`](#spec-failover-samenessgroup): string - [`datacenters`](#spec-failover-datacenters): string - [`targets`](#spec-failover-targets): list - [`service`](#spec-failover-targets-service): string @@ -157,11 +161,12 @@ Redirect = { ServiceSubset = "" Namespace = "" Partition = "" + SamenessGroup = "" Datacenter = "" Peer = "" } -Failover = { ## requires at least one of the following: Service, ServiceSubset, Namespace, Targets, Datacenters +Failover = { ## requires at least one of the following: Service, ServiceSubset, Namespace, Targets, Datacenters, SamenessGroup = { Targets = [ { Service = "" }, @@ -239,11 +244,12 @@ LoadBalancer = { "ServiceSubset":"", "Namespace":"", "Partition":"", + "SamenessGroup":"", "Datacenter":"", "Peer":"" }, - "Failover":{ // requires at least one of the following": Service, ServiceSubset, Namespace, Targets, Datacenters + "Failover":{ // requires at least one of the following": Service, ServiceSubset, Namespace, Targets, Datacenters, SamenessGroup "":{ "Targets":[ {"Service":""}, @@ -314,8 +320,9 @@ spec: servicesubset: namespace: partition: + samenessGroup: peer: - failover: # requires at least one of the following: service, serviceSubset, namespace, targets, datacenters + failover: # requires at least one of the following: service, serviceSubset, namespace, targets, datacenters, samenessGroup : targets: - service: @@ -465,6 +472,7 @@ Specifies redirect instructions for local service traffic so that services deplo - [`ServiceSubset`](#redirect-servicesubset) - [`Namespace`](#redirect-namespace) - [`Partition`](#redirect-partition) + - [`SamenessGroup`](#redirect-samenessgroup) - [`Datacenter`](#redirect-datacenter) - [`Peer`](#redirect-peer) @@ -504,6 +512,14 @@ Specifies the admin partition at the redirect’s destination that resolves loca - Default: None - Data type: String +### `Redirect{}.SamenessGroup` + +Specifies the sameness group at the redirect’s destination that resolves local upstream requests. + +#### Values + +- Default: None +- Data type: String ### `Redirect{}.Datacenter` @@ -529,7 +545,7 @@ Specifies controls for rerouting traffic to an alternate pool of service instanc This parameter is a map, and its key is the name of the local service subset that resolves to another location when it fails. You can specify a `"*"` wildcard to apply failovers to any subset. -`Service`, `ServiceSubset`, `Namespace`, `Targets`, and `Datacenters` cannot all be empty at the same time. +`Service`, `ServiceSubset`, `Namespace`, `Targets`, `SamenessGroup`, and `Datacenters` cannot all be empty at the same time. #### Values @@ -538,6 +554,7 @@ This parameter is a map, and its key is the name of the local service subset tha - [`Service`](#failover-service) - [`ServiceSubset`](#failover-servicesubset) - [`Namespace`](#failover-namespace) + - [`SamenessGroup`](#failover-samenessgroup) - [`Datacenters`](#failover-datacenters) - [`Targets`](#failover-targets) @@ -568,6 +585,15 @@ Specifies the namespace at the failover location where the failover services are - Default: None - Data type: String +### `Failover{}.SamenessGroup` + +Specifies the sameness group at the failover location where the failover services are deployed. + +#### Values + +- Default: None +- Data type: String + ### `Failover{}.Datacenters` Specifies an ordered list of datacenters at the failover location to attempt connections to during a failover scenario. When Consul cannot establish a connection with the first datacenter in the list, it proceeds sequentially until establishing a connection with another datacenter. @@ -907,6 +933,7 @@ Specifies redirect instructions for local service traffic so that services deplo - [`serviceSubset`](#spec-redirect-servicesubset) - [`namespace`](#spec-redirect-namespace) - [`partition`](#spec-redirect-partition) + - [`samenessGroup`](#spec-redirect-samenessgroup) - [`datacenter`](#spec-redirect-datacenter) - [`peer`](#spec-redirect-peer) @@ -946,6 +973,15 @@ Specifies the admin partition at the redirect’s destination that resolves loca - Default: None - Data type: String +### `spec.redirect.samenessGroup` + +Specifies the sameness group at the redirect’s destination that resolves local upstream requests. + +#### Values + +- Default: None +- Data type: String + ### `spec.redirect.datacenter` @@ -971,7 +1007,7 @@ Specifies controls for rerouting traffic to an alternate pool of service instanc This parameter is a map, and its key is the name of the local service subset that resolves to another location when it fails. You can specify a `"*"` wildcard to apply failovers to any subset. -`service`, `serviceSubset`, `namespace`, `targets`, and `datacenters` cannot all be empty at the same time. +`service`, `serviceSubset`, `namespace`, `targets`, `samenessGroup`, and `datacenters` cannot all be empty at the same time. #### Values @@ -980,6 +1016,7 @@ This parameter is a map, and its key is the name of the local service subset tha - [`service`](#spec-failover-service) - [`serviceSubset`](#spec-failover-servicesubset) - [`namespace`](#spec-failover-namespace) + - [`samenessGroup`](#spec-failover-samenessgroup) - [`datacenters`](#spec-failover-datacenters) - [`targets`](#spec-failover-targets) @@ -1010,6 +1047,15 @@ Specifies the namespace at the failover location where the failover services are - Default: None - Data type: String +### `spec.failover.samenessGroup` + +Specifies the sameness group at the failover location where the failover services are deployed. + +#### Values + +- Default: None +- Data type: String + ### `spec.failover.datacenters` Specifies an ordered list of datacenters at the failover location to attempt connections to during a failover scenario. When Consul cannot establish a connection with the first datacenter in the list, it proceeds sequentially until establishing a connection with another datacenter.