Kubernetes►Kubectl

【kebectl]】Pod を作成する

Pod の設定ファイルを記述する

Nginx のコンテナを含む Pod を設定する。

1
2
3
4
5
6
7
8
9
10
apiVersion: v1
kind: Pod
metadata:
  name: sample-pod
spec:
  containers:
    - name: nginx-container
      image: nginx:1.12
      ports:
        - containerPort: 80

Pod を起動する

1
2
>kubectl create -f sample-pod.yml
pod/sample-pod created

起動状態を確認する

起動直後はコンテナを生成する。このとき、POD の状態はコンテナの作成中を意味する ContainerCreating になる。

1
2
3
>kubectl get pod
NAME         READY   STATUS              RESTARTS   AGE
sample-pod   0/1     ContainerCreating   0          8s

作成を開始してからしばらく経つと、コンテナが起動する。

1
2
3
>kubectl get pods
NAME         READY   STATUS    RESTARTS   AGE
sample-pod   1/1     Running   0          4m11s

Pod の状態を出力するときに、-o wide オプションを付与すると、表示内容を増やすことができる。

1
2
3
D:\working\temp\kubernetes\pod>kubectl get pods sample-pod -o wide
NAME         READY   STATUS    RESTARTS   AGE   IP           NODE       NOMINATED NODE   READINESS GATES
sample-pod   1/1     Running   0          68m   172.17.0.6   minikube   <none>           <none>

-o オプションは表示内容のフォーマットを変更するオプションで以下のフォーマットに対応している。

1
2
3
4
5
6
7
8
9
>kubectl get pods sample-pod --help
...
  -o, --output='': Output format. One of:
json|yaml|wide|name|custom-columns=...|custom-columns-file=...|go-template=...|go-template-file=...|jsonpath=...|jsonpath-file=...
See custom columns [http://kubernetes.io/docs/user-guide/kubectl-overview/#custom-columns], golang template
[http://golang.org/pkg/text/template/#pkg-overview] and jsonpath template
[http://kubernetes.io/docs/user-guide/jsonpath].
      --output-watch-events=false: Output watch event objects when --watch or --watch-only is used. Existing objects are
...

詳細情報を出力するには、kubectl discribe コマンドを実行する。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
>kubectl describe pods sample-pod
Name:         sample-pod
Namespace:    default
Priority:     0
Node:         minikube/192.168.99.101
Start Time:   Wed, 05 Feb 2020 16:14:23 +0900
Labels:       <none>
Annotations:  kubectl.kubernetes.io/last-applied-configuration:
                {"apiVersion":"v1","kind":"Pod","metadata":{"annotations":{},"name":"sample-pod","namespace":"default"},"spec":{"containers":[{"image":"ng...
Status:       Running
IP:           172.17.0.6
IPs:
  IP:  172.17.0.6
Containers:
  nginx-container:
    Container ID:   docker://3bb3512d4603eb773223b30dbc184df153e8846d6fd7b6990de42bdc9cfe1949
    Image:          nginx:1.17
    Image ID:       docker-pullable://nginx@sha256:ad5552c786f128e389a0263104ae39f3d3c7895579d45ae716f528185b36bc6f
    Port:           80/TCP
    Host Port:      0/TCP
    State:          Running
      Started:      Wed, 05 Feb 2020 18:24:15 +0900
    Last State:     Terminated
      Reason:       Completed
      Exit Code:    0
      Started:      Wed, 05 Feb 2020 16:14:38 +0900
      Finished:     Wed, 05 Feb 2020 18:24:02 +0900
    Ready:          True
    Restart Count:  1
    Environment:    <none>
    Mounts:
      /var/run/secrets/kubernetes.io/serviceaccount from default-token-7sf75 (ro)
Conditions:
  Type              Status
  Initialized       True
  Ready             True
  ContainersReady   True
  PodScheduled      True
Volumes:
  default-token-7sf75:
    Type:        Secret (a volume populated by a Secret)
    SecretName:  default-token-7sf75
    Optional:    false
QoS Class:       BestEffort
Node-Selectors:  <none>
Tolerations:     node.kubernetes.io/not-ready:NoExecute for 300s
                 node.kubernetes.io/unreachable:NoExecute for 300s
Events:
  Type    Reason   Age                 From               Message
  ----    ------   ----                ----               -------
  Normal  Killing  75s                 kubelet, minikube  Container nginx-container definition changed, will be restarted
  Normal  Pulling  75s                 kubelet, minikube  Pulling image "nginx:1.17"
  Normal  Created  62s (x2 over 130m)  kubelet, minikube  Created container nginx-container
  Normal  Started  62s (x2 over 130m)  kubelet, minikube  Started container nginx-container
  Normal  Pulled   62s                 kubelet, minikube  Successfully pulled image "nginx:1.17"

リソースファイルを編集して Pod を再起動する

リソースファイルを変更した場合は、kubectl apply コマンドで変更を伝える。

1
2
>kubectl apply -f sample-pod.yml
pod/sample-pod configured

起動に失敗する例

-すでに起動済みの場合

1
2
>kubectl create -f sample-pod.yml
Error from server (AlreadyExists): error when creating "sample-pod.yml": pods "sample-pod" already exists

リソースファイルに変更がなかったり、リーソースファイルが存在しない場合は Pod は起動しない。

-リソースファイルに変更がない場合

1
2
>kubectl apply -f sample-pod.yml
pod/sample-pod unchanged

-リソースファイルが見つからない場合

1
2
>kubectl apply -f sample-pod-dummy.yml
error: the path "sample-pod-dummy.yml" does not exist