docs: route matching details (#17)

envoyproxy · Aug 16, 2016 · daf57a8 · daf57a8
1 parent 841475e
commit daf57a8
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 0 deletions.
diff --git a/docs/configuration/http_conn_man/route_config/route_config.rst b/docs/configuration/http_conn_man/route_config/route_config.rst
@@ -53,3 +53,4 @@ response_headers_to_remove
   vhost
   route
   vcluster
+  route_matching
diff --git a/docs/configuration/http_conn_man/route_config/route_matching.rst b/docs/configuration/http_conn_man/route_config/route_matching.rst
@@ -0,0 +1,12 @@
+Route matching
+==============
+
+When Envoy matches a route, it uses the following procedure:
+
+#. The HTTP request's *host* or *:authority* header is matched to a :ref:`virtual host
+   <config_http_conn_man_route_table_vhost>`.
+#. Each :ref:`route entry <config_http_conn_man_route_table_route>` in the virtual host is checked,
+   *in order*. If there is a match, the route is used and no further route checks are made.
+#. Independently, each :ref:`virtual cluster <config_http_conn_man_route_table_vcluster>` in the
+   virtual host is checked, *in order*. If there is a match, the virtual cluster is used and no 
+   further virtual cluster checks are made.