Configuración de StorageClass

La base de datos de Cassandra usa volúmenes persistentes creados de forma dinámica para almacenar datos. Para que una base de datos funcione de forma adecuada, Apigee requiere que configures una definición de StorageClass con el respaldo de una unidad de estado sólido (SSD).

Si no tienes SSD configurado para Cassandra, en este tema se explica cómo crear una nueva StorageClass que use SSD y convertirla en la clase predeterminada. Cuando Cassandra se inicie, usará esta definición de StorageClass predeterminada.

Los pasos descritos en este tema para la configuración de StorageClass solo se aplican a una instalación nueva de Cassandra. Si ya tienes una clase de Cassandra instalada, debes retirar el clúster existente para configurar la definición de StorageClass. No se admiten los cambios en la definición de StorageClass de un clúster de Cassandra existente después de la instalación.

Apigee recomienda implementar hybrid en dos o más regiones para retirar y volver a instalar una región mientras conservas los datos en la región secundaria. Como alternativa, puedes usar una copia de seguridad híbrida que no sea de CSI para restablecer los datos en una instalación de una sola región, después de retirar y configurar la definición de StorageClass requerida.

Cambia la definición de StorageClass predeterminada

En los siguientes, pasos se explica cómo crear una StorageClass y convertirla en la clase predeterminada. Para obtener más información, consulta Cambia la clase de almacenamiento predeterminada en la documentación de Kubernetes.

  1. Obtén el nombre de la StorageClass predeterminada actual:
    kubectl get sc

    Por ejemplo:

    kubectl get sc
        NAME                    PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
        premium-rwo             pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
        standard                kubernetes.io/gce-pd    Delete          Immediate              true                   15h
        standard-rwo (default)  pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
      
  2. Describe la StorageClass llamada standard-rwo. Ten en cuenta que su tipo es pd-balanced:
    kubectl describe sc standard-rwo

    Por ejemplo:

    kubectl describe sc standard-rwo
    Name:                  standard-rwo
    IsDefaultClass:        Yes
    Annotations:           components.gke.io/layer=addon,storageclass.kubernetes.io/is-default-class=false
    Provisioner:           pd.csi.storage.gke.io
    Parameters:            type=pd-balanced
    AllowVolumeExpansion:  True
    MountOptions:          <none>
    ReclaimPolicy:         Delete
    VolumeBindingMode:     WaitForFirstConsumer
    Events:                <none>
  3. Crea un archivo nuevo llamado storageclass.yaml de la siguiente manera:
  4. Agrega este código al archivo. Ten en cuenta que el nombre de la clase nueva es apigee-sc. Puedes usar cualquier nombre que desees. Además, ten en cuenta que el tipo de almacenamiento es pd-ssd:
    ---
    kind: StorageClass
    apiVersion: storage.k8s.io/v1
    metadata:
      name: "apigee-sc"
    provisioner: pd.csi.storage.gke.io
    parameters:
      type: pd-ssd
      replication-type: none
    volumeBindingMode: WaitForFirstConsumer
    allowVolumeExpansion: true
  5. Aplica la StorageClass nueva a tu clúster de Kubernetes:
    kubectl apply -f storageclass.yaml
  6. Ejecuta los dos comandos siguientes para cambiar la StorageClass predeterminada:
    kubectl patch storageclass standard-rwo \
      -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'
    kubectl patch storageclass apigee-sc \
      -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'
  7. Ejecuta este comando para verificar que la StorageClass predeterminada nueva se llame apigee-sc:
    kubectl get sc

    Por ejemplo:

    kubectl get sc
        NAME                  PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
        apigee-sc (default)   pd.csi.storage.gke.io    Delete          WaitForFirstConsumer   true                   14h
        premium-rwo           pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
        standard              kubernetes.io/gce-pd    Delete          Immediate              true                   15h
        standard-rwo          pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
      
  8. Describe ambas StorageClass para verificar el valor de IsDefaultClass.
    kubectl describe sc apigee-sc
        Name:            apigee-sc
        IsDefaultClass:  Yes
        Annotations:     kubectl.kubernetes.io/last-applied-configuration={"allowVolumeExpansion":true,"apiVersion":"storage.k8s.io/v1","kind":"StorageClass","metadata":{"annotations":{},"name":"apigee-sc"},"parameters":{"replication-type":"none","type":"pd-ssd"},"provisioner":"pd.csi.storage.gke.io","volumeBindingMode":"WaitForFirstConsumer"}
        ,storageclass.kubernetes.io/is-default-class=true
        Provisioner:           pd.csi.storage.gke.io
        Parameters:            replication-type=none,type=pd-ssd
        AllowVolumeExpansion:  True
        MountOptions:          
        ReclaimPolicy:         Delete
        VolumeBindingMode:     WaitForFirstConsumer
        Events:                
        
    kubectl describe sc standard-rwo
        Name:                  standard-rwo
        IsDefaultClass:        No
        Annotations:           components.gke.io/layer=addon,storageclass.kubernetes.io/is-default-class=false
        Provisioner:           pd.csi.storage.gke.io
        Parameters:            type=pd-balanced
        AllowVolumeExpansion:  True
        MountOptions:          
        ReclaimPolicy:         Delete
        VolumeBindingMode:     WaitForFirstConsumer
        Events: