Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

Esta es documentación inédita para SUSE® Storage 1.12 (Dev).

Parámetros de StorageClass

Descripción general

StorageClass como un objeto de recurso tiene varios parámetros configurables.

Ejemplo:

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: longhorn-test
provisioner: driver.longhorn.io
allowVolumeExpansion: true
reclaimPolicy: Delete
volumeBindingMode: Immediate
parameters:
  backupTargetName: "default"
  numberOfReplicas: "3"
  staleReplicaTimeout: "2880"
  fromBackup: ""
  fsType: "ext4"
#  mkfsParams: ""
#  migratable: false
#  encrypted: false
#  dataLocality: "disabled"
#  replicaAutoBalance: "ignored"
#  diskSelector: "ssd,fast"
#  nodeSelector: "storage,fast"
#  recurringJobSelector: '[{"name":"snap-group", "isGroup":true},
#                          {"name":"backup", "isGroup":false}]'
#  backingImageName: ""
#  backingImageChecksum: ""
#  backingImageDataSourceType: ""
#  backingImageDataSourceParameters: ""
#  unmapMarkSnapChainRemoved: "ignored"
#  disableRevisionCounter: false
#  replicaSoftAntiAffinity: "ignored"
#  replicaZoneSoftAntiAffinity: "ignored"
#  replicaDiskSoftAntiAffinity: "ignored"
#  nfsOptions: "soft,timeo=150,retrans=3"
#  dataEngine: "v1"
#  freezeFSForSnapshot: "ignored"
# allowedTopologies:
#   - matchLabelExpressions:
#       - key: topology.kubernetes.io/zone
#         values:
#           - us-central-1a
#           - us-central-1b

Campos integrados

Ciertos campos son comunes a todas las clases de almacenamiento de Kubernetes. Ver también Kubernetes Storage Class.

Proveedor (campo: provisioner)

Especifica el complemento que se utilizará para la creación dinámica de volúmenes persistentes. Para SUSE Storage, siempre es driver.longhorn.io.

Ver Kubernetes Storage Class: Proveedor.

Permitir expansión de volumen (campo: allowVolumeExpansion)

Por defecto: true Ver Kubernetes Storage Class: Permitir expansión de volumen.

Directiva de recuperación (campo: reclaimPolicy)

Por defecto: Delete Ver Kubernetes Storage Class: Directiva de recuperación.

Opciones de montaje (campo: mountOptions)

Por defecto [] Ver Kubernetes Storage Class - Opciones de montaje.

Modo de vinculación de volumen (campo: volumeBindingMode)

Por defecto Immediate Ver Kubernetes Storage Class - Modo de vinculación de volumen.

Topologías permitidas (campo: allowedTopologies)

Ver la referencia de Kubernetes StorageClass — Topologías permitidas.

Especifica el conjunto de nodos donde los volúmenes pueden ser provisionados al coincidir con las etiquetas de nodo. SUSE Storage utiliza este campo para poblar el nodeAffinity de PV a través del campo CSI accessibleTopology.

Para que allowedTopologies tenga efecto, la configuración SUSE Storage csi-allowed-topology-keys debe configurarse con las claves de topología correspondientes (por ejemplo, topology.kubernetes.io/zone). Sin esta configuración, no se pasa información de topología y el PV no tendrá nodeAffinity.

No utilices allowedTopologies junto con parameters.dataLocality: strict-local. El PV resultante nodeAffinity se vuelve inmutable y entraría en conflicto con la fijación de volumen estricta-local de SUSE Storage.

Para un recorrido completo con ejemplos, consulta el Provisionamiento Consciente de Topología.

Parámetros específicos de SUSE Storage

Ten en cuenta que algunos de estos parámetros también existen y pueden especificarse en configuraciones globales. Cuando un volumen se aprovisiona con Kubernetes contra una clase de almacenamiento particular, los parámetros de la clase de almacenamiento anulan las configuraciones globales. Estos campos se aplicarán solo para la creación de nuevos volúmenes. Si se modifica una clase de almacenamiento, ni SUSE Storage ni Kubernetes se encargan de propagar los cambios a sus parámetros de vuelta a los volúmenes creados previamente con ella.

