Container Service for Kubernetes:Mount OSS buckets using ossfs 1.0 dynamic volumes

1. Crear una StorageClass

1. Cree un Secret en el mismo namespace que su aplicación.

   Reemplace akId y akSecret con su AccessKey ID y AccessKey Secret.

   kubectl create secret generic oss-secret --from-literal='akId=<yourAccessKey ID>' --from-literal='akSecret=<yourAccessKey Secret>'

2. Cree la StorageClass.

   1. Cree un archivo llamado sc-oss.yaml.

      apiVersion: storage.k8s.io/v1
      kind: StorageClass
      metadata:
        name: sc-oss
      parameters:
        # Replace with the name of your OSS bucket.
        bucket: bucket
        # Replace with the region of your OSS bucket.
        region: cn-hangzhou
        # The mount path relative to the bucket's root directory. You can specify a subdirectory.
        path: /
        # The endpoint of the region where the bucket is located.
        url: "https://oss-cn-hangzhou-internal.aliyuncs.com" 
        # The name of the Secret that stores the AccessKey information.
        csi.storage.k8s.io/node-publish-secret-name: oss-secret
        # The namespace where the Secret that stores the AccessKey information is located.
        csi.storage.k8s.io/node-publish-secret-namespace: default
        # Custom parameters.
        otherOpts: "-o umask=022 -o max_stat_cache_size=100000 -o allow_other"
        # The signature version for requests sent to the OSS server.
        sigVersion: "v4"
      # Fixed value for the Alibaba Cloud OSS CSI plug-in.
      provisioner: ossplugin.csi.alibabacloud.com
      # The reclaim policy for the dynamically provisioned persistent volume.
      reclaimPolicy: Retain
      # The volume binding mode.
      volumeBindingMode: Immediate
      

      Parámetro	Descripción
      name	El nombre de la StorageClass.
      bucket	El bucket de OSS que se va a montar.
      region	Si utiliza la firma v4 de OSS, establezca este valor en la región de OSS donde se encuentra el bucket. Para consultar la región de OSS, consulte Query the region of a bucket. Cuando se configura este parámetro, se usa automáticamente v4 como versión de firma de OSS.
      path	La versión del componente CSI debe ser v1.14.8.32-c77e277b-aliyun o posterior. La ruta de montaje relativa al directorio raíz del bucket. El valor predeterminado es /, que monta todo el bucket. Si la ossfs version es anterior a 1.91, el path especificado debe existir en el bucket de OSS. Para obtener más información, consulte New features in ossfs 1.91 and later.
      url	El endpoint del bucket de OSS que se va a montar. Utilice un endpoint interno si el nodo de montaje y el bucket están en la misma región, o si ya se estableció una conexión VPC. Utilice un endpoint público si el nodo de montaje y el bucket están en regiones distintas. A continuación se muestran los formatos comunes para distintos puertos de acceso: Formato de red interna: https://oss-{{regionName}}-internal.aliyuncs.com. El formato de endpoint interno vpc100-oss-{{regionName}}.aliyuncs.com está obsoleto. Cambie al nuevo formato lo antes posible. Formato de red pública: https://oss-{{regionName}}.aliyuncs.com. Por motivos de seguridad, se recomienda accessing OSS over HTTPS. Si necesita usar HTTP, reemplace el prefijo https:// del formato anterior por http://.
      csi.storage.k8s.io/node-publish-secret-name	El nombre del Secret que almacena la información de AccessKey.
      csi.storage.k8s.io/node-publish-secret-namespace	El namespace donde se encuentra el Secret que almacena la información de AccessKey.
      otherOpts	Parámetros personalizados del volumen persistente de OSS, con el formato -o -o . Por ejemplo: -o umask=022 -o max_stat_cache_size=100000 -o allow_other. Expandir para ver detalles umask: establece la máscara de permisos para archivos y directorios. Por ejemplo, umask=022 cambia los permisos de los archivos a 755. Esto resuelve el problema de permisos en los archivos subidos mediante otros métodos, como SDK o la consola de OSS, cuyo permiso predeterminado es 640. Se recomienda configurar este parámetro cuando se divide la lectura y escritura, o cuando acceden varios usuarios. max_stat_cache_size: define el límite máximo de entradas en la caché de metadatos; por ejemplo, 100000. Los metadatos se almacenan en memoria para mejorar el rendimiento de operaciones como ls y stat. Sin embargo, esta caché no detecta de inmediato las modificaciones de archivos hechas desde la consola de OSS, los SDK o ossutil. Esto puede provocar que las aplicaciones lean datos inconsistentes. Si tiene requisitos estrictos de consistencia de datos, establezca este parámetro en 0 para deshabilitar la caché, o reduzca el tiempo de expiración con el parámetro stat_cache_expire. Tenga en cuenta que esto podría reducir el rendimiento de lectura. allow_other: permite que usuarios distintos al que montó el volumen accedan a los archivos y directorios de la ruta de montaje. Resulta útil en entornos compartidos con múltiples usuarios donde quienes no realizaron el montaje también necesitan acceder a los datos. Para obtener más información sobre los parámetros opcionales, consulte Mount options y Best practices for configuring ossfs 1.0.
      provisioner	El tipo de controlador. Este valor se fija en ossplugin.csi.alibabacloud.com cuando se utiliza el complemento CSI de OSS de Alibaba Cloud.
      reclaimPolicy	La directiva de recuperación de los volúmenes persistentes aprovisionados dinámicamente. Los volúmenes persistentes de OSS solo admiten Retain. Esto significa que, al eliminar un PVC, no se borran ni el volumen persistente correspondiente ni los datos del bucket de OSS.
      volumeBindingMode	El modo de vinculación del volumen. Los volúmenes persistentes de OSS no requieren afinidad de nodos basada en zonas de disponibilidad. Puede utilizar el valor predeterminado Immediate.
      volumeAs	El modo de acceso al volumen. El valor predeterminado es sharepath. Valores válidos: sharepath: todos los volúmenes persistentes comparten la misma ruta de montaje. Los datos se almacenan en <bucket>:<path>/. subpath: crea un subdirectorio exclusivo para cada volumen persistente con el fin de aislar los datos. Estos se almacenan en <bucket>:<path>/<pv-name>/. Este parámetro solo surte efecto cuando la versión del componente CSI es 1.31.3 o posterior.
      sigVersion	La versión de firma de las solicitudes enviadas al servidor de OSS. "v1" (predeterminado): utiliza Signature Version 1 de OSS. "v4" (recomendado): utiliza Signature Version 4 de OSS.

   2. Cree la StorageClass.

      kubectl apply -f sc-oss.yaml

1. Guarde la AccessKey de Step 1 como un Secret para el volumen persistente.

   1. En la página Clústeres de ACK, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Configurations > Secrets.

   2. Haga clic en Create from YAML y siga las instrucciones en pantalla para crear el Secret.

      apiVersion: v1
      kind: Secret
      metadata:
        name: oss-secret
        # Must match the namespace of the application.
        namespace: default
      stringData:
        # Replace with your AccessKey ID.
        akId: <your AccessKey ID>
        # Replace with your AccessKey secret.
        akSecret: <your AccessKey Secret>

2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Volumes > StorageClasses.

3. En la página StorageClasses, haga clic en Create, establezca PV Type en OSS y siga las instrucciones en pantalla para configurar la StorageClass.

   Parámetro	Descripción
   Certificado de acceso	El Secret que se utiliza para acceder a OSS. Contiene el AccessKey ID y el AccessKey Secret.
   Bucket ID:	El bucket de OSS que se va a utilizar. La consola solo muestra los buckets a los que puede acceder la AccessKey configurada.
   Ruta de OSS	La versión del componente CSI debe ser v1.14.8.32-c77e277b-aliyun o posterior. La ruta de montaje relativa al directorio raíz del bucket. El valor predeterminado es /, que monta todo el bucket. Si la ossfs version es anterior a 1.91, el path especificado debe existir en el bucket de OSS. Para obtener más información, consulte New features in ossfs 1.91 and later.
   Volume Mode	El modo de acceso al volumen. El valor predeterminado es Shared Directory. Valores válidos: El modo Subdirectory solo surte efecto cuando la versión del componente CSI es 1.31.3 o posterior. De lo contrario, se utiliza el modo Shared Directory. Shared Directory (sharepath): todos los volúmenes persistentes comparten la misma ruta de montaje. Los datos se almacenan en <bucket>:<path>/. Subdirectory (subpath): crea un subdirectorio exclusivo para cada volumen persistente con el fin de aislar los datos. Estos se almacenan en <bucket>:<path>/<pv-name>/.
   Endpoint	El endpoint de acceso del bucket de OSS. Utilice un endpoint interno si los nodos del clúster y el bucket están en la misma región, o si ya se estableció una conexión Virtual Private Cloud (VPC). Utilice un endpoint público si el nodo de montaje y el bucket están en regiones distintas. A continuación se muestran los formatos comunes para distintos endpoints de acceso: Interno: http://oss-{{regionName}}-internal.aliyuncs.com o https://oss-{{regionName}}-internal.aliyuncs.com. Nota El formato de endpoint de acceso interno vpc100-oss-{{regionName}}.aliyuncs.com está obsoleto. Cambie al nuevo formato lo antes posible. Público: http://oss-{{regionName}}.aliyuncs.com o https://oss-{{regionName}}.aliyuncs.com. De forma predeterminada, la consola utiliza HTTP para acceder a OSS a través de una red interna. Si necesita HTTPS, debe crear el PV mediante kubectl.
   Directiva de recuperación	La directiva de recuperación de los volúmenes persistentes aprovisionados dinámicamente. Los volúmenes persistentes de OSS solo admiten Retain. Esto significa que, al eliminar un PVC, no se borran ni el volumen persistente correspondiente ni los datos del bucket de OSS.
   Optional Parameters:	Parámetros personalizados del volumen persistente de OSS, con el formato -o -o . Por ejemplo: -o umask=022 -o max_stat_cache_size=100000 -o allow_other. Expandir para ver detalles umask: establece la máscara de permisos para archivos y directorios. Por ejemplo, umask=022 cambia los permisos de los archivos a 755. Esto resuelve el problema de permisos en los archivos subidos mediante otros métodos, como SDK o la consola de OSS, cuyo permiso predeterminado es 640. Se recomienda configurar este parámetro cuando se divide la lectura y escritura, o cuando acceden varios usuarios. max_stat_cache_size: define el límite máximo de entradas en la caché de metadatos; por ejemplo, 100000. Los metadatos se almacenan en memoria para mejorar el rendimiento de operaciones como ls y stat. Sin embargo, esta caché no detecta de inmediato las modificaciones de archivos hechas desde la consola de OSS, los SDK o ossutil. Esto puede provocar que las aplicaciones lean datos inconsistentes. Si tiene requisitos estrictos de consistencia de datos, establezca este parámetro en 0 para deshabilitar la caché, o reduzca el tiempo de expiración con el parámetro stat_cache_expire. Tenga en cuenta que esto podría reducir el rendimiento de lectura. allow_other: permite que usuarios distintos al que montó el volumen accedan a los archivos y directorios de la ruta de montaje. Resulta útil en entornos compartidos con múltiples usuarios donde quienes no realizaron el montaje también necesitan acceder a los datos. Para obtener más información sobre los parámetros opcionales, consulte Mount options y Best practices for configuring ossfs 1.0.