narthollis / kubempf

Tool to forward and maintain multiple port forwards to kubernetes pods

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

kubempf

Tool to forward and maintain multiple port forwards to kubernetes pods

Usage

Usage: kubempf [OPTIONS] <FORWARD>...

Arguments:
  <FORWARD>...  [[LOCAL_ADDRESS:]LOCAL_PORT:][namespace/]service:port

Options:
  -c, --context [<CONTEXT>]      Kubernetes Context
  -n, --namespace [<NAMESPACE>]  Default Kubernetes Namespace to match services in
      --compact                  Enable compact console output
  -h, --help                     Print help

Forwards

Each forward is passed as plain (positional) argument in the following format

[[LOCAL_ADDRESS:]LOCAL_PORT:]SERVICE_NAME:SERVICE_OR_POD_PORT

eg. kubempf 192.0.2.31:8080:nginx:80 will bind locally to TCP 192.0.2.31:8080 and forward all traffic to port 80 on one of the pods matching the label selector for the nginx service.

If local address is left off (eg. kubempf 8080:nginx:80) the local address will be set to 127.0.0.1 If local port is also left off (eg. kubempf postgresql:5432) the local port will be set to the remote port. It is not currently possible to use this shorthand with named ports.

To forward to a service in a different namespace to the one specified by the namespace argument (or if that is not set, in the context) you can specify the specify the namespace by prefixing it to the service name and separating with a /. eg. kubempf rabbitmq/rabbitmq:15672 rabbitmq/rabbitmq:5672 would forward the local ports 5672 and 15672 to the rabbitmq service in the rabbitmq namespace.

It is also possible to forward to named ports, such that kubempf 8080:nginx:http will try and find a port named http first on the nginx service, and if that fails it will then try and find a port named http on the pod matched by the services label selector.

Arguments

Short Long Description
-c --context Name of the context from the kube config to use
-n --namespace Default Kubernetes namespace to find the services in
Enable compact console output

About

Tool to forward and maintain multiple port forwards to kubernetes pods

License:MIT License


Languages

Language:Rust 90.7%Language:Shell 9.3%