1.17.0 (January 11, 2021)

config: v2 is now fatal-by-default. This may be overridden by setting on the CLI for a v2 bootstrap file and also enabling the runtime envoy.reloadable_features.enable_deprecated_v2_api feature.

Minor Behavior Changes

Changes that may cause incompatibilities for some users, but should not for most

build: the Alpine based debug images are no longer built in CI, use Ubuntu based images instead.
decompressor: set the default value of window_bits of the decompressor to 15 to be able to decompress responses compressed by a compressor with any window size.
expr filter: added connection.termination_details property support.
formatter: the field no longer requires at least one byte, and may now be the empty string. It has also become deprecated.
grpc_web filter: if a grpc-accept-encoding header is present it’s passed as-is to the upstream and if it isn’t grpc-accept-encoding:identity is sent instead. The header was always overwriten with grpc-accept-encoding:identity,deflate,gzip before.
http: upstream protocol will now only be logged if an upstream stream was established.
jwt_authn filter: added support of JWT time constraint verification with a clock skew (default to 60 seconds) and added a filter config field to configure it.
listener: injection of the TLS inspector has been disabled by default. This feature is controlled by the runtime guard envoy.reloadable_features.disable_tls_inspector_injection.
lua: added always_wrap_body argument to body() API to always return a even if the body is empty.
memory: enabled new tcmalloc with restartable sequences for aarch64 builds.
mongo proxy metrics: swapped network connection remote and local closed counters previously set reversed ( and cx_destroy_remote_with_active_rq).
outlier detection: added max_ejection_time to limit ejection time growth when a node stays unhealthy for extended period of time. By default limits ejection time to 5 minutes. Additionally, when the node stays healthy, ejection time decreases. See ejection algorithm for more info. Previously, ejection time could grow without limit and never decreased.
performance: improved performance when handling large HTTP/1 bodies.
tcp_proxy: now waits for HTTP tunnel to be established before start streaming the downstream data, the runtime guard envoy.reloadable_features.http_upstream_wait_connect_response can be set to “false” to disable this behavior.
tls: removed RSA key transport and SHA-1 cipher suites from the client-side defaults.
watchdog: the watchdog action is now the default action to terminate the process if watchdog kill / multikill is enabled.
xds: to support TTLs, heartbeating has been added to xDS. As a result, responses that contain empty resources without updating the version will no longer be propagated to the subscribers. To undo this for VHDS (which is the only subscriber that wants empty resources), the envoy.reloadable_features.vhds_heartbeats can be set to “false”.

Changes expected to improve the state of the world and are unlikely to have negative effects

config: validate that upgrade configs have a non-empty upgrade_type, fixing a bug where an errant “-” could result in unexpected behavior.
dns: fixed a bug where custom resolvers provided in configuration were not preserved after network issues.
dns_filter: correctly associate DNS response IDs when multiple queries are received.
grpc mux: fixed sending node again after stream is reset when is set.
http: fixed URL parsing for HTTP/1.1 fully qualified URLs and connect requests containing IPv6 addresses.
http: reject requests with missing required headers after filter chain processing.
proxy_proto: fixed a bug where the wrong downstream address got sent to upstream connections.
proxy_proto: fixed a bug where network filters would not have the correct downstreamRemoteAddress() when accessed from the StreamInfo. This could result in incorrect enforcement of RBAC rules in the RBAC network filter (but not in the RBAC HTTP filter), or incorrect access log addresses from tcp_proxy.
sds: fixed a bug that clusters sharing same sds target are marked active immediately.
tls: fixed read resumption after triggering buffer high-watermark and all remaining request/response bytes are stored in the SSL connection’s internal buffers.
udp: fixed issue in which receiving truncated UDP datagrams would cause Envoy to crash.
watchdog: touch the watchdog before most event loop operations to avoid misses when handling bursts of callbacks.

Removed Config or Runtime

Normally occurs at the end of the

dispatcher: removed legacy socket read/write resumption code path and runtime guard envoy.reloadable_features.activate_fds_next_event_loop.
ext_authz: removed auto ignore case in HTTP-based ext_authz header matching and the runtime guard envoy.reloadable_features.ext_authz_http_service_enable_case_sensitive_string_matcher. To ignore case, set the ignore_case field to true.
ext_authz: the deprecated field is no longer supported and cannot be set anymore.
http: removed envoy.reloadable_features.http1_flood_protection and legacy code path for turning flood protection off.
http: removed envoy.reloadable_features.new_codec_behavior and legacy codecs.

