mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
46 lines
1.4 KiB
Plaintext
46 lines
1.4 KiB
Plaintext
// Module filename: nw-path-based-routes.adoc
|
|
// Module included in the following assemblies:
|
|
// * networking/routes/route-configuration.adoc
|
|
|
|
:_mod-docs-content-type: CONCEPT
|
|
[id="nw-path-based-routes_{context}"]
|
|
= Path-based routes
|
|
|
|
[role="_abstract"]
|
|
To serve multiple applications by using a single hostname, configure path-based routes. This HTTP-based configuration directs traffic to specific services by comparing the URL path component, ensuring requests match the most specific route defined.
|
|
|
|
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
|
|
|===
|
|
|
|
.Example of an unsecured route with a path
|
|
[source,yaml]
|
|
----
|
|
apiVersion: route.openshift.io/v1
|
|
kind: Route
|
|
metadata:
|
|
name: route-unsecured
|
|
spec:
|
|
host: www.example.com
|
|
path: "/test"
|
|
to:
|
|
kind: Service
|
|
name: service-name
|
|
----
|
|
* `spec.host`: Specifies the path 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.
|
|
====
|