Número de Réplicas (campo: parameters.numberOfReplicas)

Por defecto: 3

El número deseado de copias (réplicas) para redundancia.

  • Debe estar entre 1 y 20.

  • Las réplicas se colocarán en el conjunto más amplio posible de zonas, nodos y discos en un clúster, sujeto a otras restricciones, como NodeSelector.

Configuración global - Conteo de Réplicas por Defecto.

Tiempo de espera de réplicas obsoletas (campo: parameters.staleReplicaTimeout)

Por defecto: 30

Minutos después de que una réplica se marque como no saludable antes de que se considere inútil para reconstrucciones y simplemente se elimine.

Desde copia de seguridad (campo: parameters.fromBackup)

Por defecto: "" Ejemplo: "s3://backupbucket@us-east-1?volume=minio-vol01&backup=backup-eeb2782d5b2f42bb"

URL de una copia de seguridad que se va a restaurar.

Tipo de FS (campo: parameters.fsType)

Por defecto: ext4 Para más detalles, por favor consulta Crear volúmenes Longhorn con Kubernetes.

Parámetros de Mkfs (campo: parameters.mkfsParams)

Por defecto: "" Para más detalles, por favor consulta Crear volúmenes Longhorn con Kubernetes.

Migrable (campo: parameters.migratable)

Por defecto: false

Habilita capacidades de migración en vivo para un volumen Longhorn, permitiendo que se migre de un nodo a otro mientras se mantienen operaciones de E/S activas.

Cuándo usar:

  1. migratable: true: Para cargas de trabajo que requieren migración en vivo. Debe usarse con el modo de acceso ReadWriteMany y volumeMode: Block.

  2. migratable: false: Para volúmenes estándar que no requieren capacidades de migración en vivo.

Para más detalles, por favor consulta el Volumen ReadWriteMany (RWX).

Encriptado (campo: parameters.encrypted)

Por defecto: false Para más detalles, por favor consulta los Volúmenes Encriptados.

Localidad de datos (campo: parameters.dataLocality)

Por defecto: disabled

Si está habilitado, intenta mantener los datos en el mismo nodo que la carga de trabajo para un mejor rendimiento.

  • Para best-effort, una réplica estaría co-localizada si es posible, pero se permite encontrar otro nodo si no lo es.

  • Para strict-local el conteo de réplicas debe ser 1, o la creación del volumen fallará con un error de validación de parámetros.

  • Si strict-local no es posible por cualquier otra razón, la creación del volumen fallará. Una réplica de strict-local que se desplaza de su carga de trabajo se marcará como "Stopped".

Configuración global - Localidad de datos predeterminada. Para más detalles, por favor consulta Localidad de datos.

Replica auto balance (campo: parameters.replicaAutoBalance)

Por defecto: ignored

Si está habilitado, mueve las réplicas a nodos con menor carga.

  • ignored significa usar la configuración global.

  • Otras opciones son disabled, least-effort, best-effort.

Configuración global - Replica auto balance. Para más detalles, por favor consulta Réplicas de Balanceo Automático.

Selector de Disco (campo: parameters.diskSelector)

Por defecto: "" Ejemplo: "ssd,fast"

Una lista de etiquetas para seleccionar qué discos son candidatos para la colocación de réplicas.

Para más detalles, por favor consulta Etiquetas de Almacenamiento.

Selector de Nodo (campo: parameters.nodeSelector)

Por defecto: "" Ejemplo: "storage,fast"

Una lista de etiquetas para seleccionar qué nodos son candidatos para la colocación de réplicas.

Para más detalles, por favor consulta Etiquetas de Almacenamiento.

Selector de Trabajo Recurrente (campo: parameters.recurringJobSelector)

Por defecto: "" Ejemplo: [{"name":"backup", "isGroup":true}]

Una lista de trabajos recurrentes que deben ejecutarse en un volumen.

Para más detalles, por favor consulta Crear Trabajo de Respaldo/Instantánea Recurrente.

