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 fornecer um nome de bucket, será criado um bucket com a convenção de nomenclatura temp-xxx.
• 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
  

Implantação de 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>
       # uid: "3000" # Optional: Provide a uid to run as non root user. This must match runAsUser in SecurityContext of pod spec.
       mountOptions: |
           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

Use para dados quentes que você acessa com frequência, como dados para aplicativos da Web ou móveis.

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.

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>.