github.com/projectcontour/contour@v1.28.2/site/content/docs/v1.15.0/configuration.md (about)

     1  # Contour Configuration Reference
     2  
     3  - [Serve Flags](#serve-flags)
     4  - [Configuration File](#configuration-file)
     5  - [Environment Variables](#environment-variables)
     6  - [Bootstrap Config File](#bootstrap-config-file)
     7  
     8  ## Overview
     9  
    10  There are various ways to configure Contour, flags, the configuration file, as well as environment variables.
    11  Contour has a precedence of configuration for contour serve, meaning anything configured in the config file is overridden by environment vars which are overridden by cli flags.
    12  
    13  ## Serve Flags
    14  
    15  The `contour serve` command is the main command which is used to watch for Kubernetes resource and process them into Envoy configuration which is then streamed to any Envoy via its xDS gRPC connection.
    16  There are a number of flags that can be passed to this command which further configures how Contour operates. 
    17  Many of these flags are mirrored in the [Contour Configuration File](#configuration-file).
    18  
    19  | Flag Name         | Description        |
    20  |-------------------|--------------------|
    21  | `--config-path`       | Path to base configuration |
    22  | `--incluster`         | Use in cluster configuration |
    23  | `--kubeconfig=</path/to/file>` |    Path to kubeconfig (if not in running inside a cluster) |
    24  | `--xds-address=<ipaddr>` | xDS gRPC API address |
    25  | `--xds-port=<port>`       | xDS gRPC API port |
    26  | `--stats-address=<ipaddr>` | Envoy /stats interface address |
    27  | `--stats-port=<port>`  |  Envoy /stats interface port |
    28  | `--debug-http-address=<address>` | Address the debug http endpoint will bind to. |
    29  | `--debug-http-port=<port>`  | Port the debug http endpoint will bind to |
    30  | `--http-address=<ipaddr>`  | Address the metrics HTTP endpoint will bind to |
    31  | `--http-port=<port>`  |    Port the metrics HTTP endpoint will bind to. |
    32  | `--health-address=<ipaddr>` |   Address the health HTTP endpoint will bind to |
    33  | `--health-port=<port>` | Port the health HTTP endpoint will bind to |
    34  | `--contour-cafile=</path/to/file\|CONTOUR_CERT_FILE>` | CA bundle file name for serving gRPC with TLS |
    35  | `--contour-cert-file=</path/to/file\|CONTOUR_CERT_FILE>`  | Contour certificate file name for serving gRPC over TLS |
    36  | `--contour-key-file=</path/to/file\|CONTOUR_KEY_FILE>` | Contour key file name for serving gRPC over TLS |
    37  | `--insecure`  |               Allow serving without TLS secured gRPC |
    38  | `--root-namespaces=<ns,ns>` | Restrict contour to searching these namespaces for root ingress routes |
    39  | `--ingress-class-name=<name>` | Contour IngressClass name |
    40  | `--ingress-status-address=<address>`  | Address to set in Ingress object status |
    41  | `--envoy-http-access-log=</path/to/file>`  | Envoy HTTP access log |
    42  | `--envoy-https-access-log=</path/to/file>`  | Envoy HTTPS access log |
    43  | `--envoy-service-http-address=<ipaddr>`  | Kubernetes Service address for HTTP requests |
    44  | `--envoy-service-https-address=<ipaddr>` | Kubernetes Service address for HTTPS requests |
    45  | `--envoy-service-http-port=<port>` | Kubernetes Service port for HTTP requests |
    46  | `--envoy-service-https-port=<port>` |  Kubernetes Service port for HTTPS requests |
    47  | `--envoy-service-name=<name>` | Name of the Envoy service to inspect for Ingress status details. |
    48  | `--envoy-service-namespace=<namespace>` | Envoy Service Namespace  |
    49  | `--use-proxy-protocol`  |     Use PROXY protocol for all listeners |
    50  | `--accesslog-format=<envoy\|json>` | Format for Envoy access logs |
    51  | `--disable-leader-election` | Disable leader election mechanism |
    52  | `-d, --debug`   |                  Enable debug logging |
    53  | `--kubernetes-debug=<log level>`  | Enable Kubernetes client debug logging |
    54  | `--experimental-service-apis` | DEPRECATED: Please configure the gateway.name & gateway.namespace in the configuration file. | 
    55  
    56  
    57  ## Configuration File
    58  
    59  A configuration file can be passed to the `--config-path` argument of the `contour serve` command to specify additional configuration to Contour.
    60  In most deployments, this file is passed to Contour via a ConfigMap which is mounted as a volume to the Contour pod.
    61  
    62  The Contour configuration file is optional.
    63  In its absence, Contour will operate with reasonable defaults.
    64  Where Contour settings can also be specified with command-line flags, the command-line value takes precedence over the configuration file.
    65  
    66  | Field Name | Type | Default | Description |
    67  |------------|------|---------|-------------|
    68  | accesslog-format | string | `envoy` | This key sets the global [access log format][2] for Envoy. Valid options are `envoy` or `json`. |
    69  | debug | boolean | `false` | Enables debug logging. |
    70  | default-http-versions | string array | <code style="white-space:nowrap">HTTP/1.1</code> <br> <code style="white-space:nowrap">HTTP/2</code> | This array specifies the HTTP versions that Contour should program Envoy to serve. HTTP versions are specified as strings of the form "HTTP/x", where "x" represents the version number. |
    71  | disableAllowChunkedLength | boolean | `false` | If this field is true, Contour will disable the RFC-compliant Envoy behavior to strip the `Content-Length` header if `Transfer-Encoding: chunked` is also set. This is an emergency off-switch to revert back to Envoy's default behavior in case of failures. |
    72  | disablePermitInsecure | boolean | `false` | If this field is true, Contour will ignore `PermitInsecure` field in HTTPProxy documents. |
    73  | envoy-service-name | string | `envoy` | This sets the service name that will be inspected for address details to be applied to Ingress objects. |
    74  | envoy-service-namespace | string | `projectcontour` | This sets the namespace of the service that will be inspected for address details to be applied to Ingress objects. If the `CONTOUR_NAMESPACE` environment variable is present, Contour will populate this field with its value. |
    75  | ingress-status-address | string | None | If present, this specifies the address that will be copied into the Ingress status for each Ingress that Contour manages. It is exclusive with `envoy-service-name` and `envoy-service-namespace`.|
    76  | incluster | boolean | `false` | This field specifies that Contour is running in a Kubernetes cluster and should use the in-cluster client access configuration.  |
    77  | json-fields | string array | [fields][5]| This is the list the field names to include in the JSON [access log format][2]. |
    78  | kubeconfig | string | `$HOME/.kube/config` | Path to a Kubernetes [kubeconfig file][3] for when Contour is executed outside a cluster. |
    79  | leaderelection | leaderelection | | The [leader election configuration](#leader-election-configuration). |
    80  | policy | PolicyConfig | | The default [policy configuration](#policy-configuration). |
    81  | tls | TLS | | The default [TLS configuration](#tls-configuration). |
    82  | timeouts | TimeoutConfig | | The [timeout configuration](#timeout-configuration). |
    83  | cluster | ClusterConfig | | The [cluster configuration](#cluster-configuration). |
    84  | network | NetworkConfig | | The [network configuration](#network-configuration). |
    85  | listener | ListenerConfig | | The [listener configuration](#listener-configuration). |
    86  | server | ServerConfig |  | The [server configuration](#server-configuration) for `contour serve` command. |
    87  | gateway | GatewayConfig |  | The [gateway-api Gateway configuration](#gateway-configuration). |
    88  | rateLimitService | RateLimitServiceConfig | | The [rate limit service configuration](#rate-limit-service-configuration). |
    89  
    90  
    91  ### TLS Configuration
    92  
    93  The TLS configuration block can be used to configure default values for how
    94  Contour should provision TLS hosts.
    95  
    96  | Field Name | Type| Default  | Description |
    97  |------------|-----|----------|-------------|
    98  | minimum-protocol-version| string | `1.2` | This field specifies the minimum TLS protocol version that is allowed. Valid options are `1.2` (default) and `1.3`. Any other value defaults to TLS 1.2. |
    99  | fallback-certificate | | | [Fallback certificate configuration](#fallback-certificate). |
   100  | envoy-client-certificate | | | [Client certificate configuration for Envoy](#envoy-client-certificate). |
   101  | cipher-suites | []string | See [config package documentation](https://pkg.go.dev/github.com/projectcontour/contour/pkg/config#pkg-variables) | This field specifies the TLS ciphers to be supported by TLS listeners when negotiating TLS 1.2. This parameter should only be used by advanced users. Note that this is ignored when TLS 1.3 is in use. The set of ciphers that are allowed is a superset of those supported by default in stock, non-FIPS Envoy builds and FIPS builds as specified [here](https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/transport_sockets/tls/v3/common.proto#envoy-v3-api-field-extensions-transport-sockets-tls-v3-tlsparameters-cipher-suites). Custom ciphers not accepted by Envoy in a standard build are not supported. |
   102  
   103  
   104  ### Fallback Certificate
   105  
   106  | Field Name | Type| Default  | Description |
   107  |------------|-----|----------|-------------|
   108  | name       | string | `""` | This field specifies the name of the Kubernetes secret to use as the fallback certificate.      |
   109  | namespace  | string | `""` | This field specifies the namespace of the Kubernetes secret to use as the fallback certificate. |
   110  
   111  
   112  ### Envoy Client Certificate
   113  
   114  | Field Name | Type| Default  | Description |
   115  |------------|-----|----------|-------------|
   116  | name       | string | `""` | This field specifies the name of the Kubernetes secret to use as the client certificate and private key when establishing TLS connections to the backend service. |
   117  | namespace  | string | `""` | This field specifies the namespace of the Kubernetes secret to use as the client certificate and private key when establishing TLS connections to the backend service. |
   118  
   119  
   120  ### Leader Election Configuration
   121  
   122  The leader election configuration block configures how a deployment with more than one Contour pod elects a leader.
   123  The Contour leader is responsible for updating the status field on Ingress and HTTPProxy documents.
   124  In the vast majority of deployments, only the `configmap-name` and `configmap-namespace` fields should require any configuration.
   125  
   126  | Field Name | Type | Default | Description |
   127  |------------|------|---------|-------------|
   128  | configmap-name | string | `leader-elect` | The name of the ConfigMap that Contour leader election will lease. |
   129  | configmap-namespace | string | `projectcontour` | The namespace of the ConfigMap that Contour leader election will lease. If the `CONTOUR_NAMESPACE` environment variable is present, Contour will populate this field with its value. |
   130  | lease-duration | [duration][4] | `15s` | The duration of the leadership lease. |
   131  | renew-deadline | [duration][4] | `10s` | The length of time that the leader will retry refreshing leadership before giving up. |
   132  | retry-period | [duration][4] | `2s` | The interval at which Contour will attempt to the acquire leadership lease. |
   133  
   134  
   135  ### Timeout Configuration
   136  
   137  The timeout configuration block can be used to configure various timeouts for the proxies. All fields are optional; Contour/Envoy defaults apply if a field is not specified.
   138  
   139  | Field Name | Type| Default  | Description |
   140  |------------|-----|----------|-------------|
   141  | request-timeout | string | none* | This field specifies the default request timeout. Note that this is a timeout for the entire request, not an idle timeout. Must be a [valid Go duration string][4], or omitted or set to `infinity` to disable the timeout entirely. See [the Envoy documentation][12] for more information.<br /><br />_Note: A value of `0s` previously disabled this timeout entirely. This is no longer the case. Use `infinity` or omit this field to disable the timeout._  |
   142  | connection-idle-timeout| string | `60s` | This field defines how long the proxy should wait while there are no active requests (for HTTP/1.1) or streams (for HTTP/2) before terminating an HTTP connection. Must be a [valid Go duration string][4], or `infinity` to disable the timeout entirely. See [the Envoy documentation][8] for more information. |
   143  | stream-idle-timeout| string | `5m`* |This field defines how long the proxy should wait while there is no request activity (for HTTP/1.1) or stream activity (for HTTP/2) before terminating the HTTP request or stream. Must be a [valid Go duration string][4], or `infinity` to disable the timeout entirely. See [the Envoy documentation][9] for more information. |
   144  | max-connection-duration | string | none* | This field defines the maximum period of time after an HTTP connection has been established from the client to the proxy before it is closed by the proxy, regardless of whether there has been activity or not. Must be a [valid Go duration string][4], or omitted or set to `infinity` for no max duration. See [the Envoy documentation][10] for more information. |
   145  | delayed-close-timeout | string | `1s`* | *Note: this is an advanced setting that should not normally need to be tuned.* <br /><br /> This field defines how long envoy will wait, once connection close processing has been initiated, for the downstream peer to close the connection before Envoy closes the socket associated with the connection. Setting this timeout to 'infinity' will disable it.  See [the Envoy documentation][13] for more information. |
   146  | connection-shutdown-grace-period | string | `5s`* | This field defines how long the proxy will wait between sending an initial GOAWAY frame and a second, final GOAWAY frame when terminating an HTTP/2 connection. During this grace period, the proxy will continue to respond to new streams. After the final GOAWAY frame has been sent, the proxy will refuse new streams. Must be a [valid Go duration string][4]. See [the Envoy documentation][11] for more information. |
   147  
   148  _* This is Envoy's default setting value and is not explicitly configured by Contour._
   149  
   150  ### Cluster Configuration
   151  
   152  The cluster configuration block can be used to configure various parameters for Envoy clusters.
   153  
   154  | Field Name | Type| Default  | Description |
   155  |------------|-----|----------|-------------|
   156  | dns-lookup-family | string | auto | This field specifies the dns-lookup-family to use for upstream requests to externalName type Kubernetes services from an HTTPProxy route. Values are: `auto`, `v4, `v6` |
   157  
   158  
   159  ### Network Configuration
   160  
   161  The network configuration block can be used to configure various parameters network connections.
   162  
   163  | Field Name | Type| Default  | Description |
   164  |------------|-----|----------|-------------|
   165  | num-trusted-hops | int | 0 | Configures the number of additional ingress proxy hops from the right side of the x-forwarded-for HTTP header to trust. |
   166  
   167  
   168  ### Listener Configuration
   169  
   170  The listener configuration block can be used to configure various parameters for Envoy listener.
   171  
   172  | Field Name | Type| Default  | Description |
   173  |------------|-----|----------|-------------|
   174  | connection-balancer | string | `""` | This field specifies the listener connection balancer. If the value is `exact`, the listener will use the exact connection balancer to balance connections between threads in a single Envoy process. See [the Envoy documentation][14] for more information. |
   175  
   176  
   177  ### Server Configuration
   178  
   179  The server configuration block can be used to configure various settings for the `contour serve` command.
   180  
   181  | Field Name | Type| Default  | Description |
   182  |------------|-----|----------|-------------|
   183  | xds-server-type | string | contour | This field specifies the xDS Server to use. Options are `contour` or `envoy`.  |
   184  
   185  
   186  ### Gateway Configuration
   187  
   188  The gateway configuration block is used to configure which gateway-api Gateway Contour should configure:
   189  
   190  | Field Name | Type| Default  | Description |
   191  |------------|-----|----------|-------------|
   192  | name | string | contour | This field specifies the name of a Gateway.  |
   193  | namespace | string | projectcontour | This field specifies the namespace of a Gateway.  |
   194  
   195  ### Policy Configuration
   196  
   197  The Policy configuration block can be used to configure default policy values
   198  that are set if not overridden by the user.
   199  
   200  The `request-headers` field is used to rewrite headers on a HTTP request, and
   201  the `response-headers` field is used to rewrite headers on a HTTP response.
   202  
   203  | Field Name | Type| Default  | Description |
   204  |------------|-----|----------|-------------|
   205  | request-headers | HeaderPolicy | none | The default request headers set or removed on all service routes if not overridden in the object |
   206  | response-headers | HeaderPolicy | none | The default response headers set or removed on all service routes if not overridden in the object |
   207  
   208  
   209  #### HeaderPolicy
   210  
   211  The `set` field sets an HTTP header value, creating it if it doesn't already exist but not overwriting it if it does.
   212  The `remove` field removes an HTTP header.
   213  
   214  | Field Name | Type| Default  | Description |
   215  |------------|-----|----------|-------------|
   216  | set | map[string]string | none | Map of headers to set on all service routes if not overridden in the object |
   217  | remove | []string | none | List of headers to remove on all service routes if not overridden in the object |
   218  
   219  Note: the values of entries in the `set` and `remove` fields can be overridden in HTTPProxy objects but it it not possible to remove these entries.
   220  
   221  
   222  ### Rate Limit Service Configuration
   223  
   224  The rate limit service configuration block is used to configure an optional global rate limit service:
   225  
   226  | Field Name | Type| Default  | Description |
   227  |------------|-----|----------|-------------|
   228  | extensionService | string | <none> | This field identifies the extension service defining the rate limit service, formatted as <namespace>/<name>.  |
   229  | domain | string | contour | This field defines the rate limit domain value to pass to the rate limit service. Acts as a container for a set of rate limit definitions within the RLS.  |
   230  | failOpen | bool | false | This field defines whether to allow requests to proceed when the rate limit service fails to respond with a valid rate limit decision within the timeout defined on the extension service.  |
   231  | enableXRateLimitHeaders | bool | false | This field defines whether to include the X-RateLimit headers X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (as defined by the IETF Internet-Draft https://tools.ietf.org/id/draft-polli-ratelimit-headers-03.html), on responses to clients when the Rate Limit Service is consulted for a request. |
   232  
   233  
   234  ### Configuration Example
   235  
   236  The following is an example ConfigMap with configuration file included:
   237  
   238  ```yaml
   239  apiVersion: v1
   240  kind: ConfigMap
   241  metadata:
   242    name: contour
   243    namespace: projectcontour
   244  data:
   245    contour.yaml: |
   246      #
   247      # server:
   248      #   determine which XDS Server implementation to utilize in Contour.
   249      #   xds-server-type: contour
   250      #
   251      # specify the gateway-api Gateway Contour should configure
   252      # gateway:
   253      #   name: contour
   254      #   namespace: projectcontour
   255      #
   256      # should contour expect to be running inside a k8s cluster
   257      # incluster: true
   258      #
   259      # path to kubeconfig (if not running inside a k8s cluster)
   260      # kubeconfig: /path/to/.kube/config
   261      #
   262      # Disable RFC-compliant behavior to strip "Content-Length" header if
   263      # "Tranfer-Encoding: chunked" is also set.
   264      # disableAllowChunkedLength: false
   265      # Disable HTTPProxy permitInsecure field
   266      disablePermitInsecure: false
   267      tls:
   268      # minimum TLS version that Contour will negotiate
   269      # minimum-protocol-version: "1.2"
   270      # TLS ciphers to be supported by Envoy TLS listeners when negotiating
   271      # TLS 1.2.
   272      # cipher-suites:
   273      # - '[ECDHE-ECDSA-AES128-GCM-SHA256|ECDHE-ECDSA-CHACHA20-POLY1305]'
   274      # - '[ECDHE-RSA-AES128-GCM-SHA256|ECDHE-RSA-CHACHA20-POLY1305]'
   275      # - 'ECDHE-ECDSA-AES256-GCM-SHA384'
   276      # - 'ECDHE-RSA-AES256-GCM-SHA384'
   277      # Defines the Kubernetes name/namespace matching a secret to use
   278      # as the fallback certificate when requests which don't match the
   279      # SNI defined for a vhost.
   280        fallback-certificate:
   281      #   name: fallback-secret-name
   282      #   namespace: projectcontour
   283        envoy-client-certificate:
   284      #   name: envoy-client-cert-secret-name
   285      #   namespace: projectcontour
   286      # The following config shows the defaults for the leader election.
   287      # leaderelection:
   288      #   configmap-name: leader-elect
   289      #   configmap-namespace: projectcontour
   290      ### Logging options
   291      # Default setting
   292      accesslog-format: envoy
   293      # To enable JSON logging in Envoy
   294      # accesslog-format: json
   295      # The default fields that will be logged are specified below.
   296      # To customise this list, just add or remove entries.
   297      # The canonical list is available at
   298      # https://godoc.org/github.com/projectcontour/contour/internal/envoy#JSONFields
   299      # json-fields:
   300      #   - "@timestamp"
   301      #   - "authority"
   302      #   - "bytes_received"
   303      #   - "bytes_sent"
   304      #   - "downstream_local_address"
   305      #   - "downstream_remote_address"
   306      #   - "duration"
   307      #   - "method"
   308      #   - "path"
   309      #   - "protocol"
   310      #   - "request_id"
   311      #   - "requested_server_name"
   312      #   - "response_code"
   313      #   - "response_flags"
   314      #   - "uber_trace_id"
   315      #   - "upstream_cluster"
   316      #   - "upstream_host"
   317      #   - "upstream_local_address"
   318      #   - "upstream_service_time"
   319      #   - "user_agent"
   320      #   - "x_forwarded_for"
   321      #
   322      # default-http-versions:
   323      # - "HTTP/2"
   324      # - "HTTP/1.1"
   325      #
   326      # The following shows the default proxy timeout settings.
   327      # timeouts:
   328      #   request-timeout: infinity
   329      #   connection-idle-timeout: 60s
   330      #   stream-idle-timeout: 5m
   331      #   max-connection-duration: infinity
   332      #   connection-shutdown-grace-period: 5s
   333      #
   334      # Envoy cluster settings.
   335      # cluster:
   336      #   configure the cluster dns lookup family
   337      #   valid options are: auto (default), v4, v6
   338      #   dns-lookup-family: auto   
   339      #
   340      # network:
   341      #   Configure the number of additional ingress proxy hops from the
   342      #   right side of the x-forwarded-for HTTP header to trust.
   343      #   num-trusted-hops: 0
   344      #
   345      # Configure an optional global rate limit service.
   346      # rateLimitService:
   347      #   Identifies the extension service defining the rate limit service,
   348      #   formatted as <namespace>/<name>.
   349      #   extensionService: projectcontour/ratelimit
   350      #   Defines the rate limit domain to pass to the rate limit service.
   351      #   Acts as a container for a set of rate limit definitions within
   352      #   the RLS.
   353      #   domain: contour
   354      #   Defines whether to allow requests to proceed when the rate limit
   355      #   service fails to respond with a valid rate limit decision within
   356      #   the timeout defined on the extension service.
   357      #   failOpen: false
   358      # Defines whether to include the X-RateLimit headers X-RateLimit-Limit,
   359      # X-RateLimit-Remaining, and X-RateLimit-Reset (as defined by the IETF
   360      # Internet-Draft linked below), on responses to clients when the Rate
   361      # Limit Service is consulted for a request.
   362      # ref. https://tools.ietf.org/id/draft-polli-ratelimit-headers-03.html
   363      #   enableXRateLimitHeaders: false
   364      #
   365      # Global Policy settings.
   366      # policy:
   367      #   # Default headers to set on all requests (unless set/removed on the HTTPProxy object itself)
   368      #   request-headers:
   369      #     set:
   370      #       # example: the hostname of the Envoy instance that proxied the request
   371      #       X-Envoy-Hostname: %HOSTNAME%
   372      #       # example: add a l5d-dst-override header to instruct Linkerd what service the request is destined for
   373      #       l5d-dst-override: %CONTOUR_SERVICE_NAME%.%CONTOUR_NAMESPACE%.svc.cluster.local:%CONTOUR_SERVICE_PORT%
   374      #   # default headers to set on all responses (unless set/removed on the HTTPProxy object itself)
   375      #   response-headers:
   376      #     set:
   377      #       # example: Envoy flags that provide additional details about the response or connection
   378      #       X-Envoy-Response-Flags: %RESPONSE_FLAGS%
   379      #
   380  ```
   381  
   382  _Note:_ The default example `contour` includes this [file][1] for easy deployment of Contour.
   383  
   384  ## Environment Variables
   385  
   386  ### CONTOUR_NAMESPACE
   387  
   388  If present, the value of the `CONTOUR_NAMESPACE` environment variable is used as:
   389  
   390  1. The value for the `contour bootstrap --namespace` flag unless otherwise specified.
   391  1. The value for the `contour certgen --namespace` flag unless otherwise specified.
   392  1. The value for the `contour serve --envoy-service-namespace` flag unless otherwise specified.
   393  1. The value for the `leaderelection.configmap-namespace` config file setting for `contour serve` unless otherwise specified.
   394  
   395  The `CONTOUR_NAMESPACE` environment variable is set via the [Downward API][6] in the Contour [example manifests][7].
   396  
   397  ## Bootstrap Config File
   398  
   399  The bootstrap configuration file is generated by an initContainer in the Envoy daemonset which runs the `contour bootstrap` command to generate the file.
   400  This configuration file configures the Envoy container to connect to Contour and receive configuration via xDS.
   401  
   402  The next section outlines all the available flags that can be passed to the `contour bootstrap` command which are used to customize
   403  the configuration file to match the environment in which Envoy is deployed. 
   404  
   405  ### Flags
   406  
   407  There are flags that can be passed to `contour bootstrap` that help configure how Envoy
   408  connects to Contour:
   409  
   410  | Flag | Default  | Description |
   411  |------------|----------|-------------|
   412  | <nobr>--resources-dir</nobr> | "" | Directory where resource files will be written.  |
   413  | <nobr>--admin-address</nobr> | 127.0.0.1 | Address the Envoy admin webpage will listen on.  |
   414  | <nobr>--admin-port</nobr> | 9001 | Port the Envoy admin webpage will listen on.  |
   415  | <nobr>--xds-address</nobr> | 127.0.0.1 | Address to connect to Contour xDS server on.  |
   416  | <nobr>--xds-port</nobr> | 8001 | Port to connect to Contour xDS server on. |
   417  | <nobr>--envoy-cafile</nobr> | "" | CA filename for Envoy secure xDS gRPC communication.  |
   418  | <nobr>--envoy-cert-file</nobr> | "" | Client certificate filename for Envoy secure xDS gRPC communication.  |
   419  | <nobr>--envoy-key-file</nobr> | "" | Client key filename for Envoy secure xDS gRPC communication.  |
   420  | <nobr>--namespace</nobr> | projectcontour | Namespace the Envoy container will run, also configured via ENV variable "CONTOUR_NAMESPACE". Namespace is used as part of the metric names on static resources defined in the bootstrap configuration file.    |
   421  | <nobr>--xds-resource-version</nobr> | v3 | Currently, the only valid xDS API resource version is `v3`.  |
   422  | <nobr>--dns-lookup-family</nobr> | auto | Defines what DNS Resolution Policy to use for Envoy -> Contour cluster name lookup. Either v4, v6 or auto.  |
   423  
   424  
   425  
   426  [1]: {{< param github_url >}}/tree/{{< param version >}}/examples/contour/01-contour-config.yaml
   427  [2]: /guides/structured-logs
   428  [3]: https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/
   429  [4]: https://golang.org/pkg/time/#ParseDuration
   430  [5]: https://godoc.org/github.com/projectcontour/contour/internal/envoy#DefaultFields
   431  [6]: https://kubernetes.io/docs/tasks/inject-data-application/environment-variable-expose-pod-information/
   432  [7]: {{< param github_url >}}/tree/{{< param version >}}/examples/contour
   433  [8]: https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/protocol.proto#envoy-v3-api-field-config-core-v3-httpprotocoloptions-idle-timeout
   434  [9]: https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/filters/network/http_connection_manager/v3/http_connection_manager.proto#envoy-v3-api-field-extensions-filters-network-http-connection-manager-v3-httpconnectionmanager-stream-idle-timeout
   435  [10]: https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/core/v3/protocol.proto#envoy-v3-api-field-config-core-v3-httpprotocoloptions-max-connection-duration
   436  [11]: https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/filters/network/http_connection_manager/v3/http_connection_manager.proto#envoy-v3-api-field-extensions-filters-network-http-connection-manager-v3-httpconnectionmanager-drain-timeout
   437  [12]: https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/filters/network/http_connection_manager/v3/http_connection_manager.proto#envoy-v3-api-field-extensions-filters-network-http-connection-manager-v3-httpconnectionmanager-request-timeout
   438  [13]: https://www.envoyproxy.io/docs/envoy/latest/api-v3/extensions/filters/network/http_connection_manager/v3/http_connection_manager.proto#envoy-v3-api-field-extensions-filters-network-http-connection-manager-v3-httpconnectionmanager-delayed-close-timeout
   439  [14]: https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/listener/v3/listener.proto#config-listener-v3-listener-connectionbalanceconfig