Kubectl port-forward

kubectl port-forward forward one or more local ports to a pod.

• Man: https://www.mankier.com/1/kubectl-port-forward

Examples

• kubectl --namespace default port-forward $POD_NAME 3000
• kubectl port-forward svc/argocd-server -n argocd 8080:443

export POD_NAME=$(kubectl get pods --namespace default -l "app.kubernetes.io/name=grafana,app.kubernetes.io/instance=grafana" -o jsonpath="{.items[0].metadata.name}")

kubectl --namespace default port-forward $POD_NAME 3000
Forwarding from 127.0.0.1:3000 -> 3000
Forwarding from [::1]:3000 -> 3000

kubectl -n default port-forward $POD_NAME 8443:8443
Forwarding from 127.0.0.1:8443 -> 8443
Forwarding from [::1]:8443 -> 8443

List of ports:

kubectl get svc --all-namespaces -o json | jq '.items[] | {name:.metadata.name, p:.spec.ports[] } | select( .p.nodePort != null ) | "\(.name): localhost:\(.p.nodePort) -> \(.p.port) -> \(.p.targetPort)"'

Examples with errors

kubectl --namespace default port-forward $POD_NAME 3000
error: unable to forward port because pod is not running. Current status=Failed

kubectl --namespace default port-forward $POD_NAME 3000
error: unable to forward port because pod is not running. Current status=Pending

kubectl --namespace default port-forward $POD_NAME 3000
error: You must be logged in to the server (Unauthorized)

kubectl --namespace default port-forward $POD_NAME 3000
error: TYPE/NAME and list of ports are required for port-forward
See 'kubectl port-forward -h' for help and examples

Related

• kubectl get pods
• Port forwarding
• kubectl proxy
• Kubernetes networking

See also

• kubectl port-forward [ --help ]
• Kubernetes networking: network policies, Network Policy Providers, CNI, Calico, flannel, Service mesh, Istio, kube-proxy, coredns, AWS VPC CNI: vpc-cni, Kubernetes: Ingress controllers, IPVS, ServiceTypes: LoadBalancer, ClusterIP, NodePort, ExternalName, Endpoints, EndpointSlices, Kubernetes DNS, svc.cluster.local, Weave Net
• Kubernetes services, kubectl get services, kubectl describe service, kubectl create service [ loadbalancer | nodeport | clusterip | externalname ], kubectl expose, headless service, service.beta.kubernetes.io