Skip to content

create-routes-9fddeea.md

Latest commit

 

History

History
117 lines (61 loc) · 3.24 KB

create-routes-9fddeea.md

File metadata and controls

117 lines (61 loc) · 3.24 KB

Create Routes

You can configure the URLs through which end users can reach your applications.

Prerequisites

You must have the Space Developer or the Space Supporter role.

Context

Routes belong to a space but they’re globally unique, regardless of the organization that controls a space. If a route with a URL exists, you can’t create a route with the same URL.

Procedure

  1. Navigate to your Cloud Foundry space.

  2. Choose Routes from the left hand-side navigation.

  3. Choose Create Route.

  4. In the dialog, enter the following parameters:

    Parameter

    Details

    Domain

    From the dropdown menu, you can choose either a shared domain (for example, the default cfapps.<region>.hana.ondemand.com) or a private domain that you've previously created using the CF CLI.

    From the dropdown menu, you can choose either a shared domain or a private domain that you've previously created using the CF CLI.

    For more information on private domains, see https://docs.cloudfoundry.org/devguide/deploy-apps/routes-domains.html#private-domains.

    Host Name

    The host name is your desired subdomain. In the URL, it’s added before the selected domain, as follows:

    https://<host name>.<domain>

    The host name can contain up to 63 characters.

    Path (Optional)

    In addition to the domain and subdomain, you can also add a path. You can use paths if you want to create routes for multiple applications available for the same host name and domain. The path becomes part of the URL as follows:

    https://<host name>.<domain>/<path>

    You can see the preview of your route at the bottom of the dialog.

  5. When you're happy with your route, choose Create.

Next Steps

  • Once you’ve created a route, you must map it to your application. For more information, see Map Routes to Applications.

  • Additionally, you also have the option to bind it to a route service instance by choosing (Bind Route Service) from the Actions column. For more information, see Bind Routes to Service Instances.

Related Information

About Routes in the Cockpit