Version 2.1

kf proxy

Name

kf proxy - Start a local reverse proxy to an App

Synopsis

kf proxy APP_NAME [flags]

Description

Proxy creates a reverse HTTP proxy to the cluster's gateway on a local port opened on the operating system's loopback device.

The proxy rewrites all HTTP requests, changing the HTTP Host header and adding an additional header X-Kf-App to ensure traffic reaches the specified app even if multiple are attached to the same route.

Proxy DOES NOT establish a direct connection to the App.

For proxy to work:

  • The cluster's gateway MUST be accessible from your local machine.
  • The app MUST have a public URL

    If you need to establish a direct connection to an App, use the port-forward command in kubectl. It establishes a proxied connection directly to a port on a pod via the Kubernetes cluster. port-forward bypasses all routing.

Examples

  kf proxy myapp

Flags

--gateway=string
HTTP gateway to route requests to (default: autodetected from cluster)
-h, --help
help for proxy
--port=int
Local port to listen on (default 8080)

Inherited flags

These flags are inherited from parent commands.

--config=string
Config file (default is $HOME/.kf)
--kubeconfig=string
Kubectl config file (default is $HOME/.kube/config)
--log-http
Log HTTP requests to stderr
--space=string
Space to run the command against. This overrides the currently targeted space