Uso de un disco de EVS con un PV dinámico

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.

(Consola) Creación automática de un disco de EVS

1. Inicie sesión en la consola de CCE y acceda a la consola del clúster.
2. Cree dinámicamente un PVC y un PV.
   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 EVS.
      PVC Name	Escriba el nombre de PVC, que debe ser único en el mismo espacio de nombres.
      Creation Method	Si no hay almacenamiento subyacente disponible, puede seleccionar Dynamically provision para crear un almacenamiento de PVC, PV y subyacente en la consola en modo en cascada. 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. Para obtener más información, véase Uso de un disco de EVS existente a través de un PV estático. En este ejemplo, seleccione Dynamically provision.
      Storage Classes	La clase de almacenamiento para los discos de EVS es csi-disk.
      AZ	Seleccione la AZ del disco de EVS. La AZ debe ser la misma que la del nodo del clúster. NOTA: Un disco de EVS solo se puede montar en un nodo en la misma AZ. Después de crear un disco de EVS, no se puede cambiar su AZ.
      Disk Type	Seleccione un tipo de disco de EVS.
      Access Mode	Los discos de EVS solo admiten ReadWriteOnce, lo que indica que un volumen de almacenamiento se puede montar en un nodo en modo de lectura/escritura. Para obtener más información, véase Modos de acceso al volumen.
      Capacity (GiB)	Capacidad del volumen de almacenamiento solicitado.
      Encryption	Puede seleccionar Encryption y una clave de encriptación para cifrar el almacenamiento subyacente. Solo los discos de EVS y los sistemas de archivos SFS admiten encriptación.
      Enterprise Project	Proyectos de empresa admitidos: predeterminado, al que pertenece el clúster o al que especifica la clase de almacenamiento.

   2. Haga clic en Create.

      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 StatefulSets.
   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 EVS existente. Un volumen de EVS no se puede montar repetidamente en varias cargas de trabajo.
      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 disco de EVS.

      

      Un disco ReadWriteOnce de EVS no compartido no se puede montar en varios pods de una carga de trabajo. Como resultado, los pods no pueden arrancar correctamente. Asegúrese de que el número de pods de carga de trabajo es 1 al montar un disco de EVS.

      

   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 de datos.

(kubectl) Creación automática de un disco de EVS

1. Utilice kubectl para conectarse al clúster.
2. Utilice StorageClass para crear dinámicamente un PVC y un PV.
   1. Cree el archivo pvc-evs-auto.yaml.

      apiVersion: v1
      kind: PersistentVolumeClaim
      metadata:
        name: pvc-evs-auto
        namespace: default
        annotations:
            everest.io/disk-volume-type: SAS    # EVS disk type.
          everest.io/crypt-key-id: <your_key_id>    # (Optional) Encryption key ID. Mandatory for an encrypted disk.
          everest.io/enterprise-project-id: <your_project_id>  # (Optional) Enterprise project ID. If an enterprise project is specified, you need to use the same enterprise project when creating a PVC. Otherwise, the PVC cannot be bound to a PV.
        labels:
          failure-domain.beta.kubernetes.io/region: <your_region>   # Region of the node where the application is to be deployed.
          failure-domain.beta.kubernetes.io/zone: <your_zone>       # AZ of the node where the application is to be deployed.
      spec:
        accessModes:
        - ReadWriteOnce               # The value must be ReadWriteOnce for EVS disks.
        resources:
          requests:
            storage: 10Gi             # EVS disk capacity, ranging from 1 to 32768.
        storageClassName: csi-disk    # Storage class type for EVS disks.

      Tabla 2 Parámetros clave

      Parámetro	Obligatorio	Descripción
      failure-domain.beta.kubernetes.io/region	Sí	Región donde se encuentra el clúster. Para obtener más información sobre el valor de region, consulte Regiones y puntos de conexión.
      failure-domain.beta.kubernetes.io/zone	Sí	AZ donde se crea el volumen de EVS. Debe ser la misma que la AZ prevista para la carga de trabajo. Para obtener más información sobre el valor de zone, consulte Regiones y puntos de conexión.
      everest.io/disk-volume-type	Sí	Tipo del disco de EVS. Todas las letras están en mayúsculas. SAS: E/S con capacidad alta SSD: E/S con capacidad ultraalta GPSSD: SSD de uso general ESSD: SSD extremo
      everest.io/crypt-key-id	No	Obligatorio cuando el disco de EVS está cifrado. Introduzca el ID de clave de encriptación seleccionado durante la creación del disco de EVS. Para obtener el ID de clave de encriptación, inicie sesión en Cloud Server Console. En el panel de navegación, elija Elastic Volume Service > Disks. Haga clic en el nombre del disco de EVS de destino para ir a su página de detalles. En la página de ficha Summary, copie el valor de KMS Key ID en el área Configuration Information.
      everest.io/enterprise-project-id	No	Opcional. ID de proyecto de empresa del disco de EVS. Si se especifica un proyecto de empresa, debe especificar el mismo proyecto de empresa al crear un PVC. De lo contrario, el PVC no puede estar unido a un PV. Para obtener el ID del proyecto de empresa, inicie sesión en Cloud Server Console. En el panel de navegación, elija Elastic Volume Service > Disks. Haga clic en el nombre del disco de EVS de destino para ir a su página de detalles. En la página de ficha Summary, haga clic en el proyecto de empresa de Management Information para acceder a la consola del proyecto de empresa. Copie el ID correspondiente para obtener el ID del proyecto de empresa al que pertenece el disco de EVS.
      storage	Sí	Capacidad de PVC solicitada, en Gi. El valor oscila entre 1 y 32768.
      storageClassName	Sí	El nombre de clase de almacenamiento de los volúmenes de EVS es csi-disk.

   2. Ejecute el siguiente comando para crear un PVC:

      kubectl apply -f pvc-evs-auto.yaml