compression: the filter added support for compressing request payloads. Its configuration is unified with the decompressor filter with two new fields for different directions - and responses. The latter deprecates the old response-specific fields and, if used, roots the response-specific stats in <stat_prefix>.compressor.<compressor_library.name>.<compressor_library_stat_prefix>.response.* instead of <stat_prefix>.compressor.<compressor_library.name>.<compressor_library_stat_prefix>.*.
config: added ability to flush stats when the admin’s is hit instead of on a timer via stats_flush_on_admin.
config: added new runtime feature envoy.features.enable_all_deprecated_features that allows the use of all deprecated features.
crash support: added the ability to dump L4 connection data on crash.
formatter: added new field to support format strings both inline and from a file.
formatter: added support for custom date formatting to %DOWNSTREAM_PEER_CERT_V_START% and , similar to %START_TIME%.
grpc: implemented header value syntax support when defining for gRPC-based ext_authz HTTP and filters, and ratelimit filters.
grpc-json: added support for configuring for path components.
hds: added support for delta updates in the HealthCheckSpecifier, making only the Endpoints and Health Checkers that changed be reconstructed on receiving a new message, rather than the entire HDS.
health_check: added option to use which allows a different no traffic interval when the host is healthy.
http: added HCM request_headers_timeout config field to control how long a downstream has to finish sending headers before the stream is cancelled.
http: added frame flood and abuse checks to the upstream HTTP/2 codec. This check is off by default and can be enabled by setting the envoy.reloadable_features.upstream_http2_flood_checks runtime key to true.
http: added support.
http: clusters added support for selecting HTTP/1 or HTTP/2 based on ALPN, configurable via alpn_config in the message.
jwt_authn: added support for per-route config.
jwt_authn: changed config field to be optional to comply with JWT RFC requirements.
kill_request: added new .
listener: added an optional default filter chain. If this field is supplied, and none of the matches, this default filter chain is used to serve the connection.
listener: added the Listener.bind_to_port field.
lua: added downstreamDirectRemoteAddress() and downstreamLocalAddress() APIs to .
mongo_proxy: the list of commands to produce metrics for is now configurable.
network: added a for incoming connections completing transport-level negotiation, including TLS and ALTS hanshakes.
overload: added envoy.overload_actions.reduce_timeouts overload action to enable scaling timeouts down with load. Scaling support to the HTTP connection and stream idle timeouts.
ratelimit: added support for use of various metadata as a ratelimit action.
ratelimit: added option to disable X-Envoy-RateLimited header.
ratelimit: added body field to support custom response bodies for non-OK responses from the external ratelimit service.
ratelimit: added .
ratelimit: added computed descriptors.
ratelimit: added field to support setting dynamic metadata from the ratelimit service.
router: added support for regex rewrites during HTTP redirects using regex_rewrite.
sds: improved support for atomic and added configurable rotation triggers for TlsCertificate and .
signal: added an extension point for custom actions to run on the thread that has encountered a fatal error. Actions are configurable via fatal_actions.
start_tls: added new which starts in clear-text but may programatically be converted to use tls.
tcp: added a new envoy.overload_actions.reject_incoming_connections action to reject incoming TCP connections.
thrift_proxy: added a new option to skip decoding body in the Thrift message.
tls: added support for RSA certificates with 4096-bit keys in FIPS mode.
tracing: added SkyWalking tracer.
tracing: added support for setting the hostname used when sending spans to a Zipkin collector using the field.
xds: added support for resource TTLs. A TTL is specified on the Resource. For SotW, a can be embedded in the list of resources to specify the TTL.

Deprecated

cluster: HTTP configuration for upstream clusters has been reworked. HTTP-specific configuration is now done in the new message, configured via the cluster’s extension_protocol_options. This replaces explicit HTTP configuration in cluster config, including common_http_protocol_options http2_protocol_options and . Examples of before-and-after configuration can be found in the http_protocol_options docs and all of Envoy’s example configurations have been updated to the new style of config.
compression: the fields , content_type, , remove_accept_encoding_header and of the Compressor message have been deprecated in favor of .
formatter: text_format is now deprecated in favor of . To migrate existing text format strings, use the inline_string field.
gzip: is rejected now unless explicitly allowed with runtime override envoy.deprecated_features.allow_deprecated_gzip_http_filter set to true. Use the .
listener: use_proxy_proto has been deprecated in favor of adding a explicitly.
logging: the option is removed.
ratelimit: the dynamic metadata action is deprecated in favor of the more generic action.
stats: the --use-fake-symbol-table option is removed.