Difference between revisions of "Kubectl port-forward"
Jump to navigation
Jump to search
(Created page with "{{Draft}} * <code>kubectl --namespace default port-forward $POD_NAME 3000</code> == See also == * {{kubectl}} Category:Kubernetes") Tags: Mobile web edit, Mobile edit |
|||
(59 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{lowercase}} |
+ | <code>[[kubectl]] [[port-forward]]</code> [[forward]] one or more local ports to a [[pod]]. | ||
+ | * 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 == | ||
+ | * [[Grafana]]: <code>kubectl --namespace default port-forward [[$POD_NAME]] [[3000]]</code> | ||
+ | * [[Prometheus]]: | ||
+ | ** <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}") | ||
+ | |||
+ | 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 <code>[[port-forward]]</code> 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 | ||
+ | |||
+ | 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: <code>[[lsof -i]]</code> | ||
+ | |||
+ | == Related == | ||
+ | * <code>[[kubectl get pods]]</code> | ||
+ | * [[Port forwarding]] | ||
+ | * <code>[[kubectl proxy]]</code> | ||
+ | * [[Kubernetes networking]] | ||
+ | * <code>[[kubectl get services]]</code> | ||
+ | * <code>[[kubectl create service clusterip]]</code> | ||
+ | * <code>[[minikube tunnel]]</code> | ||
== See also == | == See also == | ||
− | * {{kubectl}} | + | * {{kubectl port-forward}} |
+ | * {{Kubernetes networking}} | ||
+ | * {{Kubernetes services}} | ||
[[Category:Kubernetes]] | [[Category:Kubernetes]] |
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: