220628_4_k8s_볼륨_hostPath

hostPath

---

hostPath란

파드가 실행된 호스트의 파일이나 디렉토리를 파드에 마운트

• 호스트에 있는 실제 파일이나 디렉토리를 마운트함
• 파드를 재시작하더라도 호스트에 데이터가 남아있음
• 호스트의 중요 디렉토리를 컨테이너에 마운트해서 사용할 수 있음
• 쿠버네티스 클러스터 노드에 로그 파일을 저장하거나 CA 인증서 및 토큰을 파드에 제공하기 위한 용도로 사용 가능
• 도커 시스템용 디렉토리를 컨테이너에서 사용할 때나 시스템용 디렉토리를 마운트해서 시스템을 모니터링하는 용도로 사용 가능

 

---

 

hostPath 실습

사전 작업

• kube-node1 노드에 접속
• /web_contents 디렉토리 생성
• 디렉토리 안에 index.html 파일 생성

vagrant@kube-master1:~$ ssh vagrant@192.168.56.21

vagrant@kube-node1:~$ sudo mkdir /web_contents

vagrant@kube-node1:~$ echo "hello hostPath Volumes" | sudo tee /web_contents/index.html
hello hostPath Volumes

 

hostPath 구성

• 레플리카셋 생성 파일
• 1. .spec.containers[].volumeMounts: 볼륨 마운트 설정
• .name: web-content 볼륨 이름 지정
• .mountPath: 볼륨을 컨테이너의 /usr/share/nginx/html 디렉토리에 마운트하도록 설정
• 2. .spec.volumes: 볼륨 설정
• .name: 볼륨 이름 설정
• . type: 설정한 경로 타입
• .hostPath.path: 호스트의 볼륨 디렉토리 설정

vagrant@kube-master1:~/hostPath$ cat myapp-rs-hp.yml
apiVersion: apps/v1
kind: ReplicaSet
metadata:
  name: myapp-rs-hp
spec:
  replicas: 2
  selector:
    matchLabels:
      app: myapp-rs-hp
  template:
    metadata:
      labels:
        app: myapp-rs-hp
    spec:

      containers:
      - name: web-server
        image: nginx:alpine
        volumeMounts:	#----------------------------1
        - name: web-content
          mountPath: /usr/share/nginx/html
        ports:
        - containerPort: 80
      volumes:	#----------------------------2
      - name: web-content
        hostPath:
          type: Directory
          path: /web_contents

 

• 서비스 생성 파일

vagrant@kube-master1:~/hostPath$ cat myapp-svc-hp.yml
apiVersion: v1
kind: Service
metadata:
  name: myapp-svc-hp
spec:
  type: LoadBalancer
  ports:
  - port: 80
    targetPort: 80
  selector:
    app: myapp-rs-hp

 

• 레플리카셋, 서비스 생성

vagrant@kube-master1:~/hostPath$ kubectl create -f myapp-rs-hp.yml -f myapp-svc-hp.yml
replicaset.apps/myapp-rs-hp created
service/myapp-svc-hp created

 

실행 결과

• myapp-rs-hp 파드 2개 생성
• myapp-rs-hp 레플리카셋 생성
• myapp-svc-hp 로드밸런서 생성
• 오류 발생: 한 개의 파드가 제대로 실행되지 않음 (CotainerCreating 상태가 지속됨)

vagrant@kube-master1:~/hostPath$ kubectl get all
NAME                         READY   STATUS              RESTARTS   AGE
pod/myapp-rs-hp-6bcn8        0/1     ContainerCreating   0          10s
pod/myapp-rs-hp-thfgp        1/1     Running             0          10s

NAME                        TYPE           CLUSTER-IP      EXTERNAL-IP      PORT(S)        AGE
service/myapp-svc-hp        LoadBalancer   10.233.46.71    192.168.56.201   80:31404/TCP   10s

NAME                               DESIRED   CURRENT   READY   AGE
replicaset.apps/myapp-rs-hp        2         2         1       10s

 

• 실행되지 않는 파드의 이벤트 확인
• 볼륨 마운트에 실패함

vagrant@kube-master1:~/hostPath$ kubectl describe pods myapp-rs-hp-6bcn8
Events:
  Type     Reason       Age                   From               Message
  ----     ------       ----                  ----               -------
  Normal   Scheduled    8m46s                 default-scheduler  Successfully assigned default/myapp-rs-hp-6bcn8 to kube-node2
  Warning  FailedMount  4m26s                 kubelet            Unable to attach or mount volumes: unmounted volumes=[web-content], unattached volumes=[default-token-wl2vl web-content]: timed out waiting for the condition
  Warning  FailedMount  2m8s (x2 over 6m44s)  kubelet            Unable to attach or mount volumes: unmounted volumes=[web-content], unattached volumes=[web-content default-token-wl2vl]: timed out waiting for the condition
  Warning  FailedMount  33s (x12 over 8m47s)  kubelet            MountVolume.SetUp failed for volume "web-content" : hostPath type check failed: /web_contents is not a directory

 

