Chiebot-Mirror
/
data-plane-api
mirror of https://github.com/envoyproxy/data-plane-api.git
8
0
Fork 0
Code Issues Projects Releases Wiki Activity

docs: 1.6.0 release notes (#568)

Browse Source 
Signed-off-by: Matt Klein <mklein@lyft.com>
pull/573/head
Matt Klein 7 years ago committed by GitHub
parent 61f4a5ab2e
commit 2998e1cb90
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
7 changed files with 127 additions and 16 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 12
      docs/root/configuration/http_filters/router_filter.rst
  2. 2
      docs/root/configuration/http_filters/squash_filter.rst
  3. 120
      docs/root/intro/version_history.rst
  4. 2
      docs/root/operations/admin.rst
  5. 2
      envoy/api/v2/cds.proto
  6. 1
      envoy/api/v2/core/address.proto
  7. 4
      envoy/api/v2/route/route.proto

12
docs/root/configuration/http_filters/router_filter.rst
Unescape View File

@ -64,10 +64,11 @@ x-envoy-retry-on
^^^^^^^^^^^^^^^^
Setting this header on egress requests will cause Envoy to attempt to retry failed requests (number
of retries defaults to 1 and can be controlled by :ref:`x-envoy-max-retries <config_http_filters_router_x-envoy-max-retries>`
header or the :ref:`route config retry policy <config_http_conn_man_route_table_route_retry>`). The
value to which the x-envoy-retry-on header is set indicates the retry policy. One or more policies can be specified
using a ',' delimited list. The supported policies are:
of retries defaults to 1 and can be controlled by :ref:`x-envoy-max-retries
<config_http_filters_router_x-envoy-max-retries>` header or the :ref:`route config retry policy
<config_http_conn_man_route_table_route_retry>`). The value to which the x-envoy-retry-on header is
set indicates the retry policy. One or more policies can be specified using a ',' delimited list.
The supported policies are:
5xx
Envoy will attempt a retry if the upstream server responds with any 5xx response code, or does not
@ -81,7 +82,8 @@ using a ',' delimited list. The supported policies are:
request, including any retries that take place.
gateway-error
This policy is similar to the *5xx* policy but will only retry requests that result in a 502, 503, or 504.
This policy is similar to the *5xx* policy but will only retry requests that result in a 502, 503,
or 504.
connect-failure
Envoy will attempt a retry if a request is failed because of a connection failure to the upstream

2
docs/root/configuration/http_filters/squash_filter.rst
Unescape View File

@ -4,7 +4,7 @@ Squash
======
Squash is an HTTP filter which enables Envoy to integrate with Squash microservices debugger.
Code: https://github.com/solo-io/squash, API Docs: https://squash.solo.io/
Code: https://github.com/solo-io/squash, API Docs: https://squash.solo.io/
Overview
--------

120
docs/root/intro/version_history.rst
Unescape View File

