Inicio rápido para IBM Cloud Block Storage for VPC

En esta guía de inicio rápido, se crea un volumen 10Gi 5IOPS tier Block Storage for VPC en el clúster mediante la creación de un PVC para aprovisionar dinámicamente el volumen. A continuación, se crea un despliegue de app que monta la PVC.

Ahora puedes elegir una clase de almacenamiento de segunda generación.

Sus volúmenes de Block Storage for VPC pueden ser montados por múltiples pods siempre y cuando esos pods estén programados en el mismo nodo.

1. Cree un archivo para la PVC y llámelo pvc.yaml. Elija entre una clase de almacenamiento de primera generación y una de segunda generación.

   Ejemplo de primera generación que utiliza la clase de almacenamiento ibmc-vpc-block-5iops-tier:

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: my-pvc
   spec:
     storageClassName: ibmc-vpc-block-5iops-tier
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 10Gi
   

   Ejemplo de segunda generación que utiliza la clase de almacenamiento ibmc-vpc-block-sdp:

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: my-pvc
   spec:
     storageClassName: ibmc-vpc-block-sdp
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 10Gi
   

2. Cree la PVC en el clúster.

   kubectl apply -f pvc.yaml
   

3. Cuando la PVC esté enlazada, cree un despliegue de app que utilice la PVC. Cree un archivo para el despliegue y llámelo deployment.yaml.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
       name: my-deployment
       labels:
         app: my-app
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
       spec:
         containers:
         - image: ngnix # Your containerized app image.
           name: my-container
           volumeMounts:
           - name: my-volume
             mountPath: /mount-path
         volumes:
         - name: my-volume
           persistentVolumeClaim:
             claimName: my-pvc
   

4. Cree el despliegue en el clúster.

   kubectl apply -f deployment.yaml
   

Para obtener más información, consulte los siguientes enlaces.

• Adición de Block Storage for VPC a las apps.
• Referencia de clase de almacenamiento.
• Personalización de los valores de almacenamiento predeterminados.

Adición de Block Storage for VPC a sus apps

Elija el perfil de Block Storage for VPC y cree una reclamación de volumen persistente para suministrar dinámicamente Block Storage for VPC para el clúster. El suministro dinámico crea automáticamente el volumen persistente adecuado y solicita el dispositivo de almacenamiento físico en la cuenta de IBM Cloud.

1. Decida el perfil de Block Storage for VPC que mejor se ajuste a sus requisitos de capacidad y de rendimiento.

2. Seleccione la clase de almacenamiento correspondiente para el perfil de Block Storage for VPC.

   De forma predeterminada, todas las clases de almacenamiento predefinidas de IBM configuran Block Storage for VPC con un sistema de archivos ext4. Si desea utilizar otro un sistema de archivos, como por ejemplo xfs o ext3, cree una clase de almacenamiento personalizada.

   • 10 IOPS/GB: ibmc-vpc-block-10iops-tier o ibmc-vpc-block-retain-10iops-tier
   • 5 IOPS/GB: ibmc-vpc-block-5iops-tier o ibmc-vpc-block-retain-5iops-tier
   • 3 IOPS/GB: ibmc-vpc-block-general-purpose o ibmc-vpc-block-retain-general-purpose
   • Personalizado: ibmc-vpc-block-custom o ibmc-vpc-block-retain-custom

3. Decida la configuración de Block Storage for VPC que desea.

   1. Elija un tamaño para el almacenamiento. Asegúrese de que el tamaño reciba soporte del perfil de Block Storage for VPC que ha elegido.
   2. Decida si desea conservar los datos después de que se suprima el clúster o la reclamación de volumen persistente (PVC).
      • Si desea conservar los datos, seleccione la clase de almacenamiento retain. Cuando se suprime la PVC, únicamente ésta se suprime. El volumen persistente (PV), el dispositivo de almacenamiento físico de la cuenta de IBM Cloud y los datos siguen existiendo. Para reclamar el almacenamiento y volverlo a utilizar en el clúster, debe eliminar el PV y seguir los pasos de utilización de Block Storage for VPC existente.
      • Si desea que el PV, los datos y el dispositivo físico de Block Storage for VPC se supriman cuando suprima la PVC, elija una clase de almacenamiento sin la opción retain.