• 실행되고 있는 파드의 이벤트 확인
• 마운트에 실패한 파드의 이벤트와 비교

vagrant@kube-master1:~/hostPath$ kubectl describe pods myapp-rs-hp-thfgp
Events:
  Type    Reason     Age   From               Message
  ----    ------     ----  ----               -------
  Normal  Scheduled  11m   default-scheduler  Successfully assigned default/myapp-rs-hp-thfgp to kube-node1
  Normal  Pulling    11m   kubelet            Pulling image "nginx:alpine"
  Normal  Pulled     10m   kubelet            Successfully pulled image "nginx:alpine"
  Normal  Created    10m   kubelet            Created container web-server
  Normal  Started    10m   kubelet            Started container web-server

 

• 파드가 생성된 노드의 위치 확인
• 정상 실행 중인 파드는 kube-node1에 생성됨
• 마운트에 실패한 파드는 kube-node2에 생성된 것을 확인
• kube-node2에 /web_contents 디렉토리가 존재하지 않아 마운트에 실패했다는 것을 알 수 있음

vagrant@kube-master1:~/hostPath$ kubectl get pods -o wide
NAME                     READY   STATUS              RESTARTS   AGE    IP              NODE         NOMINATED NODE   READINESS GATES
myapp-rs-hp-6bcn8        0/1     ContainerCreating   0          14m    <none>          kube-node2   <none>           <none>
myapp-rs-hp-thfgp        1/1     Running             0          14m    10.233.101.92   kube-node1   <none>           <none>

 

오류 해결

• 파드를 kube-node1 노드에 생성하여 볼륨을 공유하도록 구성
• 리플리카셋 생성 파일에서 파드를 생성할 노드 지정
• .spec.template.spec.nodename=kube-node1 추가

vagrant@kube-master1:~/hostPath$ cat myapp-rs-hp.yml
apiVersion: apps/v1
kind: ReplicaSet
metadata:
  name: myapp-rs-hp
spec:
  replicas: 2
  selector:
    matchLabels:
      app: myapp-rs-hp
  template:
    metadata:
      labels:
        app: myapp-rs-hp
    spec:
      nodeName: kube-node1	# 추가
      containers:
      - name: web-server
        image: nginx:alpine
        volumeMounts:
        - name: web-content
          mountPath: /usr/share/nginx/html
        ports:
        - containerPort: 80
      volumes:
      - name: web-content
        hostPath:
          type: Directory
          path: /web_contents

 

• 레플리카셋 삭제 후 다시 생성

vagrant@kube-master1:~/hostPath$ kubectl delete -f myapp-rs-hp.yml
replicaset.apps "myapp-rs-hp" deleted

vagrant@kube-master1:~/hostPath$ kubectl create -f myapp-rs-hp.yml
replicaset.apps/myapp-rs-hp created

 

• 생성된 파드 정보 확인
• 두 개의 파드 모두 kube-node1 노드에 생성되어 정상 실행되고 있음

vagrant@kube-master1:~/hostPath$ kubectl get svc,pods -o wide
NAME                        TYPE           CLUSTER-IP      EXTERNAL-IP      PORT(S)        AGE     SELECTOR
service/myapp-svc-hp        LoadBalancer   10.233.46.71    192.168.56.201   80:31404/TCP   23m     app=myapp-rs-hp

NAME                         READY   STATUS    RESTARTS   AGE     IP              NODE         NOMINATED NODE   READINESS GATES
pod/myapp-rs-hp-lpfq6        1/1     Running   0          2m36s   10.233.101.93   kube-node1   <none>           <none>
pod/myapp-rs-hp-vg98c        1/1     Running   0          2m36s   10.233.101.94   kube-node1   <none>           <none>

 

• 각 파드에서 동일한 볼륨에 마운트되었는지 확인

vagrant@kube-master1:~/hostPath$ kubectl exec myapp-rs-hp-lpfq6 -- cat /usr/share/nginx/html/index.html
hello hostPath Volumes

vagrant@kube-master1:~/hostPath$ kubectl exec myapp-rs-hp-vg98c -- cat /usr/share/nginx/html/index.html
hello hostPath Volumes

# 로드밸런서 연결 확인
vagrant@kube-master1:~/hostPath$ kubectl run nettool -it --image=c1t1d0s7/network-multitool --rm=true bash
If you don't see a command prompt, try pressing enter.
bash-5.0#
bash-5.0# curl http://myapp-svc-hp
hello hostPath Volumes
bash-5.0# curl http://10.233.46.71
hello hostPath Volumes
bash-5.0# curl http://192.168.56.201
hello hostPath Volumes