Compreensão da criação e remoção de baldes

• Você pode usar um bucket existente especificando o nome do bucket em seu PVC.
• Se você fornecer um nome de bucket e esse bucket não existir, será criado um bucket com esse nome.
• Se você não especificar um nome de bucket, será criado um bucket seguindo a convenção de nomenclatura s3fs-<timestamp>-xxx ou rclone-<timestamp>-xxx, dependendo do tipo de montador.
• Os compartimentos são excluídos com base na política de recuperação definida em sua classe de armazenamento.
  • Se reclaimPolicy: Delete for definido, o bucket será excluído quando o PVC for excluído.
  • Se reclaimPolicy: Retain for definido, o bucket será mantido mesmo depois que o PVC for excluído.

Restrição do agendamento de pods do nodeserver

Por padrão, os pods do servidor de nós do driver COS CSI são agendados em todos os nós do cluster. Você pode usar o parâmetro restrictNodeServerScheduling para restringir o agendamento de pods do nodeserver apenas aos nós rotulados com cos.csi.ibm.io/csi-node=true``.

Você pode configurar o restrictNodeServerScheduling ao ativar o complemento ou atualizá-lo posteriormente aplicando o patch no ConfigMap.

• Para definir restrictNodeServerScheduling ao ativar o complemento, inclua o sinalizador --param no comando de ativação.

  ibmcloud oc cluster addon enable ibm-object-csi-driver --cluster CLUSTER --param "restrictNodeServerScheduling=true"
  

• Para atualizar o “ restrictNodeServerScheduling ” depois que o complemento já estiver ativado, siga estas etapas.

1. Liste os nós do seu cluster e determine onde você deseja que os pods do driver COS sejam executados.

   oc get nodes
   

   Exemplo de saída

   NAME            STATUS   ROLES    AGE    VERSION
   10.241.0.11     Ready    <none>   5d2h   v1.35.5+IKS
   10.241.0.12     Ready    <none>   5d2h   v1.35.5+IKS
   10.241.0.13     Ready    <none>   5d2h   v1.35.5+IKS
   10.241.128.10   Ready    <none>   5d2h   v1.35.5+IKS
   10.241.128.11   Ready    <none>   5d2h   v1.35.5+IKS
   10.241.128.9    Ready    <none>   5d2h   v1.35.5+IKS
   10.241.65.12    Ready    <none>   5d2h   v1.35.5+IKS
   10.241.65.13    Ready    <none>   5d2h   v1.35.5+IKS
   10.241.65.14    Ready    <none>   5d2h   v1.35.5+IKS
   

2. Verifique se os pods do nodeserver estão em execução em todos os nós.

   oc get pods -n ibm-object-csi-operator -l app.kubernetes.io/component=node -o wide
   

   Exemplo de saída

   NAME                        READY   STATUS    RESTARTS   AGE    IP              NODE            NOMINATED NODE   READINESS GATES
   ibm-object-csi-node-2pj2j   3/3     Running   0          145m   172.17.14.10    10.241.0.12     <none>           <none>
   ibm-object-csi-node-7bhwh   3/3     Running   0          145m   172.17.1.72     10.241.65.12    <none>           <none>
   ibm-object-csi-node-7l9hc   3/3     Running   0          145m   172.17.17.6     10.241.128.9    <none>           <none>
   ibm-object-csi-node-cxzt7   3/3     Running   0          145m   172.17.39.72    10.241.0.11     <none>           <none>
   ibm-object-csi-node-dw6qs   3/3     Running   0          145m   172.17.46.77    10.241.128.10   <none>           <none>
   ibm-object-csi-node-rpcvr   3/3     Running   0          145m   172.17.32.198   10.241.65.13    <none>           <none>
   ibm-object-csi-node-swqtg   3/3     Running   0          145m   172.17.16.69    10.241.0.13     <none>           <none>
   ibm-object-csi-node-sxbbs   3/3     Running   0          145m   172.17.26.7     10.241.65.14    <none>           <none>
   ibm-object-csi-node-xm8bt   3/3     Running   0          145m   172.17.20.200   10.241.128.11   <none>           <none>
   

3. Identifique os nós nos quais você deseja que os pods do nodeserver sejam agendados.

   oc label nodes NODE-NAME-1 NODE-NAME-2 cos.csi.ibm.io/csi-node=true
   

   Exemplo de saída

   node/10.241.0.11 labeled
   node/10.241.0.12 labeled
   

4. Ative a restrição atualizando o arquivo ConfigMap.

   oc patch cm managed-addon-ibm-object-csi-driver -n kube-system \
     --type merge -p '{"data":{"restrictNodeServerScheduling":"true"}}'
   

   Exemplo de saída

   configmap/managed-addon-ibm-object-csi-driver patched
   