3. Cree una aplicación.
   1. Cree un archivo denominado web-evs-auto.yaml. En este ejemplo, el volumen de EVS se monta en la ruta /data.

      apiVersion: apps/v1
      kind: StatefulSet
      metadata:
        name: web-evs-auto
        namespace: default
      spec:
        replicas: 1
        selector:
          matchLabels:
            app: web-evs-auto
        serviceName: web-evs-auto   # Headless Service name.
        template:
          metadata:
            labels:
              app: web-evs-auto
          spec:
            containers:
            - name: container-1
              image: nginx:latest
              volumeMounts:
              - name: pvc-disk    # 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-disk    # Volume name, which can be customized.
                persistentVolumeClaim:
                  claimName: pvc-evs-auto    # Name of the created PVC.
      ---
      apiVersion: v1
      kind: Service
      metadata:
        name: web-evs-auto   # Headless Service name.
        namespace: default
        labels:
          app: web-evs-auto
      spec:
        selector:
          app: web-evs-auto
        clusterIP: None
        ports:
          - name: web-evs-auto
            targetPort: 80
            nodePort: 0
            port: 80
            protocol: TCP
        type: ClusterIP

   2. Ejecute el siguiente comando para crear una carga de trabajo en la que está montado el volumen de EVS:

      kubectl apply -f web-evs-auto.yaml

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

Verificación de la persistencia de datos

1. Vea la aplicación desplegada y los archivos de volumen de EVS.
   1. Ejecute el siguiente comando para ver el pod creado:

      kubectl get pod | grep web-evs-auto

      Producto esperado:

      web-evs-auto-0                  1/1     Running   0               38s

   2. Run the following command to check whether the EVS volume has been mounted to the /data path:

      kubectl exec web-evs-auto-0 -- df | grep data

      Producto esperado:

      /dev/sdc              10255636     36888  10202364   0% /data

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

      kubectl exec web-evs-auto-0 -- ls /data

      Producto esperado:

      lost+found

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

   kubectl exec web-evs-auto-0 --  touch /data/static

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

   kubectl exec web-evs-auto-0 -- ls /data

   Producto esperado:

   lost+found
   static

4. Ejecute el siguiente comando para eliminar el pod llamado web-evs-auto-0:

   kubectl delete pod web-evs-auto-0

   Producto esperado:

   pod "web-evs-auto-0" deleted

5. Después de la eliminación, el controlador de StatefulSet crea automáticamente una réplica con el mismo nombre. Ejecute el siguiente comando para comprobar si se han modificado los archivos de la ruta /data:

   kubectl exec web-evs-auto-0 -- ls /data

   Producto esperado:

   lost+found
   static

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

Operaciones relacionadas