Uso de un sistema de archivos de SFS existente con un PV estático

Requisitos previos

• Ha creado un clúster e instalado el complemento de CSI (everest) en el clúster.
• Si desea crear un clúster mediante comandos, utilice kubectl para conectarse al clúster. Para obtener más información, véase Conexión a un clúster con kubectl.
• Ha creado un sistema de archivos SFS que está en la misma VPC que el clúster.

Restricciones

• El sistema de archivos de SFS y el clúster deben estar en la misma VPC.
• Varios PV pueden utilizar el mismo sistema de archivos SFS o SFS Turbo con las siguientes restricciones:
  • Puede producirse un error si varios PVC/PV que utilizan el mismo sistema de archivos SFS o SFS Turbo subyacente están montados en el mismo pod.
  • El parámetro persistentVolumeReclaimPolicy de los PV debe establecerse en Retain. De lo contrario, cuando se elimina un PV, se puede eliminar el volumen subyacente asociado. En este caso, otros PV asociados con el volumen subyacente pueden ser anormales.
  • Cuando el volumen subyacente se utiliza repetidamente, se recomienda desplegar ReadWriteMany en la capa de aplicación para evitar la sobreescritura y la pérdida de datos.

(Consola) Uso de un sistema de archivos de SFS existente

1. Inicie sesión en la consola de CCE y acceda a la consola del clúster.
2. Cree un PV y PVC estáticamente.
   1. Elija Storage en el panel de navegación y haga clic en la ficha PersistentVolumeClaims (PVCs). Haga clic en Create PVC en la esquina superior derecha. En el cuadro de diálogo que se muestra, configure los parámetros de PVC.

      Parámetro	Descripción
      PVC Type	En este ejemplo, seleccione SFS.
      PVC Name	Escriba el nombre de PVC, que debe ser único en el mismo espacio de nombres.
      Creation Method	Si el almacenamiento subyacente está disponible, puede crear un volumen de almacenamiento o utilizar un volumen de almacenamiento existente para crear estáticamente un PVC en función de si se ha creado un PV. Si no hay ningún almacenamiento subyacente disponible, puede seleccionar Dynamically provision. Para obtener más información, véase Uso de un sistema de archivos SFS a través de un PV dinámico. En este ejemplo, seleccione Create new para crear un PV y un PVC al mismo tiempo en la consola.
      PVa	Seleccione un PV existente en el clúster. Es necesario crear un PV por adelantado. Para obtener más información, consulte "Creación de un volumen de almacenamiento (PV)" de Operaciones relacionadas. En este ejemplo, no es necesario establecer este parámetro.
      SFSb	Haga clic en Select SFS. En la página mostrada, seleccione el sistema de archivos SFS que cumpla con sus requisitos y haga clic en OK. NOTA: Actualmente, solo se admite SFS 3.0 Capacity-Oriented.
      PV Nameb	Introduzca el nombre de PV, que debe ser único en el mismo clúster.
      Access Modeb	Los volúmenes de SFS solo admiten ReadWriteMany, lo que indica que un volumen de almacenamiento se puede montar en varios nodos en modo de lectura/escritura. Para obtener más información, véase Modos de acceso al volumen.
      Reclaim Policyb	Puede seleccionar Delete o Retain para especificar la política de recuperación del almacenamiento subyacente cuando se elimina el PVC. Para obtener más información, véase Política de reclamo de PV. NOTA: Si varios PV utilizan el mismo volumen de almacenamiento subyacente, utilice Retain para evitar la eliminación en cascada de volúmenes subyacentes.
      Mount Optionsb	Introduzca los pares de clave-valor del parámetro de montaje. Para obtener más información, véase Configuración de las opciones de montaje de volumen de SFS.

      

      a: El parámetro está disponible cuando Creation Method se establece en Use existing.

      b: El parámetro está disponible cuando Creation Method se establece en Create new.

   2. Haga clic en Create para crear un PVC y un PV.

      Puede elegir Storage en el panel de navegación y ver el PVC y PV creados en las páginas de fichas PersistentVolumeClaims (PVCs) y PersistentVolumes (PVs).

