Accede al almacenamiento persistente

El almacenamiento persistente en Google Distributed Cloud (GDC) aislado te permite conservar los datos de los contenedores de forma independiente de los ciclos de vida de los Pods. Puedes reclamar volúmenes con recursos PersistentVolumeClaim (PVC) y expandir la capacidad para conservar el estado en los reinicios y las reprogramaciones.

Este documento está dirigido a los desarrolladores del grupo de operadores de aplicaciones que crean cargas de trabajo para su organización. Para obtener más información, consulta Públicos de la documentación de GDC aislado.

Antes de comenzar

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

Solicita roles de IAM

Debes tener roles específicos para obtener los permisos que necesitas para acceder al almacenamiento persistente. Los roles que necesitas dependen de si trabajas en un clúster compartido con alcance de organización o en un clúster estándar con alcance de proyecto. Para obtener más información, consulta Configuraciones de clústeres de Kubernetes.

Roles de clúster compartidos

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

Roles de clúster estándar

Para crear, borrar, editar o ver volúmenes persistentes en un clúster estándar, pídele al administrador de proyectos de IAM que te otorgue el rol de desarrollador de clústeres (cluster-developer). Este rol está vinculado al espacio de nombres de tu proyecto.

Prepara el entorno

Para ejecutar comandos en un clúster de Kubernetes con la API, asegúrate de tener los siguientes recursos:

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

  • Accede y genera el archivo kubeconfig para el clúster de Kubernetes.

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

Crea un volumen persistente

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

    Reemplaza lo siguiente:

    • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster.

    • NAMESPACE: Es el espacio de nombres en el que se creará la PVC. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. Para los clústeres estándar, puede ser cualquier espacio de nombres.

    • PVC_NAME: Es el nombre del objeto PersistentVolumeClaim.

  2. Confirma que el objeto PVC esté disponible:

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

    El resultado es similar a lo 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 contenedores para que usen la PVC. A continuación, se muestra un Pod de nginx de ejemplo que usa un PVC de 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

    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 capacidad nueva. 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

    Reemplaza lo siguiente:

    • KUBERNETES_CLUSTER_KUBECONFIG: Es el archivo kubeconfig del clúster.

    • NAMESPACE: Es el espacio de nombres en el que existe el recurso de PVC. En el caso de los clústeres compartidos, debe ser un espacio de nombres del proyecto. Para los clústeres estándar, puede ser cualquier espacio de nombres.

    • PVC_NAME: Es el nombre de la PVC para la que aumentarás el tamaño de almacenamiento.

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

  2. Verifica el estado de los PV actualizados en tu clúster:

    kubectl get pv --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG

¿Qué sigue?