Nombre de Imagen de Respaldo (campo: parameters.backingImageName)

Por defecto: "" Ver Imagen de Respaldo.

Checksum de Imagen de Respaldo (campo: parameters.backingImageChecksum)

Por defecto: "" Ver Imagen de Respaldo.

Tipo de Fuente de Datos de Imagen de Respaldo (campo: parameters.backingImageDataSourceType)

Por defecto: "" Ver Imagen de Respaldo.

Parámetros de la fuente de datos de imagen de respaldo (campo: parameters.backingImageDataSourceParameters)

Por defecto: "" Ver Imagen de Respaldo.

Desmarcar cadena de instantáneas eliminadas del mapa (campo: parameters.unmapMarkSnapChainRemoved)

Por defecto: ignored

  • ignored significa usar la configuración global.

  • Otros valores son enabled y disabled.

Configuración global - Eliminar instantáneas durante el recorte del sistema de archivos. Para más detalles, por favor consulta el Recorte del sistema de archivos.

Deshabilitar contador de revisiones (campo: parameters.disableRevisionCounter)

Por defecto: true

Configuración global - Deshabilitar contador de revisiones. Para más detalles, por favor consulta el Contador de revisiones.

Anti-afinidad suave de réplica (campo: parameters.replicaSoftAntiAffinity)

Por defecto: ignored

  • ignored significa usar la configuración global.

  • Otros valores son enabled y disabled.

Configuración global - Nivel de anti-afinidad suave de nodo de réplica. Para más detalles, por favor consulta el Programación y Mejores prácticas.

Anti-afinidad suave de zona de réplica (campo: parameters.replicaZoneSoftAntiAffinity)

Por defecto: ignored

  • ignored significa usar la configuración global.

  • Otros valores son enabled y disabled.

Configuración global - Nivel de anti-afinidad suave de zona de réplica. Para más detalles, por favor consulta Programación.

Anti-afinidad suave de disco de réplica (campo: parameters.replicaDiskSoftAntiAffinity)

Por defecto: ignored

  • ignored significa usar la configuración global.

  • Otros valores son enabled y disabled.

Configuración global - Nivel de anti-afinidad suave de disco de réplica. Para más detalles, por favor consulta Programación.

Opciones NFS (campo: parameters.nfsOptions)

Por defecto: "" Ejemplo: "hard,sync"

  • Anulaciones para el montaje NFS de volúmenes RWX al gestor de comparticiones. Usa este campo con precaución.

    Las opciones integradas varían según la versión. Verifica los detalles de tu versión antes de establecer esto.

Para más detalles, consulta el RWX Workloads.

Motor de datos (campo: parameters.dataEngine)

Por defecto: "v1"

  • Especifica "v2" para habilitar el Motor de Datos V2 (característica en vista previa técnica). Cuando no se especifique, SUSE Storage utiliza el valor predeterminado ("v1").

Configuración global: Motor de Datos V2. Más detalles en Inicio rápido del Motor de Datos V2.

Congelar el sistema de archivos para la instantánea (campo: parameters.freezeFilesystemForSnapshot)

Por defecto: ignored

  • ignored instruye a SUSE Storage a utilizar la configuración global.

  • Otros valores son enabled y disabled.

Configuración global - Congelar el sistema de archivos para la instantánea.

Nombre del objetivo de copia de seguridad (campo: parameters.backupTargetName)

Por defecto: default

Tamaño del bloque de copia de seguridad (campo: parameters.backupBlockSize)

Por defecto: ""

Ejemplo: "2Mi" o "16Mi"

Una cadena de cantidad de Kubernetes. Utiliza una cadena vacía "" para aplicar la configuración global.

Para obtener más información, consulte:

Instalaciones de Helm

Si SUSE Storage está instalado a través de Helm, los valores en la clase de almacenamiento predeterminada se pueden establecer editando el elemento correspondiente en values.yaml. Todos los parámetros de la clase de almacenamiento tienen un prefijo de persistence. Por ejemplo, persistence.defaultNodeSelector.