docs: 1.5.0 release notes (#302)

Signed-off-by: Matt Klein <mklein@lyft.com>

docs/root/configuration/http_conn_man/headers.rst

@@ -278,19 +278,19 @@ The encode one or more options. For example, Debug is encoded as
 
 .. _config_http_conn_man_headers_custom_request_headers:
 
-Custom request headers
-----------------------
+Custom request/response headers
+-------------------------------
 
-Custom request headers can be added to a request that matches a specific route at the route,
-virtual host, and global route configuration level. See the relevant
-:ref:`v1 <config_http_conn_man_route_table>` and :ref:`v2 <envoy_api_msg_RouteConfiguration>` API
+Custom request/response headers can be added to a request/response that matches a specific route at
+the route, virtual host, and global route configuration level. See the relevant :ref:`v1
+<config_http_conn_man_route_table>` and :ref:`v2 <envoy_api_msg_RouteConfiguration>` API
 documentation.
 
-**Note:** Headers are appended to requests in the following order: route level headers, virtual host
+**Note:** Headers are appended to requests/responses in the following order: route level headers, virtual host
 level headers and finally global level headers.
 
-Envoy additionally supports adding dynamic values to the request headers. Supported dynamic values
-are:
+Envoy additionally supports adding dynamic values to the **request** headers. Supported dynamic
+values are:
 
 %CLIENT_IP%
    The original client IP which is already added by Envoy as a

docs/root/configuration/http_conn_man/stats.rst

@@ -68,6 +68,7 @@ the following statistics:
    downstream_cx_destroy_remote_active_rq, Counter, Total connections destroyed remotely with 1+ active requests
    downstream_rq_total, Counter, Total requests
 
+.. _config_http_conn_man_stats_per_listener:
 
 Per listener statistics
 -----------------------

docs/root/configuration/network_filters/mongo_proxy_filter.rst

@@ -7,6 +7,14 @@ Mongo proxy
 - :ref:`v1 API reference <config_network_filters_mongo_proxy_v1>`
 - :ref:`v2 API reference <envoy_api_msg_filter.network.MongoProxy>`
 
+.. _config_network_filters_mongo_proxy_fault_injection:
+
+Fault injection
+---------------
+
+The Mongo proxy filter supports fault injection. See the v1 and v2 API reference for how to
+configure.
+
 .. _config_network_filters_mongo_proxy_stats:
 
 Statistics

docs/root/configuration/runtime.rst

@@ -45,6 +45,8 @@ that :option:`--service-cluster` has been set to ``my-cluster``. Envoy will firs
 If found, the value will override any value found in the primary lookup path. This allows the user
 to customize the runtime values for individual clusters on top of global defaults.
 
+.. _config_runtime_comments:
+
 Comments
 --------
 

docs/root/intro/arch_overview/load_balancing.rst

@@ -152,8 +152,7 @@ not be used with subsets because the upstream hosts are not known in advance. Su
 with zone aware routing, but be aware that the use of subsets may easily violate the minimum hosts
 condition described above.
 
-If subsets are `configured
-<https://github.com/envoyproxy/data-plane-api/blob/9897e3f/api/cds.proto#L237>`_ and a route
+If subsets are :ref:`configured <envoy_api_field_Cluster.lb_subset_config>` and a route
 specifies no metadata or no subset matching the metadata exists, the subset load balancer initiates
 its fallback policy. The default policy is ``NO_ENDPOINT``, in which case the request fails as if
 the cluster had no hosts. Conversely, the ``ANY_ENDPOINT`` fallback policy load balances across all

docs/root/intro/arch_overview/mongo.rst

@@ -10,6 +10,7 @@ Envoy supports a network level MongoDB sniffing filter with the following featur
   routed clusters.
 * Query logging.
 * Per callsite statistics via the $comment query parameter.
+* Fault injection.
 
 The MongoDB filter is a good example of Envoy’s extensibility and core abstractions. At Lyft we use
 this filter between all applications and our databases. It provides an invaluable source of data

docs/root/intro/version_history.rst

@@ -1,6 +1,69 @@
 Version history
 ---------------
 
+1.5.0
+=====
+
+* access log: added fields for :ref:`UPSTREAM_LOCAL_ADDRESS and DOWNSTREAM_ADDRESS
+  <config_access_log_format>`.
+* admin: added :ref:`JSON output <operations_admin_interface_stats>` for stats admin endpoint.
+* admin: added basic :ref:`Prometheus output <operations_admin_interface_stats>` for stats admin
+  endpoint. Histograms are not currently output.
+* config: the :ref:`v2 API <config_overview_v2>` is now considered production ready.
+* config: added ::option:`--v2-config-only` CLI flag.
+* cors: added :ref:`CORS filter <config_http_filters_cors>`.
+* health check: added :ref:`x-envoy-immediate-health-check-fail
+  <config_http_filters_router_x-envoy-immediate-health-check-fail>` header support.
+* health check: added :ref:`reuse_connection <envoy_api_field_HealthCheck.reuse_connection>` option.
+* http: added :ref:`per-listener stats <config_http_conn_man_stats_per_listener>`.
+* http: end-to-end HTTP flow control is now complete across both connections, streams, and filters.
+* load balancer: added :ref:`subset load balancer <arch_overview_load_balancer_subsets>`.
+* load balancer: added ring size and hash :ref:`configuration options
+  <envoy_api_msg_Cluster.RingHashLbConfig>`. This used to be configurable via runtime. The runtime
+  configuration was deleted without deprecation as we are fairly certain no one is using it.
+* log: added the ability to optionally log to a file instead of stderr via the
+  ::option:`--log-path` option.
+* listeners: added :ref:`drain_type <envoy_api_field_Listener.drain_type>` option.
+* lua: added experimental :ref:`Lua filter <config_http_filters_lua>`.
+* mongo filter: added :ref:`fault injection <config_network_filters_mongo_proxy_fault_injection>`.
+* mongo filter: added :ref:`"drain close" <arch_overview_draining>` support.
+* outlier detection: added :ref:`HTTP gateway failure type <arch_overview_outlier_detection>`.
+  See `DEPRECATED.md <https://github.com/envoyproxy/envoy/blob/master/DEPRECATED.md#version-150>`_
+  for outlier detection stats deprecations in this release.
+* redis: the :ref:`redis proxy filter <config_network_filters_redis_proxy>` is now considered
+  production ready.
+* redis: added :ref:`"drain close" <arch_overview_draining>` functionality.
+* router: added :ref:`x-envoy-overloaded <config_http_filters_router_x-envoy-overloaded>` support.
+* router: added :ref:`regex <envoy_api_field_RouteMatch.regex>` route matching.
+* router: added :ref:`custom request headers <config_http_conn_man_headers_custom_request_headers>`
+  for upstream requests.
+* router: added :ref:`downstream IP hashing
+  <envoy_api_field_RouteAction.HashPolicy.connection_properties>` for HTTP ketama routing.
+* router: added :ref:`cookie hashing <envoy_api_field_RouteAction.HashPolicy.cookie>`.
+* router: added :ref:`start_child_span <envoy_api_field_filter.http.Router.start_child_span>` option
+  to create child span for egress calls.
+* router: added optional :ref:`upstream logs <envoy_api_field_filter.http.Router.upstream_log>`.
+* router: added complete :ref:`custom append/override/remove support
+  <config_http_conn_man_headers_custom_request_headers>` of request/response headers.
+* router: added support to :ref:`specify response code during redirect
+  <envoy_api_field_RedirectAction.response_code>`.
+* runtime: added :ref:`comment capability <config_runtime_comments>`.
+* server: change default ::`-l` to info level.
+* stats: maximum stat/name sizes and maximum number of stats are now variable via the
+  ::option:`--max-obj-name-len` and ::option:`--max-stats` options.
+* tcp proxy: added :ref:`access logging <envoy_api_field_filter.network.TcpProxy.access_log>`.
+* tcp proxy: added :ref:`configurable connect retries
+  <envoy_api_field_filter.network.TcpProxy.max_connect_attempts>`.
+* tcp proxy: enable use of :ref:`outlier detector <arch_overview_outlier_detection>`.
+* tls: added :ref:`SNI support <faq_how_to_setup_sni>`.
+* tls: added support for specifying :ref:`TLS session ticket keys
+  <envoy_api_field_DownstreamTlsContext.session_ticket_keys>`.
+* tls: allow configuration of the :ref:`min
+  <envoy_api_field_TlsParameters.tls_minimum_protocol_version>` and :ref:`max
+  <envoy_api_field_TlsParameters.tls_maximum_protocol_version>` TLS protocol versions.
+* tracing: added :ref:`custom trace span decorators <envoy_api_field_Route.decorator>`.
+* Many small bug fixes and performance improvements not listed.
+
 1.4.0
 =====
 

docs/root/operations/admin.rst

@@ -134,6 +134,8 @@ The fields are:
 * Total uptime in seconds (across all hot restarts)
 * Current hot restart epoch
 
+.. _operations_admin_interface_stats:
+
 .. http:get:: /stats
 
   Outputs all statistics on demand. This includes only counters and gauges. Histograms are not