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 completar las tareas de este documento, debes tener los siguientes recursos y roles:

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

    • Busca el nombre del clúster de Kubernetes o pregunta a un miembro del grupo de administradores de la plataforma cuál es el nombre del clúster.

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

    • 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 en un clúster compartido, 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.

  • Para obtener los permisos necesarios para crear un volumen persistente en un clúster estándar, pide al administrador de gestión de identidades y accesos de tu organización que te asigne el rol de desarrollador de clúster (cluster-developer) en tu clúster estándar.

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 recurso PersistentVolumeClaim (PVC) 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 en el que se va a crear el PVC. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. En el caso de los clústeres estándar, puede ser cualquier espacio de nombres.

    • PVC_NAME: el nombre del objeto PersistentVolumeClaim.

  2. Confirma que el objeto PVC está disponible:

    kubectl get pvc --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    --namespace NAMESPACE

    El resultado debería ser similar al siguiente:

    NAME       CAPACITY   ACCESS MODES   STATUS      CLAIM     STORAGECLASS   AGE
pvc-uuid   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: 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 en el que se encuentra el recurso PVC. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. En los clústeres estándar, puede ser cualquier espacio de nombres.

    • 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