Skip to content

Latest commit

 

History

History
109 lines (75 loc) · 3.08 KB

getting-into-containers.md

File metadata and controls

109 lines (75 loc) · 3.08 KB
Raw

WARNING WARNING WARNING WARNING WARNING

PLEASE NOTE: This document applies to the HEAD of the source tree

If you are using a released version of Kubernetes, you should refer to the docs that go with that version.

The latest 1.0.x release of this document can be found [here](http://releases.k8s.io/release-1.0/docs/user-guide/getting-into-containers.md).

Documentation for other releases can be found at releases.k8s.io.

Getting into containers: kubectl exec

Developers can use kubectl exec to run commands in a container. This guide demonstrates two use cases.

Using kubectl exec to check the environment variables of a container

Kubernetes exposes services through environment variables. It is convenient to check these environment variables using kubectl exec.

We first create a pod and a service,

$ kubectl create -f examples/guestbook/redis-master-controller.yaml
$ kubectl create -f examples/guestbook/redis-master-service.yaml

wait until the pod is Running and Ready,

$ kubectl get pod
NAME                 READY     REASON       RESTARTS   AGE
redis-master-ft9ex   1/1       Running      0          12s

then we can check the environment variables of the pod,

$ kubectl exec redis-master-ft9ex env
...
REDIS_MASTER_SERVICE_PORT=6379
REDIS_MASTER_SERVICE_HOST=10.0.0.219
...

We can use these environment variables in applications to find the service.

Using kubectl exec to check the mounted volumes

It is convenient to use kubectl exec to check if the volumes are mounted as expected. We first create a Pod with a volume mounted at /data/redis,

kubectl create -f docs/user-guide/walkthrough/pod-redis.yaml

wait until the pod is Running and Ready,

$ kubectl get pods
NAME      READY     REASON    RESTARTS   AGE
storage   1/1       Running   0          1m

we then use kubectl exec to verify that the volume is mounted at /data/redis,

$ kubectl exec storage ls /data
redis

Using kubectl exec to open a bash terminal in a pod

After all, open a terminal in a pod is the most direct way to introspect the pod. Assuming the pod/storage is still running, run

$ kubectl exec -ti storage -- bash
root@storage:/data#

This gets you a terminal.

Analytics