Reaching a pod while testing
Created · Updated
A pod’s IP address works only inside the cluster, as the network model describes, so a laptop can’t open it directly. Before a pod has a Service, or when a Service doesn’t work, there are three ways to talk to it straight away:
- From a node: open a shell on a node and connect to the pod IP. The model requires that a node reach its own pods, so from the pod’s own node this has the fewest hops.
- From another pod: start a temporary pod with a client tool and connect to the pod IP over the pod network.
- With port forwarding:
kubectl port-forwardlistens on a local port on the laptop and carries each connection through the Kubernetes API to the pod.
Each route passes through more parts than the one before. When a connection fails, trying the shortest route first shows whether the pod itself answers, before the pod network or the API is involved.
From a node
How to get a shell on a node depends on the cluster: kind nodes are Docker containers, minikube has minikube ssh, and cloud nodes take SSH.
docker exec -it kind-worker bashdocker execRun a command in a running container, here a kind node.-itKeep input open and give it a terminal, for an interactive shell.kind-workerThe node that runs pod web.bashThe command: a shell.
From that shell, curl 10.244.2.9 returned nginx’s page. nginx logged the client as 10.244.2.1, not the node’s address 172.21.0.4: the node reaches its pods through their veth pairs, and gives each veth on its side the address 10.244.2.1.
From another pod
A pod that runs one command and is deleted afterwards tests the pod network the way other pods use it:
kubectl run tmp --rm -i --restart=Never --image=curlimages/curl:8.11.1 -- curl http://10.244.2.9kubectl run tmpCreate a pod named tmp.--rmDelete it when the command ends.-iKeep input open and show the output.--restart=NeverCreate a plain pod that isn’t restarted.--image=curlimages/curl:8.11.1An image with curl in it.--Ends kubectl’s options; the rest is the command.curl http://10.244.2.9The command the pod runs.
The pod landed on kind-worker2, and nginx logged the client as 10.244.1.7, the temporary pod’s own IP.
With port forwarding
Port forwarding needs no pod IP, only the pod’s name and port, and works from any machine where kubectl can reach the API server:
kubectl port-forward pod/web 8080:80kubectl port-forwardListen on a local port and forward connections to a pod.pod/webThe pod. A Deployment or Service name also works; kubectl then picks one of its pods.8080:80Local port 8080 to the pod’s port 80. With one number, both ports are the same.
It printed Forwarding from 127.0.0.1:8080 -> 80 and the same for [::1], and stays in the foreground until stopped. In a second terminal, curl localhost:8080 returned nginx’s page. The connection travels as a stream from kubectl to the API serverAPI server The control plane component that serves the Kubernetes API. Every other component, and every tool such as kubectl, reads and changes cluster state only through it., which passes it to the kubeletkubelet The agent that runs on each node in a Kubernetes cluster and makes sure the containers in its pods are running. on the pod’s node; the API server’s connections to kubelets exist for logs, attaching, and port forwarding. The connection to the pod is opened inside the pod’s own network namespacenetwork namespace A Linux namespace that gives a group of processes their own network interfaces, IP addresses, routes, and ports. The containers in a pod share one., so nginx logged the client as 127.0.0.1.
- It forwards TCPTCP Transmission Control Protocol: the transport protocol that gives two programs a reliable, ordered stream of bytes over IP, on a connection opened with a handshake. only.
- It needs permission to create
pods/portforward. It reaches the pod without crossing the pod network, and the docs warn that it may bypass network-level controls. - It’s for testing: one kubectl process, one laptop, and it stops when kubectl stops.
References: Use port forwarding to access applications in a cluster (Kubernetes docs), Communication between nodes and the control plane (Kubernetes docs), kubectl run (Kubernetes docs)