Container Service for Kubernetes:Use HostPath volumes

Visão geral do processo

Após o agendamento de um pod em um nó, o kubelet monta o volume HostPath antes do início do container. Ele valida e prepara o caminho do host definido em path com base no type da configuração hostPath.

• DirectoryOrCreate: Verifica se o path do host existe. Caso não exista, cria um diretório vazio com permissões 0755, com proprietário e grupo correspondentes aos do kubelet.

• Directory: Confirma se o path do host existe e é um diretório. Se a condição não for atendida, o pod falha ao iniciar.

• FileOrCreate: Verifica se o path do host existe. Na ausência do arquivo, cria um arquivo vazio com permissões 0644, com proprietário e grupo correspondentes aos do kubelet.

• File: Confirma se o path do host existe e é um arquivo. Se a condição não for atendida, o pod falha ao iniciar.

Após a validação, o kubelet faz a montagem bind do path do host no container. Todas as operações de leitura e escrita no ponto de montagem são direcionadas ao sistema de arquivos do nó host.

Métodos de uso

• Montar um volume HostPath diretamente em um pod: Defina o hostPath diretamente na seção volumes do manifesto do pod. Esta abordagem é simples, mas acopla fortemente o armazenamento à aplicação. Não recomendada para cargas de trabalho de produção que exigem manutenção de longo prazo ou podem precisar de alterações no armazenamento.

• Montar um volume HostPath usando PV e PVC: Defina o hostPath em um PV independente, solicitado pelo pod via PVC. Este método desacopla o armazenamento da aplicação, permitindo gerenciar o armazenamento de forma independente sem modificar a configuração do pod.

1. Crie um arquivo chamado pod-hostpath-direct.yaml.

   Monta o diretório /data do nó em /test no pod.

   apiVersion: v1
   kind: Pod
   metadata:
     name: test-pod
   spec:
     containers:
     - image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
       name: test-container
       volumeMounts:
       - mountPath: /test
         name: test-volume
     volumes:
     - name: test-volume
       hostPath:
         # Specify the path on the host node.
         path: /data
         # Specify the volume type.
         type: DirectoryOrCreate

2. Implante o pod.

   kubectl apply -f pod-hostpath-direct.yaml

3. Verifique a montagem.

   Crie um arquivo dentro do pod e confirme sua existência no nó.

   1. Crie um arquivo no pod.

      Crie o arquivo test.txt no diretório /test (ponto de montagem) do pod.

      kubectl exec test-pod -- sh -c 'echo "This file was created from within the Pod." > /test/test.txt'

   2. Obtenha o nome do nó onde o pod está em execução.

      NODE_NAME=$(kubectl get pod test-pod -o jsonpath='{.spec.nodeName}')
      echo "Pod is running on node: $NODE_NAME"

   3. Verifique o arquivo no nó.

      Faça logon no nó e execute ls /data para verificar se o arquivo existe no diretório /data.

      Se a saída incluir test.txt, o volume HostPath foi montado com sucesso.

1. Crie um arquivo chamado pv-pvc-hostpath.yaml.

   Cria um PV apontando para o diretório /data do host, um PVC que solicita o armazenamento e um pod que utiliza o PVC.

   # --- PersistentVolume definition ---
   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: hostpath-pv
     labels:
       type: local
   spec:
     capacity:
       storage: 10Gi
     accessModes:
       - ReadWriteOnce
     hostPath:
       path: "/data"
   ---
   # --- PersistentVolumeClaim definition ---
   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: hostpath-pvc
   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 10Gi
     # Use a selector to bind the PVC to the PV created earlier.
     selector:
       matchLabels:
         type: local
   ---
   # --- Pod definition ---
   apiVersion: v1
   kind: Pod
   metadata:
     name: test-pod-pvc
   spec:
     containers:
       - name: test-container
         image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
         ports:
           - containerPort: 80
         volumeMounts:
           - mountPath: "/usr/share/nginx/html"
             name: storage
     volumes:
       - name: storage
         persistentVolumeClaim:
           # Reference the PVC defined earlier.
           claimName: hostpath-pvc

2. Crie o PV, o PVC e o pod.

   kubectl apply -f pv-pvc-hostpath.yaml

3. Verifique a montagem.

   Crie um arquivo dentro do pod e confirme sua existência no nó.

   1. Crie um arquivo no pod.

      Crie o arquivo test.txt no diretório /usr/share/nginx/html (ponto de montagem) do pod.

      kubectl exec test-pod-pvc -- sh -c 'echo "File from PV/PVC Pod." > /usr/share/nginx/html/test.txt'

   2. Obtenha o nome do nó onde o pod está em execução.

      NODE_NAME=$(kubectl get pod test-pod-pvc -o jsonpath='{.spec.nodeName}')
      echo "Pod is running on node: $NODE_NAME"

   3. Verifique o arquivo no nó.

      Faça logon no nó e execute ls /data para verificar se o arquivo existe no diretório /data.

      Se a saída incluir test.txt, o volume HostPath via PV/PVC foi montado com sucesso.