@ -4,17 +4,123 @@ Version history
1.6.0
=====
* http : added idle timeout for :ref:`upstream http connections
<envoy_api_field_core.HttpProtocolOptions.idle_timeout>`.
* access log: added DOWNSTREAM_REMOTE_ADDRESS, DOWNSTREAM_REMOTE_ADDRESS_WITHOUT_PORT, and
DOWNSTREAM_LOCAL_ADDRESS :ref:`access log formatters <config_access_log_format>`.
DOWNSTREAM_ADDRESS access log formatter has been deprecated.
* access log: added less than or equal (LE) :ref:`comparison filter
<envoy_api_msg_config.filter.accesslog.v2.ComparisonFilter>`.
* access log: added configuration to :ref:`runtime filter
<envoy_api_msg_config.filter.accesslog.v2.RuntimeFilter>` to set default sampling rate, divisor,
and whether to use independent randomness or not.
* admin: added :ref:`/runtime <operations_admin_interface_runtime>` admin endpoint to read the
current runtime values.
* build: added support for :repo:`building Envoy with exported symbols
<bazel#enabling-optional-features>`. This change allows scripts loaded with the Lua filter to
load shared object libraries such as those installed via `LuaRocks <https://luarocks.org/>`_.
* config: added support for sending error details as
`grpc.rpc.Status <https://github.com/googleapis/googleapis/blob/master/google/rpc/status.proto>`_
in :ref:`DiscoveryRequest <envoy_api_msg_DiscoveryRequest>`.
* config: added support for :ref:`inline delivery <envoy_api_msg_core.DataSource>` of TLS
certificates and private keys.
* config: added restrictions for the backing :ref:`config sources <envoy_api_msg_core.ConfigSource>`
of xDS resources. For filesystem based xDS the file must exist at configuration time. For cluster
based xDS the backing cluster must be statically defined and be of non-EDS type.
* grpc: the Google gRPC C++ library client is now supported as specified in the :ref:`gRPC services
overview <arch_overview_grpc_services>` and :ref:`GrpcService <envoy_api_msg_core.GrpcService>`.
* grpc-json: Added support for :ref:`inline descriptors
<envoy_api_field_config.filter.http.transcoder.v2.GrpcJsonTranscoder.proto_descriptor_bin>`.
* health check: added :ref:`gRPC health check <envoy_api_field_core.HealthCheck.grpc_health_check>`
based on `grpc.health.v1.Health <https://github.com/grpc/grpc/blob/master/src/proto/grpc/health/v1/health.proto>`_
service.
* health check: added ability to set :ref:`host header value
<envoy_api_field_core.HealthCheck.HttpHealthCheck.host>` for http health check.
* health check: extended the health check filter to support computation of the health check response
based on the :ref:`percentage of healthy servers in upstream clusters
<envoy_api_field_config.filter.http.health_check.v2.HealthCheck.cluster_min_healthy_percentages>`.
* health check: added setting for :ref:`no-traffic
interval<envoy_api_field_core.HealthCheck.no_traffic_interval>`.
* tracing: when using the zipkin tracer, it is now possible for clients to specify the sampling decision (using
the :ref:`x-b3-sampled <config_http_conn_man_headers_x-b3-sampled>` header) and have the decision
propagated through to subsequently invoked services.
* tracing: when using the zipkin tracer, it is no longer necessary to propagate the
* http : added idle timeout for :ref:`upstream http connections
<envoy_api_field_core.HttpProtocolOptions.idle_timeout>`.
* http: added support for :ref:`proxying 100-Continue responses
<envoy_api_field_config.filter.network.http_connection_manager.v2.HttpConnectionManager.proxy_100_continue>`.
* http: added the ability to pass a URL encoded PEM encoded peer certificate in the
:ref:`config_http_conn_man_headers_x-forwarded-client-cert` header.
* http: added support for trusting additional hops in the
:ref:`config_http_conn_man_headers_x-forwarded-for` request header.
* http: added support for :ref:`incoming HTTP/1.0
<envoy_api_field_core.Http1ProtocolOptions.accept_http_10>`.
* hot restart: added SIGTERM propagation to children to :ref:`hot-restarter.py
<operations_hot_restarter>`, which enables using it as a parent of containers.
* ip tagging: added :ref:`HTTP IP Tagging filter<config_http_filters_ip_tagging>`.
* listeners: added support for :ref:`listening for both IPv4 and IPv6
<envoy_api_field_core.SocketAddress.ipv4_compat>` when binding to ::.
* listeners: added support for listening on :ref:`UNIX domain sockets
<envoy_api_field_core.Address.pipe>`.
* listeners: added support for :ref:`abstract unix domain sockets <envoy_api_msg_core.Pipe>` on
Linux. The abstract namespace can be used by prepending '@' to a socket path.
* listeners: added :ref:`transparent <envoy_api_field_Listener.transparent>` option.
* load balancer: added cluster configuration for :ref:`healthy panic threshold
<envoy_api_field_Cluster.CommonLbConfig.healthy_panic_threshold>` percentage.
* load balancer: added :ref:`Maglev <arch_overview_load_balancing_types_maglev>` consistent hash
load balancer.
* load balancer: added support for
:ref:`LocalityLbEndpoints<envoy_api_msg_endpoint.LocalityLbEndpoints>` priorities.
* lua: added headers :ref:`replace() <config_http_filters_lua_header_wrapper>` API.
* redis: added local `PING` support to the :ref:`Redis filter <arch_overview_redis>`.
* redis: added `GEORADIUS_RO` and `GEORADIUSBYMEMBER_RO` to the :ref:`Redis command splitter
<arch_overview_redis>` whitelist.
* router: added DOWNSTREAM_REMOTE_ADDRESS_WITHOUT_PORT, DOWNSTREAM_LOCAL_ADDRESS,
DOWNSTREAM_LOCAL_ADDRESS_WITHOUT_PORT, PROTOCOL, and UPSTREAM_METADATA :ref:`header
formatters <config_http_conn_man_headers_custom_request_headers>`. The CLIENT_IP header formatter
has been deprecated.
* router: added gateway-error :ref:`retry-on <config_http_filters_router_x-envoy-retry-on>` policy.
* router: added support for route matching based on :ref:`URL query string parameters
<envoy_api_msg_route.QueryParameterMatcher>`.
* router: added support for more granular weighted cluster routing by allowing the :ref:`total_weight
<envoy_api_field_route.WeightedCluster.total_weight>` to be specified in configuration.
* router: added support for :ref:`custom request/response headers
<config_http_conn_man_headers_custom_request_headers>` with mixed static and dynamic values.
* router: added support for :ref:`direct responses <envoy_api_field_route.Route.direct_response>`.
I.e., sending a preconfigured HTTP response without proxying anywhere.
* router: added support for :ref:`HTTPS redirects
<envoy_api_field_route.RedirectAction.https_redirect>` on specific routes.
* router: added support for :ref:`prefix_rewrite
<envoy_api_field_route.RedirectAction.prefix_rewrite>` for redirects.
* router: added support for :ref:`stripping the query string
<envoy_api_field_route.RedirectAction.strip_query>` for redirects.
* router: added support for downstream request/upstream response
:ref:`header manipulation <config_http_conn_man_headers_custom_request_headers>` in :ref:`weighted
cluster <envoy_api_msg_route.WeightedCluster>`.
* router: added support for :ref:`range based header matching
<envoy_api_field_route.HeaderMatcher.range_match>` for request routing.
* squash: added support for the :ref:`Squash microservices debugger <config_http_filters_squash>`.
Allows debugging an incoming request to a microservice in the mesh.
* stats: added metrics service API implementation.
* stats: added native :ref:`DogStatsd <envoy_api_msg_config.metrics.v2.DogStatsdSink>` support.
* stats: added support for :ref:`fixed stats tag values
<envoy_api_field_config.metrics.v2.TagSpecifier.fixed_value>` which will be added to all metrics.
* tcp proxy: added support for specifying a :ref:`metadata matcher
<envoy_api_field_config.filter.network.tcp_proxy.v2.TcpProxy.metadata_match>` for upstream
clusters in the tcp filter.
* tcp proxy: improved TCP proxy to correctly proxy TCP half-close.
* tcp proxy: added :ref:`idle timeout
<envoy_api_field_config.filter.network.tcp_proxy.v2.TcpProxy.idle_timeout>`.
* tcp proxy: access logs now bring an IP address without a port when using DOWNSTREAM_ADDRESS.
Use :ref:`DOWNSTREAM_REMOTE_ADDRESS <config_access_log_format>` instead.
* tracing: added support for dynamically loading an :ref:`OpenTracing tracer
<envoy_api_msg_config.trace.v2.DynamicOtConfig>`.
* tracing: when using the Zipkin tracer, it is now possible for clients to specify the sampling
decision (using the :ref:`x-b3-sampled <config_http_conn_man_headers_x-b3-sampled>` header) and
have the decision propagated through to subsequently invoked services.
* tracing: when using the Zipkin tracer, it is no longer necessary to propagate the
:ref:`x-ot-span-context <config_http_conn_man_headers_x-ot-span-context>` header.
See more on trace context propagation :ref:`here <arch_overview_tracing>`.
* listeners: added :ref:`transparent <envoy_api_field_Listener.transparent>` option.
* transport sockets: added transport socket interface to allow custom implementations of transport
sockets. A transport socket provides read and write logic with buffer encryption and decryption
(if applicable). The existing TLS implementation has been refactored with the interface.
* upstream: added support for specifying an :ref:`alternate stats name
<envoy_api_field_Cluster.alt_stat_name>` while emitting stats for clusters.
* Many small bug fixes and performance improvements not listed.
1.5.0
=====

