mirror of https://github.com/hashicorp/consul
docs: Clarify ingress gateway's -address flag (#10810)
Clarify the function of `-address` flag when instantiating an ingress gateway. Resolves #9849 Co-authored-by: trujillo-adam <47586768+trujillo-adam@users.noreply.github.com>pull/10954/head^2
parent
eb11e56ecc
commit
53d9df7824
|
@ -136,12 +136,25 @@ proxy configuration needed.
|
||||||
`-register`. This takes the form of `<ip address>:<port>` but also supports go-sockaddr
|
`-register`. This takes the form of `<ip address>:<port>` but also supports go-sockaddr
|
||||||
templates.
|
templates.
|
||||||
|
|
||||||
|
If Envoy is configured as a terminating or mesh gateway, traffic from services
|
||||||
|
within the mesh will be received at the specified IP and port.
|
||||||
|
|
||||||
|
If Envoy is configured as an ingress gateway, a `/ready` HTTP endpoint will be
|
||||||
|
instantiated at the specified IP and port. Consul uses `/ready` HTTP endpoints
|
||||||
|
to check gateway health. The specified IP will also be used by the ingress
|
||||||
|
gateway when instantiating user-defined listeners configured in the
|
||||||
|
[ingress gateway](/docs/connect/gateways/ingress-gateway) configuration entry.
|
||||||
|
|
||||||
|
~> **Note**: Ensure that user-defined ingress gateway listeners use a
|
||||||
|
different port than the port specified in `-address` so that they do not
|
||||||
|
conflict with the health check endpoint.
|
||||||
|
|
||||||
- `-admin-access-log-path` The path to write the access log for the administration
|
- `-admin-access-log-path` The path to write the access log for the administration
|
||||||
server. If no access log is desired specify `/dev/null`. By default it will
|
server. If no access log is desired specify `/dev/null`. By default it will
|
||||||
use `/dev/null`.
|
use `/dev/null`.
|
||||||
|
|
||||||
- `-bind-address` - The bind address to use instead of the default binding rules
|
- `-bind-address` - The bind address to use instead of the default binding rules.
|
||||||
given as `<name>=<ip>:<port>` pairs. This flag may be specified multiple times
|
Specified as `<name>=<ip>:<port>` pairs. This flag may be used multiple times
|
||||||
to add multiple bind addresses.
|
to add multiple bind addresses.
|
||||||
|
|
||||||
- `-expose-servers` - Expose the servers for WAN federation via this mesh
|
- `-expose-servers` - Expose the servers for WAN federation via this mesh
|
||||||
|
|
|
@ -784,7 +784,13 @@ spec:
|
||||||
{
|
{
|
||||||
name: 'Port',
|
name: 'Port',
|
||||||
type: 'int: 0',
|
type: 'int: 0',
|
||||||
description: 'The port that the listener should receive traffic on.',
|
description: `The port on which the ingress listener should receive
|
||||||
|
traffic. The port will be bound to the IP address that
|
||||||
|
was specified in the [\`-address\`](/commands/connect/envoy#address)
|
||||||
|
flag when starting the gateway.
|
||||||
|
<b>Note:</b> The ingress listener port must not conflict
|
||||||
|
with the health check port specified in the \`-address\`
|
||||||
|
flag.`,
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
name: 'Protocol',
|
name: 'Protocol',
|
||||||
|
@ -796,7 +802,7 @@ spec:
|
||||||
name: 'Services',
|
name: 'Services',
|
||||||
type: 'array<IngressService>: <optional>',
|
type: 'array<IngressService>: <optional>',
|
||||||
description:
|
description:
|
||||||
'A list of services to be exposed via this listener. For "tcp" listeners, only a single service is allowed.',
|
'A list of services to be exposed via this listener. For `tcp` listeners, only a single service is allowed.',
|
||||||
children: [
|
children: [
|
||||||
{
|
{
|
||||||
name: 'Name',
|
name: 'Name',
|
||||||
|
@ -805,7 +811,7 @@ spec:
|
||||||
through this listener. This can be either a service registered in the
|
through this listener. This can be either a service registered in the
|
||||||
catalog, or a service defined only by [other config entries](/docs/connect/l7-traffic-management). If the wildcard specifier,
|
catalog, or a service defined only by [other config entries](/docs/connect/l7-traffic-management). If the wildcard specifier,
|
||||||
\`*\`, is provided, then ALL services will be exposed through the listener.
|
\`*\`, is provided, then ALL services will be exposed through the listener.
|
||||||
This is not supported for listener's with protocol "tcp".`,
|
This is not supported for listener's with protocol \`tcp\`.`,
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
name: 'Namespace',
|
name: 'Namespace',
|
||||||
|
|
Loading…
Reference in New Issue