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.

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

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>

Crie um novo arquivo chamado storageclass.yaml.

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

Aplique a nova StorageClass ao cluster do Kubernetes:
```
kubectl apply -f storageclass.yaml
```

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"}}}'

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

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: