Acceder al almacenamiento persistente

En esta página se explica cómo crear y gestionar el almacenamiento persistente para cargas de trabajo de contenedores en tu universo soberano 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á dirigida a los desarrolladores del grupo de operadores de aplicaciones, que son responsables de crear cargas de trabajo de aplicaciones para su organización. Para obtener más información, consulta Audiencias de la documentación aislada de GDC.

Antes de empezar

Para ejecutar comandos en un clúster de Kubernetes, asegúrate de que tienes los siguientes recursos:

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

  2. Inicia sesión y genera el archivo kubeconfig del clúster de Kubernetes si no tienes uno.

  3. Usa la ruta kubeconfig del clúster de Kubernetes para sustituir KUBERNETES_CLUSTER_KUBECONFIG en estas instrucciones.

Para obtener los permisos necesarios para crear un volumen persistente, pide al administrador de gestión de identidades y accesos de tu organización que te conceda el rol Administrador de espacio de nombres (namespace-admin) en el espacio de nombres de tu proyecto.

Crear un volumen persistente

En las siguientes instrucciones se muestra cómo crear un volumen con la GDC standard-rwo StorageClass. Para obtener más información sobre los recursos de StorageClass disponibles en GDC, consulta el artículo sobre el 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 KUBERNETES_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

    Haz los cambios siguientes:

    • KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster.

    • NAMESPACE: el espacio de nombres del proyecto en el que se va a crear el PVC.

    • PVC_NAME: el nombre del objeto PersistentVolumeClaim.

  2. Los objetos PersistentVolume (PV) se aprovisionan de forma dinámica. Comprueba el estado de los nuevos PVs en tu clúster de Kubernetes:

    kubectl get pv --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG

    El resultado debería ser similar al siguiente:

    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 contenedor para que usen el PVC. A continuación, se muestra un ejemplo de un pod nginx que usa un PVC standard-rwo:

    kubectl --kubeconfig KUBERNETES_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

    Sustituye PVC_NAME por el PVC que has creado.

Ampliar la capacidad de volumen

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

  1. Actualiza el volumen a un tamaño mayor en el archivo de manifiesto del objeto PersistentVolumeClaim:

    kubectl --kubeconfig KUBERNETES_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

    Haz los cambios siguientes:

    • KUBERNETES_CLUSTER_KUBECONFIG: el archivo kubeconfig del clúster.

    • NAMESPACE: el espacio de nombres del proyecto en el que se encuentra el recurso PVC.

    • PVC_NAME: el nombre del PVC cuyo tamaño de almacenamiento quieres aumentar.

    • VOLUME_SNAPSHOT_SIZE: cantidad de almacenamiento que se va a aumentar, como 50Gi.

  2. Comprueba el estado de los PVs actualizados en tu clúster:

    kubectl get pv --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG

Siguientes pasos