3. Cree una aplicación.
   1. En el panel de navegación de la izquierda, haga clic en Workloads. En el panel derecho, haga clic en la ficha Deployments.
   2. Haga clic en Create Workload en la esquina superior derecha. En la página mostrada, haga clic en Data Storage en el área Container Settings y haga clic en Add Volume para seleccionar PVC.
      Montar y utilizar volúmenes de almacenamiento, como se muestra en Tabla 1. Para obtener más información sobre otros parámetros, consulte Workloads.

      Tabla 1 Montaje de un volumen de almacenamiento

      Parámetro	Descripción
      PVC	Seleccione un volumen de SFS existente.
      Add Container Path	Configure los parámetros siguientes: Mount Path: Introduzca una ruta de acceso del contenedor. Por ejemplo, /tmp. Este parámetro indica la ruta de contenedor en la que se montará un volumen de datos. No monte el volumen en un directorio del sistema como / o /var/run; esta acción puede causar errores de contenedor. Se recomienda montar el volumen en un directorio vacío. Si el directorio no está vacío, asegúrese de que no hay archivos que afecten al inicio de contenedor. De lo contrario, se reemplazarán los archivos, lo que provocará errores de inicio de contenedor o errores de creación de carga de trabajo. AVISO: Cuando el contenedor está montado en un directorio de alto riesgo, se recomienda utilizar una cuenta con los permisos mínimos para iniciar el contenedor; de lo contrario, los archivos de alto riesgo en la máquina host podrían estar dañados. Subpath: Introduzca una ruta secundaria, por ejemplo, tmp. Se utiliza una ruta secundaria para montar un volumen local de modo que se utilice el mismo volumen de datos en un solo pod. Si este parámetro se deja en blanco, la ruta raíz se utiliza de forma predeterminada. Permission Read-only: Solo puede leer los datos en los volúmenes montados. Read/Write: Puede modificar los volúmenes de datos montados en la ruta de acceso. Los datos recién escritos no se migran si se migra el contenedor, lo que puede causar la pérdida de datos. Puede hacer clic en para agregar varias rutas y subrutas.

      En este ejemplo, el disco se monta en la trayectoria /data del contenedor. Los datos de contenedor generados en esta ruta se almacenan en el sistema de archivos SFS.

      

   3. Después de completar la configuración, haga clic en Create.

      Una vez creada la carga de trabajo, puede probar Verificación de la persistencia y el uso compartido de datos.

(kubectl) Uso de un sistema de archivos SFS existente

