openshift/openshift-docs
1
0
Fork 0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 21:46:22 +01:00
Code Issues Releases Activity

BZ-1783799: Added path based route doc

Browse Source
This commit is contained in:
Samantha Gidlow
2021-03-31 09:18:54 -04:00
committed by openshift-cherrypick-robot
parent 173f5781ad
commit ec93037026
2 changed files with 46 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

44
modules/nw-path-based-routes.adoc Normal file
View File

@@ -0,0 +1,44 @@
// Module filename: nw-path-based-routes.adoc
// Module included in the following assemblies:
// * networking/routes/route-configuration.adoc
[id="nw-path-based-routes_{context}"]
= Path-based routes
Path-based routes specify a path component that can be compared against a URL, which requires that the traffic for the route be HTTP based. Thus, multiple routes can be served using the same host name, each with a different path. Routers should match routes based on the most specific path to the least. However, this depends on the router implementation.
The following table shows example routes and their accessibility:
.Route availability
[cols="3*", options="header"]
|===
|Route | When Compared to | Accessible
.2+|_www.example.com/test_ |_www.example.com/test_|Yes
|_www.example.com_|No
.2+|_www.example.com/test_ and _www.example.com_ | _www.example.com/test_|Yes
|_www.example.com_|Yes
.2+|_www.example.com_|_www.example.com/text_|Yes (Matched by the host, not the route)
|_www.example.com_|Yes
|===
.An unsecured route with a path
[source,yaml]
----
apiVersion: v1
kind: Route
metadata:
name: route-unsecured
spec:
host: www.example.com
path: "/test" <1>
to:
kind: Service
name: service-name
----
<1> The path is the only added attribute for a path-based route.
[NOTE]
====
Path-based routing is not available when using passthrough TLS, as the router does not terminate TLS in that case and cannot read the contents of the request.
====

2
networking/routes/route-configuration.adoc
View File

@@ -20,6 +20,8 @@ include::modules/nw-throughput-troubleshoot.adoc[leveloffset=+1]
include::modules/nw-using-cookies-keep-route-statefulness.adoc[leveloffset=+1]
include::modules/nw-annotating-a-route-with-a-cookie-name.adoc[leveloffset=+2]
include::modules/nw-path-based-routes.adoc[leveloffset=+1]
include::modules/nw-route-specific-annotations.adoc[leveloffset=+1]
include::modules/nw-route-admission-policy.adoc[leveloffset=+1]