2
docs/root/operations/admin.rst
Unescape View File

@ -186,6 +186,8 @@ The fields are:
v0.0.4 format. This can be used to integrate with a Prometheus server. Currently, only counters and
gauges are output. Histograms will be output in a future update.
.. _operations_admin_interface_runtime:
.. http:get:: /runtime
Outputs all runtime values on demand in a human-readable format. See

2
envoy/api/v2/cds.proto
Unescape View File

@ -374,6 +374,8 @@ message Cluster {
// .. note::
// The specified percent will be truncated to the nearest 1%.
envoy.type.Percent healthy_panic_threshold = 1;
// [#not-implemented-hide:]
message ZoneAwareLbConfig {
// [#not-implemented-hide:]
// Configures percentage of requests that will be considered for zone aware routing

1
envoy/api/v2/core/address.proto
Unescape View File

@ -75,6 +75,7 @@ message BindConfig {
message Address {
oneof address {
option (validate.required) = true;
SocketAddress socket_address = 1;
Pipe pipe = 2;
}

4
envoy/api/v2/route/route.proto
Unescape View File

@ -815,7 +815,6 @@ message HeaderMatcher {
// * The regex *\d{3}* does not match the value *123.456*
google.protobuf.BoolValue regex = 3;
// [#not-implemented-hide:]
// Specifies how the header match will be performed to route the request.
// If header_match_specifier is absent, a request that has the
// :ref:`envoy_api_msg_route.HeaderMatcher.name` header will match, regardless of the header's
@ -836,7 +835,6 @@ message HeaderMatcher {
// * The regex *\d{3}* does not match the value *123.456*
string regex_match = 5;
// [#not-implemented-hide:]
// If specified, header match will be performed based on range.
// The rule will match if the request header value is within this range.
// The entire request header value must represent an integer in base 10 notation: consisting of
@ -847,7 +845,7 @@ message HeaderMatcher {
// Examples:
//
// * For range [-10,0), route will match for header value -1, but not for 0, "somestring", 10.9,
// "-1somestring"
// "-1somestring"
envoy.type.Int64Range range_match = 6;
}
}

Write Preview
Loading…
Cancel
Save