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
