URL Routing #
Riser offers simple routing for a few common scenarios. The examples on this page assume the following configuration unless otherwise specified:
- Deployment Name:
- Domain name:
Domain Name #
Each Environment can have its own domain name. It is recommended, although not required, to use the same base domain name across all Environments with a subdomain named the same as the Environment name. For example, for the domain name
dev Environment should have the domain
dev.myplatform.net, and the
prod Environment should have the domain
For Operators #
Review the Knative docs for setting up a domain in each cluster. Riser reads the Knative configuration in each cluster and maps the domain to the environment. At this time Riser only supports a single domain per Environment.
External URLs #
By default, Apps are exposed externally, meaning outside of the cluster’s service mesh. Depending on how your network architecture is set up, this could mean exposing your App to your private network or to the general public (note: See the Vanity URLs section below for additional recommendations on public exposure)
ℹ️ The Deployment name is the App name by default
ℹ️ If you do not wish to expose your App externally, set the
clusterin your App Config
Cluster URLs #
The cluster URL is useful if you have an App that takes a dependency on another App in the same Kubernetes cluster. Currently there is a 1:1 relationship between a Riser Environment and a Kubernetes cluster.
ℹ️ A future version of Riser may require security policy changes in order to communicate between Apps in different namespaces
Revision URLs #
Riser provides the ability to access a specific Deployment Revision directly.
See the Revisions section for more details.
Vanity URLs #
Because there are many different approaches to managing URLs and frontend proxies, Riser does not have explicit support for Vanity URls. The following section provides examples of various approaches but is not intended to be exhaustive.
DNS CNAME #
If your load balancer is accessible to the network in which you plan to expose your app (e.g. the public internet or your company intranet), you may wish to use a simple CNAME record in your DNS server. For example:
testdummy.org. CNAME testdummy.apps.prod.myplatform.net.
Reverse Proxies #
Reverse proxies can provide more sophisticated routing scenarios such as additional authentication options, path based routing, etc. Since Riser prescribes the use of Istio, you may consider leveraging it for your routing needs. Alternatively, some find proxies such as Nginx or Kong or better suited to their needs.