4. Cree un archivo de configuración para definir su reclamación de volumen persistente y guarde la configuración como archivo YAML.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: <pvc_name> # Enter a name for your PVC.
   spec:
     accessModes:
     - <access-mode> # ReadWriteOnce or ReadWriteOncePod
     resources:
       requests:
         storage: 10Gi # Enter the size. Make sure that the size is supported in the profile that you chose.
     storageClassName: <storage_class> # Enter the storage class name that you selected earlier.
   

5. Cree la PVC en el clúster.

   kubectl apply -f pvc.yaml
   

6. Verifique que la PVC se ha creado y se ha vinculado al PV. Este proceso puede tardar unos minutos.

   kubectl describe pvc <pvc_name>
   

   Salida de ejemplo

   Name:          mypvv
   Namespace:     default
   StorageClass:  ibmc-vpc-block-5iops-tier
   Status:        Bound
   Volume:        
   Labels:        <none>
   Annotations:   kubectl.kubernetes.io/last-applied-configuration: {"apiVersion":"v1","kind":"PersistentVolumeClaim","metadata":{"annotations":{},"name":"csi-block-pvc-good","namespace":"default"},"spec":{...
               volume.beta.kubernetes.io/storage-provisioner: vpc.block.csi.ibm.io
   Finalizers:    [kubernetes.io/pvc-protection]
   Capacity: 10Gi   
   Access Modes:  
   VolumeMode:    Filesystem
   Events:
       Type       Reason                Age               From                         Message
       ----       ------                ----              ----                         -------
       Normal     ExternalProvisioning  9s (x3 over 18s)  persistentvolume-controller  waiting for a volume to be created, either by external provisioner "vpc.block.csi.ibm.io" or manually created by system administrator
   Mounted By:  <none>
   

7. Cree un archivo de configuración de despliegue para la app y monte la PVC en la app.

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: <deployment_name>
     labels:
       app: <deployment_label>
   spec:
     selector:
       matchLabels:
         app: <app_name>
     template:
       metadata:
         labels:
           app: <app_name>
       spec:
         containers:
         - image: <image_name>
           name: <container_name>
           volumeMounts:
           - name: <volume_name>
             mountPath: /<file_path>
         volumes:
         - name: <volume_name>
           persistentVolumeClaim:
             claimName: <pvc_name>
   

   labels.app

   En la sección metadata, especifique una etiqueta para el despliegue.

   matchLabels.app y labels.app

   En el selector de especificación y en las secciones de metadatos de la plantilla, especifique una etiqueta para la app.

   image

   Especifique el nombre de la imagen de contenedor que desea utilizar. Para ver una lista de todas las imágenes disponibles en su cuenta de IBM Cloud Container Registry, ejecute ibmcloud cr image-list.

   name

   Especifique el nombre del contenedor que desea desplegar en el pod.

   mountPath

   En la sección de montajes de volúmenes de contenedor, especifique la vía de acceso absoluta del directorio en el que está montada la PVC dentro del contenedor.

   name

   En la sección de montajes de volúmenes de contenedor, especifique el nombre del volumen que se va a montar en el pod. Puede especificar el nombre que desee.

   name

   En la sección de volúmenes, especifique el nombre del volumen que se va a montar en el pod. Normalmente, este nombre es el mismo que volumeMounts.name.

   claimName

   En la sección de reclamación de volúmenes persistentes, especifique el nombre de la PVC que ha creado anteriormente.

8. Cree el despliegue en el clúster.

   kubectl apply -f deployment.yaml
   

9. Verifique que la PVC se ha montado correctamente en la app. Los pods pueden tardar unos minutos en pasar al estado Running.

   Durante el desarrollo de la app, es posible que reciba errores que indiquen que Unable to mount volumes en la sección Events de la salida de la CLI. El complemento de clúster Block Storage for VPC reintenta automáticamente montar el almacenamiento en sus aplicaciones. Espere unos minutos a que el almacenamiento se monte en la app.

   kubectl describe deployment <deployment_name>
   

   Salida de ejemplo

   ...
   Volumes:
   myvol:
       Type:    PersistentVolumeClaim (a reference to a PersistentVolumeClaim in the same namespace)
       ClaimName:    mypvc
       ReadOnly:    false
   

Utilización de una instancia de Block Storage for VPC existente

Si dispone de un dispositivo de Block Storage for VPC físico existente que desea utilizar en el clúster, puede crear manualmente el PV y la PVC para suministrar de forma estática el almacenamiento.

Solo puede conectar un volumen a un nodo trabajador. Asegúrese de que el volumen esté en la misma zona que el nodo trabajador para que la conexión se realice correctamente.

1. Determine el volumen que desea conectar a un nodo trabajador en el clúster de VPC. Anote el ID de volumen.

   ibmcloud is volumes
   

2. Obtenga una lista de los detalles del volumen. Anote los valores de Size, Zone e IOPS. Estos valores se utilizan para crear el PV.

   ibmcloud is volume <volume_id>
   

3. Recupere una lista de nodos trabajadores en el clúster de VPC. Anote el valor de Zone del nodo trabajador que se encuentra en la misma zona que el volumen de almacenamiento.

   ibmcloud ks worker ls -c <cluster_name>
   

4. Opcional: si ha suministrado la instancia física de Block Storage for VPC mediante una clase de almacenamiento retain, el PV y el almacenamiento físico no se eliminan cuando se elimina la PVC. Para utilizar el dispositivo físico de Block Storage for VPC en el clúster, primero debe eliminar el PV existente.

   1. Consulte los PV del clúster y busque el PV perteneciente al dispositivo de Block Storage for VPC. El PV está en el estado released.

      kubectl get pv
      

   2. Elimine el PV.

      kubectl delete pv <pv_name>
      

5. Cree un archivo de configuración para el PV. Incluya el ID, el tamaño (Size) y la zona (Zone) y el valor de IOPS que ha recuperado anteriormente.

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: <pv_name> # Example: my-persistent-volume
   spec:
     accessModes:
     - ReadWriteOnce
     capacity:
       storage: <vpc_block_storage_size> # Example: 20Gi
     csi:
       driver: vpc.block.csi.ibm.io
       fsType: ext4
       volumeAttributes:
         iops: "<vpc_block_storage_iops>" # Example: "3000"
         volumeId: <vpc_block_storage_ID> # Example: a1a11a1a-a111-1111-1a11-1111a11a1a11
         zone: "<vpc_block_zone>" # Example: "eu-de-3"
         region: "<vpc_block_region>"
       volumeHandle: <vpc_block_storage_ID>
     nodeAffinity:
       required:
         nodeSelectorTerms:
         - matchExpressions:
           - key: failure-domain.beta.kubernetes.io/zone
             operator: In
             values:
             - <worker_node_zone> # Example: eu-de-3
           - key: failure-domain.beta.kubernetes.io/region
             operator: In
             values:
             - <worker_node_region> # Example: eu-de
           - key: kubernetes.io/hostname
             operator: In
             values:
             - <worker_node_primary_IP>
     persistentVolumeReclaimPolicy: Retain
     storageClassName: ""
     volumeMode: Filesystem
   

   name

   En la sección metadata, especifique un nombre para el PV.

   storage

   En la sección de capacidad de la especificación, especifique el tamaño del volumen de Block Storage for VPC en gigabytes (Gi) que ha recuperado anteriormente. Por ejemplo, si el tamaño del dispositivo es de 100 GB, especifique 100Gi.

   iops

   En la sección de atributos de volumen de CSI de la especificación, especifique el número máximo de IOPS del volumen de Block Storage for VPC que ha recuperado anteriormente.

   zone

   En la sección de atributos de volumen de CSI de la especificación, especifique la zona de bloque de VPC que coincida con la ubicación que ha recuperado anteriormente. Por ejemplo, si su ubicación es Washington DC-1, utilice us-east-1 como zona. Para consultar las zonas disponibles, ejecute ibmcloud is zones. Para ver las zonas y ubicaciones de VPC disponibles, consulte Creación de una VPC en otra región. Indique el parámetro "region" cuando se especifique "zone".

   region

   La región del nodo de trabajador a la que desea conectar el almacenamiento.

   worker_node_primary_IP

   La IP primaria del nodo de trabajador a la que desea conectar el almacenamiento. Puede consultar la IP primaria del nodo de trabajador ejecutando ibmcloud ks worker ls.

   volumeId y spec.csi.volumeHandle

   En la sección de atributos de volumen de CSI de la especificación, especifique el ID del volumen de Block Storage for VPC que ha recuperado anteriormente.

   storageClassName

   Como nombre de la clase de almacenamiento de la especificación, especifique una serie vacía.

   matchExpressions

   En la sección de afinidad de nodos de la especificación, especifique los términos del selector de nodo para que coincidan con la zona. Para la clave, especifique failure-domain.beta.kubernetes.io/zone. Para el valor, especifique la zona del nodo trabajador en la que desea adjuntar el almacenamiento.

   matchExpressions

   En la sección de afinidad de nodos de la especificación, especifique los términos del selector de nodo para que coincidan con la región. Para la clave, especifique failure-domain.beta.kubernetes.io/region. Para el valor, especifique la región del nodo trabajador en la que desea adjuntar el almacenamiento.

6. Cree el PV en el clúster.

   kubectl apply -f pv.yaml
   

7. Verifique que el PV se ha creado en el clúster.

   kubectl get pv
   

8. Cree otro archivo de configuración para la PVC. Para que la PVC coincida con el PV que ha creado anteriormente, debe elegir el mismo valor para tamaño de almacenamiento y modalidad de acceso. En el campo de clase de almacenamiento, especifique un valor de serie vacío para que coincida con el PV. Si alguno de estos campos no coincide con el PV, se creará automáticamente un nuevo PV y una instancia de Block Storage for VPC a través del aprovisionamiento dinámico.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: <pvc_name>
   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: <vpc_block_storage_size>
     storageClassName: ""
   

9. Cree la PVC.

   kubectl apply -f pvc.yaml
   

10. Verifique que la PVC se ha creado y se ha enlazado al PV que ha creado con anterioridad. Este proceso puede tardar unos minutos.

kubectl describe pvc <pvc_name>

11. Cree un despliegue o un pod que utilice la PVC.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: <deployment_name>
  labels:
    app: <deployment_label>
spec:
  selector:
    matchLabels:
      app: <app_name>
  template:
    metadata:
      labels:
        app: <app_name>
    spec:
      containers:
      - image: <image_name>
        name: <container_name>
        volumeMounts:
        - name: <volume_name>
          mountPath: /<file_path>
      volumes:
      - name: <volume_name>
        persistentVolumeClaim:
          claimName: <pvc_name>
      nodeSelector:
        kubernetes.io/hostname: "<worker_node_primary_IP>"

Actualización del complemento de clúster Block Storage for VPC

Puede actualizar el complemento Block Storage for VPC del clúster utilizando el addon update comando.

Antes de actualizar el complemento, revise el registro de cambios.

Antes de actualizar a una versión " 5.x desde una versión anterior, no debe tener ninguna instantánea de volumen en estado " failure. Para obtener más información, consulte ¿Por qué no puedo eliminar mis recursos de Block Storage for VPC instantáneas de volumen?.

1. Compruebe si hay una actualización disponible. Si hay una actualización disponible, la versión del plugin se marca con un asterisco y se muestra la versión más reciente. Anote la versión más reciente, ya que este valor se utiliza más tarde.

   ibmcloud ks cluster addons --cluster <cluster_name_or_ID>
   

   Salida de ejemplo

   Name                   Version                 Health State   Health Status   
   vpc-block-csi-driver   1.0.0* (2.0.0 latest)   normal         Addon Ready
   

2. Actualice el complemento. Tenga en cuenta que los mandatos de actualización son diferentes en función de la versión que haya instalado.

   5.0 y posterior Ejecute el mandato addon update.

   ibmcloud ks cluster addon update vpc-block-csi-driver --cluster CLUSTER [-f] [-q] [--version VERSION] [-y]
   

   Todas las versiones anteriores a la versión 5.0 Inhabilite y habilite el complemento.

   ibmcloud ks cluster addon disable vpc-block-csi-driver --cluster CLUSTER [-f] [-q]
   

   ibmcloud ks cluster addon enable vpc-block-csi-driver --cluster CLUSTER [-f] [-q] [--version VERSION] [-y]
   

3. Verifique que el complemento se encuentra en el estado Addon Ready. El complemento puede tardar unos minutos en estar preparado.

   ibmcloud ks cluster addon ls --cluster <cluster_name_or_ID>
   

   Salida de ejemplo

   Name                   Version   Health State   Health Status   
   vpc-block-csi-driver   2.0.0     normal         Addon Ready
   

   Si utiliza una clase de almacenamiento predeterminada que no sea ibmc-vpc-block-10iops-tier, debe cambiar los valores de clase de almacenamiento predeterminada en el mapa de configuración de addon-vpc-block-csi-driver-configmap. Para obtener más información, consulte Cambio de la clase de almacenamiento predeterminada.

4. Si ha creado sus propias clases de almacenamiento basándose en las clases de almacenamiento predeterminadas de Block Storage for VPC, deberá volver a crear dichas clases de almacenamiento para actualizar los parámetros. Para obtener más información, consulte Recreación de sus propias clases de almacenamiento tras actualizar a la versión 4.2.

Configuración del cifrado para Block Storage for VPC

Utilice un proveedor de servicio de gestión de claves (KMS), como por ejemplo IBM® Key Protect, para crear una clave raíz privada que utilice en la instancia de Block Storage for VPC para cifrar los datos a medida que se graban en el almacenamiento. Después de crear la clave raíz privada, cree su propia clase de almacenamiento o un secreto Kubernetes con su clave raíz y, a continuación, utilice esta clase de almacenamiento o secreto para aprovisionar su instancia Block Storage for VPC.

Habilitar el cifrado afecta Block Storage for VPC al rendimiento en aproximadamente un 20 %. Sin embargo, el impacto exacto depende del nodo trabajador y de la configuración del volumen de almacenamiento. Considere la posibilidad de permitir impactos en el rendimiento al habilitar el cifrado.

1. Cree una instancia del proveedor KMS que desee utilizar.

   • Key Protect.
   • Hyper Protect Crypto Services.

2. Cree una clave raíz en su instancia de KMS.

   • Clave raíz de Key Protect.
   • Clave raíz de Hyper Protect Crypto Services. De forma predeterminada, la clave raíz se crea sin fecha de caducidad.

3. Configurar la autorización de servicio a servicio. Autorice a Block Storage for VPC a que acceda a IBM® Key Protect. Asegúrese de dar Block Storage for VPC al menos Reader acceso a su instancia KMS.

4. Decida si desea almacenar el CRN de clave raíz de Key Protect en una clase de almacenamiento personalizada o en un secreto de Kubernetes. A continuación, siga los pasos para crear una clase de almacenamiento personalizada o un secreto de Kubernetes.

   Ejemplo de clase de almacenamiento personalizada.

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: <storage_class_name> # Enter a name for your storage class.
   provisioner: vpc.block.csi.ibm.io
   parameters:
     profile: "5iops-tier"
     csi.storage.k8s.io/fstype: "ext4"
     billingType: "hourly"
     encrypted: "true"
     encryptionKey: "<encryption_key>"
     resourceGroup: ""
     zone: ""
     tags: ""
     generation: "gc"
     classVersion: "1"
   reclaimPolicy: "Delete"
   

   encrypted

   En los parámetros, introduzca true para crear una clase de almacenamiento que configure el cifrado para sus volúmenes Block Storage for VPC. Si establece esta opción en true, deberá proporcionar el CRN de la clave raíz de su instancia de servicio Key Protect que desea utilizar en parameters.encryptionKey.

   encryptionKey

   En los parámetros, especifique el CRN de la clave raíz que ha recuperado antes.

   Ejemplo de secreto Kubernetes.

   apiVersion: v1
   kind: Secret
   type: vpc.block.csi.ibm.io
   metadata:
     name: <secret_name>
     namespace: <namespace_name>
   stringData:
     encrypted: <true_or_false>
   data
     encryptionKey: <encryption_key>
   

   name

   Especifique un nombre para el secreto.

   namespace

   Especifique el espacio de nombres en el que desea crear el secreto.

   encrypted

   En los parámetros, introduzca true para configurar el cifrado de sus volúmenes Block Storage for VPC.

   encryptionKey

   En los parámetros, especifique el CRN de la clave raíz de la instancia de servicio de Key Protect que desea utilizar para cifrar el volumen de Block Storage for VPC. Para utilizar el CRN de clave raíz en un secreto, primero debe convertirlo a base64 ejecutando echo -n "<root_key_CRN>" | base64.

5. Siga los pasos 4-9 de Adición de Block Storage for VPC a sus apps para crear una PVC con la clase de almacenamiento personalizada para suministrar Block Storage for VPC configurado para el cifrado con la clave raíz de Key Protect. A continuación, monte este almacenamiento en un pod de app.

   La app puede tardar unos minutos en montar el almacenamiento y entrar en el estado Running.

6. Verifique que los datos están cifrados. Consulte los volúmenes de Block Storage for VPC y anote el ID de la instancia que ha creado. El Nombre de la instancia de almacenamiento es igual que el nombre del PV que se ha creado automáticamente al crear la PVC.

   ibmcloud is vols
   

   Salida de ejemplo

   ID                                     Name                                       Status      Capacity   IOPS   Profile           Attachment type   Created                     Zone         Resource group
   a395b603-74bf-4703-8fcb-b68e0b4d6960   pvc-479d590f-ca72-4df2-a30a-0941fceeca42   available   10         3000   5iops-tier        data              2019-08-17T12:29:18-05:00   us-south-1   a8a12accd63b437bbd6d58fb6a462ca7
   

7. Utilizando el ID del volumen, consulte los detalles de la instancia de Block Storage for VPC para asegurarse de que la clave raíz de Key Protect está almacenada en la instancia de almacenamiento. Encontrará la clave raíz en el campo Encryption key de la información de salida de la CLI.

   ibmcloud is vol <volume_ID>
   

   Salida de ejemplo

   ID                                     a395b603-74bf-4703-8fcb-b68e0b4d6960   
   Name                                   pvc-479d590f-ca72-4df2-a30a-0941fceeca42   
   Status                                 available   
   Capacity                               10   
   IOPS                                   3000   
   Profile                                5iops-tier   
   Encryption key                         crn:v1:bluemix:public:kms:us-south:a/6ef045fd2b43266cfe8e6388dd2ec098:53369322-958b-421c-911a-c9ae8d5156d1:key:47a985d1-5f5e-4477-93fc-12ce9bae343f   
   Encryption                             user_managed   
   Resource group                         a8a12accd63b437bbd6d58fb6a462ca7
   Created                                2019-08-17T12:29:18-05:00
   Zone                                   us-south-1   
   Volume Attachment Instance Reference
   

Personalización de los valores de almacenamiento predeterminados

Puede cambiar algunos valores de PVC predeterminados utilizando una clase de almacenamiento personalizada o un secreto de Kubernetes para crear Block Storage for VPC con valores personalizados.

¿Cuál es la ventaja de utilizar un secreto y especificar mis parámetros en una clase de almacenamiento personalizada?

Como administrador de clúster, cree una clase de almacenamiento personalizada cuando desee que todas las PVC que creen los usuarios de clúster se suministren con una configuración específica y no desee permitir que los usuarios de clúster alteren temporalmente la configuración predeterminada.

Sin embargo, si se necesitan varias configuraciones y no desea crear una clase de almacenamiento personalizada para cada configuración de PVC posible, puede crear una clase de almacenamiento personalizado con los valores de PVC predeterminados y una referencia a un secreto de Kubernetes genérico. Si los usuarios del clúster deben modificar los valores predeterminados de la clase de almacenamiento personalizada, pueden hacerlo creando un secreto de Kubernetes que contenga sus valores personalizados.

Cuando desee configurar el cifrado para la instancia de Block Storage for VPC, también puede utilizar un secreto de Kubernetes si desea codificar el CRN de clave raíz de Key Protect en base64 en lugar de proporcionar la clave directamente en la clase de almacenamiento personalizada.

Configuración de la expansión del volumen

Para suministrar volúmenes que admitan la expansión, debe utilizar la clase de almacenamiento que tiene allowVolumeExpansion establecido en true.

Solo puede ampliar volúmenes montados por un pod de app.

Inicie una sesión en la cuenta. If applicable, target the appropriate resource group. Establezca el contexto para el clúster.

1. Si no está utilizando la versión 4.2 o posterior del complemento, actualice el complemento de clúster Block Storage for VPC en su clúster.

2. Cree una PVC que utilice una clase de almacenamiento que admita la expansión de volumen.

3. Despliegue una app que utilice la PVC. Cuando cree la app, tome nota del mountPath que especifique.

4. Después de montar la PVC mediante un pod de app, puede ampliar el volumen editando el valor del campo spec.resources.requests.storage de la PVC. Para ampliar el volumen, edite la PVC y aumente el valor del campo spec.resources.requests.storage.

   kubectl edit pvc <pvc-name>
   

   Ejemplo

   spec:
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 10Gi
   

5. Guarde y cierre la PVC.

6. Opcional: compruebe que el volumen se ha ampliado. Obtenga los detalles de la PVC y tome nota del nombre de PV.

   kubectl get pvc <pvc-name>
   

7. Describa el PV y anote el ID de volumen.

   kubectl describe PV
   

8. Obtenga los detalles del volumen de Block Storage for VPC y verifique la capacidad.

   ibmcloud is vol <volume-ID>
   

Copia de seguridad y restauración de datos

Los datos de Block Storage for VPC están protegidos en las zonas de error redundantes de la región. Para realizar una copia de seguridad manual de los datos, utilice el mandato Kubernetes kubectl cp.

Puede utilizar kubectl cp comando para copiar archivos y directorios desde y hacia pods o contenedores específicos de su cluster

Antes de empezar: Inicie una sesión en su cuenta. If applicable, target the appropriate resource group. Establezca el contexto para el clúster.

Para hacer una copia de seguridad o para restaurar datos, elija entre las opciones siguientes:

Copie los datos de la máquina local en un pod del clúster.

kubectl cp <local_filepath>/<filename> <namespace>/<pod>:<pod_filepath>

Copie los datos de un pod del clúster en la máquina local.

kubectl cp <namespace>/<pod>:<pod_filepath>/<filename> <local_filepath>/<filename>

Copie los datos de la máquina local en un contenedor concreto que ejecute en un pod del clúster.

kubectl cp <local_filepath>/<filename> <namespace>/<pod>:<pod_filepath> -c CONTAINER

Descripción de la capacidad de solicitud de volumen

El controlador CSI de bloque de VPC calcula la capacidad de volumen utilizando la fórmula siguiente.

• Si se proporciona el valor en Gi: rBytes(requestedBytes) = X * 1024^3

• Si se proporciona el valor en G: rBytes(requestedBytes) = X * 10^9

El valor solicitado es igual a (((rBytes+ GiB - 1) / GiB) * GiB) / GiB.

Por ejemplo:

• Si se proporciona un valor de 20Gi, aplicando la fórmula anterior, el volumen que se crea es 20GB.
• Si se proporciona un valor de 20G, el volumen que se crea es 19GB.

A veces, la capacidad del volumen que se crea es menor que el valor solicitado. Tenga en cuenta que la facturación se aplica al volumen que se crea, no al volumen solicitado.

Asignación de perfiles de confianza al almacenamiento en bloque

Debido a un problema conocido, es posible que las actualizaciones de las etiquetas de usuario en los Block Storage volúmenes VPC no se muestren cuando se implementa un perfil de confianza. Este problema no se presenta en los clusters que no utilizan perfiles de confianza.

Puede utilizar perfiles de confianza para conceder a diferentes identidades de IBM Cloud acceso a los recursos de su cuenta, incluidas sus soluciones de almacenamiento. Los perfiles de confianza centralizan el control de acceso, eliminan la necesidad de claves API de larga duración y permiten limitar los permisos al mínimo necesario para una tarea específica. Para obtener más información, consulte Configuración de un perfil de confianza para componentes de almacenamiento.