Configuração do StorageClass

O banco de dados do Cassandra usa volumes permanentes criados dinamicamente para armazenar dados. Para o funcionamento adequado do banco de dados, a Apigee exige que você configure uma definição de StorageClass que seja baseada em uma unidade de estado sólido (SSD).

Se você não tiver o SSD configurado para o Cassandra, este tópico explica como criar um novo StorageClass que usa o SSD e torná-lo a classe padrão. Quando o Cassandra é iniciado, ele usa essa StorageClass padrão.

As etapas descritas neste tópico para a configuração do StorageClass são aplicáveis somente a uma nova instalação do Cassandra. Se você já tiver uma classe do Cassandra instalada, precisará desativar o cluster existente para configurar a definição do StorageClass. Não há suporte para alterações na definição do StorageClass de um cluster existente do Cassandra após a instalação.

A Apigee recomenda implantar o modelo híbrido em duas ou mais regiões para desativar e reinstalar uma região, preservando os dados na região secundária. Como alternativa, é possível usar um backup híbrido não CSI para restaurar dados em uma instalação de região única, após a desativação e a configuração da definição do StorageClass necessária.

Alterar o StorageClass padrão

As etapas a seguir explicam como criar uma StorageClass e torná-la a classe padrão. Para mais informações, consulte Alterar a classe de armazenamento padrão na documentação do Kubernetes.

  1. Consiga o nome da StorageClass padrão atual:
    kubectl get sc

    Exemplo:

    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. Descreva a StorageClass chamada standard-rwo. Observe que o tipo dela é pd-balanced:
    kubectl describe sc standard-rwo

    Exemplo:

    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. Crie um novo arquivo chamado storageclass.yaml.
  4. Adicione este código ao arquivo. Observe que o nome da nova classe é apigee-sc. Use o nome que preferir. Além disso, o tipo de armazenamento é 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. Aplique a nova StorageClass ao cluster do Kubernetes:
    kubectl apply -f storageclass.yaml
  6. Execute os dois comandos a seguir para alterar a StorageClass padrão:
    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. Execute este comando para verificar se a nova StorageClass padrão é chamada apigee-sc:
    kubectl get sc

    Exemplo:

    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. Descreva o StorageClass para verificar o 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: