kf create-route

Create a traffic routing rule for a host+path pair.

Name

kf create-route - Create a traffic routing rule for a host+path pair.

Synopsis

kf create-route DOMAIN [--hostname HOSTNAME] [--path PATH] [flags]

Description

Creating a Route allows Apps to declare they want to receive traffic on the same host/domain/path combination.

Routes without any bound Apps (or with only stopped Apps) will return a 404 HTTP status code.

Kf doesn’t enforce Route uniqueness between Spaces. It’s recommended to provide each Space with its own subdomain instead.

Examples

kf create-route example.com --hostname myapp # myapp.example.com
kf create-route --space myspace example.com --hostname myapp # myapp.example.com
kf create-route example.com --hostname myapp --path /mypath # myapp.example.com/mypath
kf create-route --space myspace myapp.example.com # myapp.example.com

# Using SPACE to match 'cf'
kf create-route myspace example.com --hostname myapp # myapp.example.com
kf create-route myspace example.com --hostname myapp --path /mypath # myapp.example.com/mypath

Flags

--async

Do not wait for the action to complete on the server before returning.

-h, --help

help for create-route

--hostname=string

Hostname for the Route.

--path=string

URL path for the Route.

Inherited flags

These flags are inherited from parent commands.

--as=string

Username to impersonate for the operation.

--as-group=strings

Group to impersonate for the operation. Include this flag multiple times to specify multiple groups.

--config=string

Path to the Kf config file to use for CLI requests.

--kubeconfig=string

Path to the kubeconfig file to use for CLI requests.

--log-http

Log HTTP requests to standard error.

--space=string

Space to run the command against. This flag overrides the currently targeted Space.