Cómo acceder al almacenamiento persistente

En esta página, se explica cómo crear y administrar el almacenamiento persistente para las cargas de trabajo de contenedores en tu dispositivo de appliance aislado de Google Distributed Cloud (GDC). El almacenamiento persistente proporciona a tu aplicación identidades coherentes y nombres de host estables, independientemente de dónde se programen sus cargas de trabajo.

Esta página está destinada a los desarrolladores del grupo de operadores de aplicaciones, que son responsables de crear cargas de trabajo de aplicaciones para su organización.

Antes de comenzar

Para completar las tareas de este documento, debes solicitar los permisos necesarios y preparar tu entorno.

Solicita roles de IAM

Para crear, borrar, editar o ver volúmenes persistentes en un clúster de Kubernetes, pídele a tu administrador de IAM de la organización que te otorgue el rol de Administrador de espacio de nombres (namespace-admin). Este rol está vinculado al espacio de nombres de tu proyecto.

Prepara el entorno

Para ejecutar comandos en el clúster de Kubernetes de hardware físico preconfigurado, asegúrate de tener los siguientes recursos:

  1. Ubica el nombre del clúster de Kubernetes o pregúntale a tu administrador de la plataforma cuál es el nombre del clúster.

  2. Accede y genera el archivo kubeconfig para el clúster de Kubernetes si no tienes uno.

  3. Usa la ruta de acceso kubeconfig del clúster de Kubernetes para reemplazar CLUSTER_KUBECONFIG en estas instrucciones.

Crea un volumen persistente

En las siguientes instrucciones, se muestra cómo crear un volumen con la StorageClass standard-rwo de GDC. Para obtener más información sobre los recursos StorageClass disponibles en GDC, consulta Almacenamiento persistente para contenedores.

  1. Crea un PersistentVolumeClaim y configúralo con un modo de acceso ReadWriteOnce y una clase de almacenamiento standard-rwo:

    kubectl --kubeconfig CLUSTER_KUBECONFIG \
    --namespace NAMESPACE apply -f - <<EOF
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: PVC_NAME
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi
  storageClassName: standard-rwo
EOF

    Reemplaza lo siguiente:

    • CLUSTER_KUBECONFIG: El archivo kubeconfig del clúster de Kubernetes

    • NAMESPACE: El espacio de nombres del proyecto en el que se creará la PVC

    • PVC_NAME: El nombre del objeto PersistentVolumeClaim

  2. Los objetos PersistentVolume (PV) se aprovisionan de forma dinámica. Verifica el estado de las nuevas PV en tu clúster de Kubernetes:

    kubectl get pv --kubeconfig CLUSTER_KUBECONFIG

    El resultado es similar a este:

    NAME       CAPACITY   ACCESS MODES   STATUS      CLAIM     STORAGECLASS   AGE
pvc-uuidd  10Gi       RWO            Bound       pvc-name  standard-rwo   60s

  3. Configura tus cargas de trabajo de contenedores para usar la PVC. El siguiente es un ejemplo de un pod nginx que usa una PVC standard-rwo:

    kubectl --kubeconfig CLUSTER_KUBECONFIG \
    --namespace NAMESPACE apply -f - <<EOF
apiVersion: apps/v1
kind: Pod
metadata:
  name: web-server-deployment
  labels:
    app: nginx
spec:
  containers:
  - name: nginx
    image: nginx
    volumeMounts:
    - mountPath: /usr/share/nginx/html
      name: data
  volumes:
  - name: data
    persistentVolumeClaim:
      claimName: PVC_NAME
EOF

    Reemplaza PVC_NAME por la PVC que creaste.

Expande la capacidad del volumen

Para aumentar la capacidad de un objeto PersistentVolumeClaim, actualiza el campo spec.resources.storage a la nueva capacidad. El tamaño máximo de volumen admitido es de 14.5 Ti.

  1. Actualiza el volumen a un tamaño más grande en el archivo de manifiesto del objeto PersistentVolumeClaim:

    kubectl --kubeconfig CLUSTER_KUBECONFIG \
    --namespace NAMESPACE apply -f - <<EOF
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: PVC_NAME
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: VOLUME_STORAGE_SIZE
EOF

    Reemplaza lo siguiente:

    • CLUSTER_KUBECONFIG: El archivo kubeconfig del clúster de Kubernetes

    • NAMESPACE: El espacio de nombres del proyecto en el que existe el recurso de PVC

    • PVC_NAME: El nombre de la PVC para la que aumentas el tamaño de almacenamiento

    • VOLUME_SNAPSHOT_SIZE: La cantidad de tamaño de almacenamiento que se aumentará, como 50Gi

  2. Verifica el estado de las PV actualizadas en tu clúster:

    kubectl get pv --kubeconfig CLUSTER_KUBECONFIG

¿Qué sigue?