Difference between revisions of "Kubectl port-forward"
Jump to navigation
Jump to search
(19 intermediate revisions by 4 users not shown) | |||
Line 2: | Line 2: | ||
<code>[[kubectl]] [[port-forward]]</code> [[forward]] one or more local ports to a [[pod]]. | <code>[[kubectl]] [[port-forward]]</code> [[forward]] one or more local ports to a [[pod]]. | ||
* Man: https://www.mankier.com/1/kubectl-port-forward | * Man: https://www.mankier.com/1/kubectl-port-forward | ||
+ | * <code>[[kubectl port-forward --help]]</code> | ||
+ | * <code>[[kubectl]] [[port-forward]] [[deployment/]]mydeployment 8080:443</code> | ||
+ | * <code>[[kubectl]] [[port-forward]] [[deployment/]]mydeployment 8080:443 &</code> | ||
== Examples == | == Examples == | ||
* [[Grafana]]: <code>kubectl --namespace default port-forward [[$POD_NAME]] [[3000]]</code> | * [[Grafana]]: <code>kubectl --namespace default port-forward [[$POD_NAME]] [[3000]]</code> | ||
− | * [[Prometheus]]: <code>kubectl --namespace default port-forward $POD_NAME [[9090]]</code> | + | * [[Prometheus]]: |
− | * <code>kubectl port-forward [[svc]]/[[ | + | ** <code>kubectl --namespace default port-forward $POD_NAME [[9090]]</code> |
+ | ** <code>[[kubectl port-forward]] --namespace default [[svc/]][[prometheus-kube-prometheus-prometheus]] [[9090]]:9090</code> | ||
+ | ** [[Alertmanager]]: <code>kubectl port-forward --namespace default svc/prometheus-kube-prometheus-alertmanager 9093:9093</code> | ||
+ | |||
+ | <code>[[kubectl port-forward svc/argocd-server -n argocd 8080:443]]</code> | ||
+ | [[Forwarding from]] 127.0.0.1:8080 -> 8080 | ||
[[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}") | [[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}") | ||
Line 17: | Line 25: | ||
Forwarding from 127.0.0.1:8443 -> 8443 | Forwarding from 127.0.0.1:8443 -> 8443 | ||
Forwarding from [::1]:8443 -> 8443 | Forwarding from [::1]:8443 -> 8443 | ||
+ | |||
+ | kubectl -n your-namespace port-forward [[service]]/[[pritunl-ui]] 7111:443 | ||
+ | |||
Line 27: | Line 38: | ||
kubectl --namespace default port-forward $POD_NAME 3000 | kubectl --namespace default port-forward $POD_NAME 3000 | ||
− | error: unable to forward port because pod is not running. Current status=Pending | + | [[error: unable to forward port because pod is not running. Current status=Pending]] |
kubectl --namespace default port-forward $POD_NAME 3000 | kubectl --namespace default port-forward $POD_NAME 3000 | ||
Line 36: | Line 47: | ||
See '[[kubectl port-forward -h]]' for help and examples | See '[[kubectl port-forward -h]]' for help and examples | ||
+ | kubectl port-forward service/my-argo-argocd-server -n default 8080:443 | ||
+ | [[error: timed out waiting for the condition]] | ||
Line 47: | Line 60: | ||
* <code>[[kubectl proxy]]</code> | * <code>[[kubectl proxy]]</code> | ||
* [[Kubernetes networking]] | * [[Kubernetes networking]] | ||
+ | * <code>[[kubectl get services]]</code> | ||
+ | * <code>[[kubectl create service clusterip]]</code> | ||
+ | * <code>[[minikube tunnel]]</code> | ||
== See also == | == See also == |
Latest revision as of 07:39, 9 July 2024
kubectl port-forward
forward one or more local ports to a pod.
- Man: https://www.mankier.com/1/kubectl-port-forward
kubectl port-forward --help
kubectl port-forward deployment/mydeployment 8080:443
kubectl port-forward deployment/mydeployment 8080:443 &
Examples[edit]
- Grafana:
kubectl --namespace default port-forward $POD_NAME 3000
- Prometheus:
kubectl --namespace default port-forward $POD_NAME 9090
kubectl port-forward --namespace default svc/prometheus-kube-prometheus-prometheus 9090:9090
- Alertmanager:
kubectl port-forward --namespace default svc/prometheus-kube-prometheus-alertmanager 9093:9093
kubectl port-forward svc/argocd-server -n argocd 8080:443
Forwarding from 127.0.0.1:8080 -> 8080
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 kubectl -n your-namespace port-forward service/pritunl-ui 7111:443
List of ports, do not included port-forward
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[edit]
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
kubectl port-forward service/my-argo-argocd-server -n default 8080:443 error: timed out waiting for the condition
bind: address alredy in use unable to create listener
Solution: lsof -i
Related[edit]
kubectl get pods
- Port forwarding
kubectl proxy
- Kubernetes networking
kubectl get services
kubectl create service clusterip
minikube tunnel
See also[edit]
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
Advertising: