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