5. Verifique se os pods do nodeserver são agendados apenas em nós rotulados.

   oc get pods -n ibm-object-csi-operator -l app.kubernetes.io/component=node -o wide
   

   Exemplo de saída

   NAME                        READY   STATUS    RESTARTS   AGE    IP             NODE           NOMINATED NODE   READINESS GATES
   ibm-object-csi-node-cxzt7   3/3     Running   0          145m   172.17.39.72   10.241.0.11    <none>           <none>
   ibm-object-csi-node-7bhwh   3/3     Running   0          145m   172.17.1.72    10.241.65.12   <none>           <none>
   

Definição dos volumes máximos por nó

Por padrão, o driver COS CSI não limita o número de volumes que podem ser montados em um único nó. Você pode usar o parâmetro maxVolumesPerNode para definir um número máximo de volumes por nó.

Você pode configurar o maxVolumesPerNode ao ativar o complemento ou atualizá-lo posteriormente aplicando o patch no ConfigMap.

• Para definir maxVolumesPerNode ao ativar o complemento, inclua o sinalizador --param no comando de ativação.

  ibmcloud oc cluster addon enable ibm-object-csi-driver --cluster CLUSTER --param "maxVolumesPerNode=VALUE"
  

• Para atualizar o maxVolumesPerNode depois que o complemento já estiver habilitado, aplique a correção ao complemento gerenciado ConfigMap.

  oc patch cm managed-addon-ibm-object-csi-driver -n kube-system --type merge -p '{"data":{"maxVolumesPerNode":"VALUE"}}'
  

  Exemplo de saída

  configmap/managed-addon-ibm-object-csi-driver patched
  

Implantar um aplicativo que utiliza IBM Cloud Object Storage

cos.csi.driver/secret: "<custom-secret>"

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: cos-secret-1 # Give your PVC the same name as the secret you created in the previous step.
  namespace: <namespace> # The namespace where you want to create the PVC.
spec:
  accessModes:
  - ReadWriteMany
  resources:
    requests:
      storage: 10Gi
  storageClassName: <storage_class_name> # The storage class you want to use.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: cos-csi-pvc1
  namespace: <namespace> # The namespace where you want to create the PVC.
  annotations:
    cos.csi.driver/secret: "<custom-secret>"
spec:
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 256Mi
  storageClassName: <storage_class_name> # The storage class you want to use.

Desativando o complemento IBM Cloud Object Storage

Os segredos, PVCs e implantações existentes não são excluídos pela desativação do complemento ou por atualizações de patches. Não há interrupções nas cargas de trabalho existentes dos clientes.

1. Execute o comando a seguir para desativar o complemento.

    ibmcloud oc cluster addon disable ibm-object-csi-driver --cluster CLUSTER
   

   Exemplo de saída

   Data and resources that you created for the add-on might be deleted when the add-on is disabled. Continue? [y/N]> y
   Disabling add-on ibm-object-csi-driver for cluster XXX...
   OK
   

2. Verifique se o complemento foi removido.

   ibmcloud oc cluster addon ls --cluster CLUSTER
   

Migração do plug-in Helm para o complemento de cluster

1. Acesse o seu Red Hat OpenShift cluster.

2. Obtenha os detalhes de seus PVCs e selecione um para migrar.

   oc get pvc --all-namespaces -o custom-columns='NAMESPACE:.metadata.namespace,NAME:.metadata.name' | tail -n +2 | while read namespace pvc; do kubectl describe pvc "$pvc" -n "$namespace" | grep 'volume.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs' > /dev/null ; if [ $? -eq 0 ]; then echo "PVC: $pvc in Namespace: $namespace uses ibm.io/ibmc-s3fs storage provisioner"; fi; done
   

   Exemplo de saída

   PVC: pvc-test in Namespace: default uses ibm.io/ibmc-s3fs storage provisioner
   

3. Descreva o PVC e obtenha o nome do balde.

   oc describe pvc <pvc_name> | grep ibm.io/bucket:
   

   Exemplo de saída

   ibm.io/bucket: test-s3
   

4. Recrie seu segredo com o nome do balde incluído.

   apiVersion: v1
   kind: Secret
   type: cos-s3-csi-driver
   metadata:
       name: cos-secret-1 # Name your secret.
       namespace: <namespace> # Specify the namespace where you want to create the secret.
   data:
       accessKey: <base64-encoded-HMAC-access-key>
       secretKey: <base64-encoded-HMAC-secret-key>
   stringData:
       bucketName: <bucket-name>
       mountOptions: |
           # uid=3000  # Optional: Run as non-root user. Must match runAsUser in SecurityContext of pod spec.
           key1=value1
           key2=value2
   

5. Encontre a classe de armazenamento que foi usada em seu PVC.

   oc describe pvc <pvc_name> | grep StorageClass:
   

   Exemplo de comando para um PVC chamado test-s3.

   oc describe pvc test-s3 | grep StorageClass:
   

   Exemplo de saída

   StorageClass:  ibmc-s3fs-smart-perf-regional
   

6. Revise as novas classes de armazenamento disponíveis com o add-on e selecione uma classe de substituição.

   • Se você usou uma classe flex, escolha uma das novas classes smart.
   • Se você usou uma classe standard, escolha uma das novas classes standard.
   • As classes cold e vault não estão mais disponíveis com o add-on; em vez disso, escolha uma classe smart ou standard.

7. Analise os detalhes de seu PVC.

   oc describe pvc test-s3
   

   Exemplo de saída

   Name:          pvc-test
   Namespace:     default
   StorageClass:  ibmc-s3fs-smart-perf-regional
   Status:        Bound
   Volume:        pvc-c625474d-31f0-4929-bc3e-feace1fb42fb
   Labels:        <none>
   Annotations:   ibm.io/auto-create-bucket: true
               ibm.io/auto-delete-bucket: true
               ibm.io/bucket: bha-test-s23
               ibm.io/secret-name: satstoragesecret
               pv.kubernetes.io/bind-completed: yes
               pv.kubernetes.io/bound-by-controller: yes
               volume.kubernetes.io/storage-provisioner: ibm.io/ibmc-s3fs
   Finalizers:    [kubernetes.io/pvc-protection]
   Capacity:      3Gi
   Access Modes:  RWO
   VolumeMode:    Filesystem
   Used By:       test-pod
   Events:        <none>
   

8. Crie um PVC de substituição que use uma nova classe de armazenamento e faça referência ao segredo que você criou anteriormente.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
   name: cos-csi-pvc1
   namespace: <namespace> # The namespace where you want to create the PVC.
   annotations:
       cos.csi.driver/secret: "cos-secret-1"  # Secret created in step 4
   spec:
   accessModes:
   - ReadWriteOnce
   resources:
       requests:
       storage: 256Mi
   storageClassName: <storage_class_name> # The storage class you picked based on old storage class mapping.
   

9. Verifique se o PVC é Bound.

   oc get pvc
   

10. Veja os detalhes do seu aplicativo.

    oc get pods
    

11. Reduza seu aplicativo a zero.

    kubectl scale deployment --replicas=0 my-app
    

12. Crie uma implantação de substituição que faça referência ao PVC que você criou na etapa anterior.

13. Depois que a nova implantação estiver em execução, você poderá excluir a implantação antiga.

14. Repita essas etapas para cada PVC que você deseja migrar.

IBM Cloud Object Storage classes de armazenamento complementares do cluster

O complemento de cluster IBM Cloud Object Storage fornece classes de armazenamento para os montadores s3fs e rclone. Escolha uma classe de armazenamento que se ajuste aos seus requisitos de acesso a dados. A classe de armazenamento determina a classe do bucket, a política de recuperação e o comportamento de montagem padrão para o bucket criado para sua carga de trabalho.

Standard

Utilize para dados de uso frequente que são acessados com frequência. Casos de uso comuns são apps da web ou móveis.

Vault

Utilize para cargas de trabalho ou dados pouco utilizados, acessados com pouca frequência, como uma vez por mês ou menos. Os casos de uso comum são archives, retenção de dados de curto prazo, preservação de ativo digital, substituição de fita e recuperação de desastre.

Frio

Utilize para dados pouco acessados (a cada 90 dias ou menos) ou dados inativos. Os casos de uso comum são archives, backups de longo prazo, dados históricos que você mantém para conformidade ou cargas de trabalho e apps que são raramente acessados.

Inteligente

Use para cargas de trabalho e dados que não seguem um padrão de uso específico ou quando for difícil prever o padrão de uso.

Decida sobre o nível de resiliência para os dados que estão armazenados em seu bucket. Para obter mais informações, consulte Regiões e terminais.

região cruzada

Seus dados são armazenados em três regiões dentro de uma mesma área geográfica, garantindo a máxima disponibilidade. Se você tiver cargas de trabalho que estão distribuídas entre regiões, as solicitações serão roteadas para o terminal regional mais próximo. O endpoint IBM Cloud Object Storage para a geolocalização é definido automaticamente com base na localização do seu cluster. Por exemplo, se o seu cluster estiver em US South, suas classes de armazenamento estarão configuradas para usar o endpoint US GEO para seus buckets. Escolha uma classe de armazenamento cujo nome inclua “ cross-region ”.

Regional

Seus dados são replicados em várias zonas dentro de uma mesma região. Se tiver cargas de trabalho que estão localizadas na mesma região, você verá latência inferior e melhor desempenho do que em uma configuração entre regiões. O endpoint regional é definido automaticamente com base na localização do seu cluster. Por exemplo, se o seu cluster estiver em US South, suas classes de armazenamento estarão configuradas para usar US South como o endpoint regional dos seus buckets. Escolha uma classe de armazenamento cujo nome não inclua “ cross-region ”.

Para revisar a configuração detalhada do bucket para uma classe de armazenamento, execute oc describe storageclass <storageclass_name> ou oc describe storageclass <storageclass_name>.