1. Utilice kubectl para conectarse al clúster.
2. Crear un PV.
   1. Cree el archivo pv-sfs.yaml.
      SFS Capacity-Oriented:

      apiVersion: v1
      kind: PersistentVolume
      metadata:
        annotations:
          pv.kubernetes.io/provisioned-by: everest-csi-provisioner
          everest.io/reclaim-policy: retain-volume-only      # (Optional) The PV is deleted while the underlying volume is retained.
        name: pv-sfs    # PV name.
      spec:
        accessModes:
        - ReadWriteMany      # Access mode. The value must be ReadWriteMany for SFS.
        capacity:
          storage: 1Gi     # SFS volume capacity.
        csi:
          driver: disk.csi.everest.io   # Dependent storage driver for the mounting.
          fsType: nfs
          volumeHandle: <your_volume_id>   # SFS Capacity-Oriented volume ID.
          volumeAttributes:
            everest.io/share-export-location: <your_location>  # Shared path of the SFS volume.
            storage.kubernetes.io/csiProvisionerIdentity: everest-csi-provisioner
        persistentVolumeReclaimPolicy: Retain    # Reclaim policy.
        storageClassName: csi-nas               # Storage class name. csi-nas indicates that SFS Capacity-Oriented is used.
        mountOptions: []                         # Mount options.

      Tabla 2 Parámetros clave

      Parámetro	Obligatorio	Descripción
      everest.io/reclaim-policy: retain-volume-only	No	Opcional. Actualmente, solo se admite retain-volume-only. Este campo solo es válido cuando la versión más reciente es 1.2.9 o posterior y la política de recuperación es Delete. Si la política de reclamación es de Delete y el valor actual es de retain-volume-only el PV asociado se elimina mientras se conserva el volumen de almacenamiento subyacente cuando se elimina un PVC.
      volumeHandle	Sí	Si se utiliza un volumen de SFS Capacity-Oriented, introduzca el ID de volumen. Inicie sesión en la consola, seleccione Service List > Storage > Scalable File Service y seleccione SFS Turbo. En la lista, haga clic en el nombre del sistema de archivos SFS de destino. En la página de detalles, copie el contenido siguiendo ID.
      everest.io/share-export-location	Sí	Ruta de acceso compartida del sistema de archivos. Para un sistema de archivos SFS Capacity-Oriented, inicie sesión en la consola, seleccione Service List > Storage > Scalable File Service y obtenga la ruta de acceso compartida de la columna Mount Address.
      mountOptions	Sí	Opciones de montaje. Si no se especifica, se utilizan las siguientes configuraciones de forma predeterminada. Para obtener más información, véase Configuración de las opciones de montaje de volumen de SFS. mountOptions: - vers=3 - timeo=600 - nolock - hard
      persistentVolumeReclaimPolicy	Sí	Se admite una política de recuperación cuando la versión del clúster es o posterior a 1.19.10 y la versión everest es o posterior a 1.2.9. Las políticas de recuperación Delete y Retain son compatibles. Para obtener más información, véase Política de reclamo de PV. Si varios PV utilizan el mismo volumen de SFS, utilice Retain para evitar la eliminación en cascada de volúmenes subyacentes. Delete: Si no se especifica everest.io/reclaim-policy, el volumen PV y SFS se eliminan cuando se elimina un PVC. Si everest.io/reclaim-policy se establece en retain-volume-only set cuando se elimina un PVC, se elimina el PV pero se conservan los recursos de volumen de SFS. Retain: Cuando se elimina un PVC, el PV y los recursos de almacenamiento subyacentes no se eliminan. En su lugar, debe eliminar manualmente estos recursos. Después de eso, el PV está en el estado Released y no puede estar ligado al PVC de nuevo.
      storage	Sí	Capacidad solicitada en el PVC, en Gi. Para SFS, este campo solo se utiliza para verificación (no puede estar vacío ni 0). Su valor se fija en 1 y cualquier valor que establezca no tiene efecto para los sistemas de archivos SFS.

   2. Ejecute el siguiente comando para crear un PV:

      kubectl apply -f pv-sfs.yaml

3. Cree un PVC.
   1. Cree el archivo pvc-sfs.yaml.

      apiVersion: v1
      kind: PersistentVolumeClaim
      metadata:
        name: pvc-sfs
        namespace: default
        annotations:
          volume.beta.kubernetes.io/storage-provisioner: everest-csi-provisioner
      spec:
        accessModes:
        - ReadWriteMany               # The value must be ReadWriteMany for SFS.
        resources:
          requests:
            storage: 1Gi               # SFS volume capacity.
      storageClassName: csi-nas # Storage class name, which must be the same as the PV's storage class.
        volumeName: pv-sfs    # PV name.

      Tabla 3 Parámetros clave

      Parámetro	Obligatorio	Descripción
      storage	Sí	Capacidad solicitada en el PVC, en Gi. El valor debe ser el mismo que el tamaño de almacenamiento del PV existente.
      volumeName	Sí	Nombre de PV, que debe ser el mismo que el nombre de PV en 1.

   2. Ejecute el siguiente comando para crear un PVC:

      kubectl apply -f pvc-sfs.yaml

4. Cree una aplicación.
   1. Cree un archivo denominado web-demo.yaml. En este ejemplo, el volumen de SFS se monta en la ruta /data.

      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: web-demo
        namespace: default
      spec:
        replicas: 2
        selector:
          matchLabels:
            app: web-demo
        template:
          metadata:
            labels:
              app: web-demo
          spec:
            containers:
            - name: container-1
              image: nginx:latest
              volumeMounts:
              - name: pvc-sfs-volume    # Volume name, which must be the same as the volume name in the volumes field.
                mountPath: /data  # Location where the storage volume is mounted.
            imagePullSecrets:
              - name: default-secret
            volumes:
              - name: pvc-sfs-volume    # Volume name, which can be customized.
                persistentVolumeClaim:
                  claimName: pvc-sfs    # Name of the created PVC.

   2. Ejecute el siguiente comando para crear una aplicación en la que se monta el volumen de SFS:

      kubectl apply -f web-demo.yaml

      Una vez creada la carga de trabajo, puede probar Verificación de la persistencia y el uso compartido de datos.

Verificación de la persistencia y el uso compartido de datos

1. Vea las aplicaciones y los archivos desplegados.
   1. Ejecute el siguiente comando para ver los pods creados:

      kubectl get pod | grep web-demo

      Producto esperado:

      web-demo-846b489584-mjhm9   1/1     Running   0             46s
      web-demo-846b489584-wvv5s   1/1     Running   0             46s

   2. Ejecute los siguientes comandos en secuencia para ver los archivos en la ruta /data de los pods:

      kubectl exec web-demo-846b489584-mjhm9 -- ls /data
      kubectl exec web-demo-846b489584-wvv5s -- ls /data

      Si no se devuelve ningún resultado para ambos pods, no existe ningún archivo en la ruta /data.

2. Ejecute el siguiente comando para crear un archivo llamado static en la ruta /data:

   kubectl exec web-demo-846b489584-mjhm9 --  touch /data/static

3. Ejecute el siguiente comando para ver los archivos en la ruta /data:

   kubectl exec web-demo-846b489584-mjhm9 -- ls /data

   Producto esperado:

   static

4. Verificar la persistencia de los datos.
   1. Ejecute el siguiente comando para eliminar el pod llamado web-demo-846b489584-mjhm9:

      kubectl delete pod web-demo-846b489584-mjhm9

      Producto esperado:

      pod "web-demo-846b489584-mjhm9" deleted

      Después de la eliminación, el controlador de Deployment crea automáticamente una réplica.

   2. Ejecute el siguiente comando para ver el pod creado:

      kubectl get pod | grep web-demo

      El resultado esperado es el siguiente, en el que web-demo-846b489584-d4d4j es el pod recién creado:

      web-demo-846b489584-d4d4j   1/1     Running   0             110s
      web-demo-846b489584-wvv5s    1/1     Running   0             7m50s

   3. Ejecute el siguiente comando para comprobar si se han modificado los archivos de la ruta /data del nuevo pod:

      kubectl exec web-demo-846b489584-d4d4j -- ls /data

      Producto esperado:

      static

      Si el archivo static todavía existe, los datos se pueden almacenar de forma persistente.

5. Verifique el uso compartido de datos.
   1. Ejecute el siguiente comando para ver el pod creado:

      kubectl get pod | grep web-demo

      Producto esperado:

      web-demo-846b489584-d4d4j   1/1     Running   0             7m
      web-demo-846b489584-wvv5s   1/1     Running   0             13m

   2. Ejecute el siguiente comando para crear un archivo llamado share en la ruta /data de cualquier pod: En este ejemplo, seleccione el pod llamado web-demo-846b489584-d4d4j.

      kubectl exec web-demo-846b489584-d4d4j --  touch /data/share

      Compruebe los archivos en la ruta /data del pod.

      kubectl exec web-demo-846b489584-d4d4j -- ls /data

      Producto esperado:

      share
      static

   3. Compruebe si el archivo share existe en la ruta /data de otro pod (web-demo-846b489584-wvv5s) también para verificar el uso compartido de datos.

      kubectl exec web-demo-846b489584-wvv5s -- ls /data

      Producto esperado:

      share
      static

      Después de crear un archivo en la ruta /data de un pod, si el archivo también se crea en la ruta /data de otros pods, los dos pods comparten el mismo volumen.

Operaciones relacionadas