Pré-requisitos para o ODF

Nós de trabalho bare metal com armazenamento NVME local

Use variantes com o sufixo d que incluem discos NVME locais.

Requisitos do nó de trabalho

O ODF requer pelo menos 3 nós de trabalho para alta disponibilidade e redundância de dados.

Configuração da zona

• OpenShift Implantações de virtualização: Os clusters de zona única são recomendados para minimizar a latência do armazenamento para cargas de trabalho do VM. Embora as implementações em várias zonas ofereçam melhor alta disponibilidade, a replicação de armazenamento entre zonas pode afetar o desempenho do site VM.
• Implantações gerais de ODF: Recomenda-se pelo menos 3 zonas para alta disponibilidade e recuperação de desastres.

Instalando o ODF pelo terminal

1. Faça login na sua conta IBM Cloud e navegue até seu cluster.

2. Clique em Add-ons na navegação do cluster.

3. Na placa “OpenShift Data Foundation ”, clique em “Instalar ”.

4. Selecione a opção Armazenamento local.

   O anexo de volume de bloco remoto não é compatível com os nós bare metal da VPC.

5. Escolha um dos seguintes métodos de descoberta:

   Descoberta automática (recomendado)

   Selecione Descoberta automática para detectar e usar automaticamente os discos disponíveis em seus nós de trabalho bare metal.

   Especificação do disco manual

   Se você preferir especificar os discos manualmente, siga estas etapas:

   1. Faça login em cada nó de trabalho para identificar os discos disponíveis.

      oc debug node/<node-name>
      

   2. Permitir binários do host.

      chroot /host
      

   3. Listar os dispositivos disponíveis.

      lsblk
      

   4. Encontre o by-id de cada disco.

      ls -l /dev/disk/by-id/
      

   5. Adicione as IDs de disco no parâmetro IDs de disco do pod OSD.

6. Configure parâmetros adicionais conforme necessário:

   • Perfil do recurso: Escolha balanced ou performance com base em sua carga de trabalho
   • Criptografia: Ative a criptografia com Hyper Protect Crypto Services, se necessário
   • Número de discos OSD: Especifique o número de discos por nó de trabalho

7. Clique em Install (Instalar ) para implantar o ODF.

Para obter mais informações sobre os parâmetros do ODF, consulte OpenShift Referência de parâmetros do Data Foundation.

Instalando o ODF pela CLI

1. Analise as opções de complementos disponíveis.

   ibmcloud oc cluster addon options --addon openshift-data-foundation --version 4.20.0
   

2. Habilite o complemento do OpenShift Data Foundation com descoberta automática de disco e suporte à virtualização.

   ibmcloud oc cluster addon enable openshift-data-foundation \
     -c <cluster-name> \
     --version 4.20.0 \
     --param "odfDeploy=true" \
     --param "osdStorageClassName=localblock" \
     --param "autoDiscoverDevices=true" \
     --param "resourceProfile=performance" \
     --param "setDefaultStorageClassForVirtualization=true"
   

3. Verifique se o complemento está no estado “Pronto”.

   oc get storagecluster -n openshift-storage
   

   Saída de exemplo:

   NAME                 AGE   PHASE   EXTERNAL   CREATED AT             VERSION
   ocs-storagecluster   53m   Ready              2025-03-10T12:20:52Z   4.20.0
   

Verificação da instalação do ODF

1. Verifique o status do cluster de armazenamento.

   oc get storagecluster -n openshift-storage
   

2. Verifique se as classes de armazenamento estão disponíveis.

   oc get storageclass | grep ocs
   

3. Confirme se os pods ODF estão em execução.

   oc get pods -n openshift-storage
   

Para obter mais informações sobre a implantação do ODF, consulte Implantação do OpenShift Data Foundation em clusters VPC.

Pré-requisitos para o VPC File Storage

• Qualquer versão de bare metal compatível
• Infraestrutura de VPC

Passo 1: Desativar o " Block Storage " da VPC como padrão

1. Edite o mapa de configuração do driver CSI do VPC Block.

   oc edit cm addon-vpc-block-csi-driver-configmap -n kube-system
   

2. Configure IsStorageClassDefault para false.

   data:
     IsStorageClassDefault: "false"
   

3. Salve e saia do editor.

Etapa 2: Instalar o driver CSI do arquivo VPC

Etapa 3: Definir uma classe de armazenamento padrão

1. Liste as classes de armazenamento disponíveis.

   oc get storageclass | grep vpc-file
   

2. Escolha uma classe de armazenamento adequada com base na sua carga de trabalho:

   • ibmc-vpc-file-1000-iops: Para cargas de trabalho moderadas (40 GB - 2.000 IOPS)
   • ibmc-vpc-file-6000-iops: Para cargas de trabalho mais intensas (100 GB - 6.000 IOPS)
   • ibmc-vpc-file-metro-1000-iops: Para implantações em várias zonas

3. Edite o mapa de configuração do driver CSI do arquivo VPC.

   oc edit cm addon-vpc-file-csi-driver-configmap -n kube-system
   

4. Defina o campo “ SET_DEFAULT_STORAGE_CLASS ” com a classe de armazenamento de sua preferência.

   data:
     SET_DEFAULT_STORAGE_CLASS: "ibmc-vpc-file-metro-1000-iops"
   

5. Salve e saia do editor.

6. Aguarde alguns minutos para que as alterações entrem em vigor.

7. Verifique a classe de armazenamento padrão.

   oc get storageclass | grep "(default)"
   

Etapa 4: Configurar perfis de armazenamento para a VPC File Storage

Após instalar o Operador de Virtualização do OpenShift, é necessário configurar perfis de armazenamento para o VPC File Storage, pois o Container Disk Importer (CDI) não reconhece automaticamente as propriedades do VPC File Storage.

Esta etapa deve ser concluída após a instalação do Operador de Virtualização do OpenShift.

for sp in $(oc get storageprofile.cdi.kubevirt.io -o json | jq -r '.items[] | select(.status.provisioner == "vpc.file.csi.ibm.io") | .metadata.name'); do
  oc patch storageprofile.cdi.kubevirt.io "$sp" --type=merge -p '{
    "spec": {
      "claimPropertySets": [
        {
          "accessModes": ["ReadWriteMany"],
          "volumeMode": "Filesystem"
        }
      ]
    }
  }'
done

Verificação da instalação do VPC ( File Storage )

1. Verifique se os pods do driver CSI do arquivo VPC estão em execução.

   oc get pods -n kube-system | grep vpc-file
   

2. Verifique se a classe de armazenamento padrão está definida corretamente.

   oc get storageclass | grep "(default)"
   

3. Teste o provisionamento de armazenamento criando um PVC de teste.

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: test-pvc
   spec:
     accessModes:
     - ReadWriteMany
     resources:
       requests:
         storage: 10Gi
   

4. Verifique se o PVC está bem preso.

   oc get pvc test-pvc
   

5. Exclua o PVC de teste.

   oc delete pvc test-pvc
   

Falha na instalação do ODF

Se a instalação do ODF falhar, verifique o seguinte:

• Verifique se os nós bare metal têm armazenamento NVME local
• Certifique-se de ter pelo menos 3 nós de trabalho
• Verifique se os discos estão desmontados e sem formatação
• Analise os registros do operador do ODF: oc logs -n openshift-storage -l app=ocs-operator

File Storage e de VPC; PVCs continuam pendentes

Se os PVCs permanecerem em estado pendente:

• Verifique se o complemento do driver CSI do arquivo VPC está instalado e funcionando corretamente
• Verifique se a classe de armazenamento padrão está definida corretamente
• Certifique-se de que os perfis de armazenamento estejam configurados com o modo de acesso RWX
• Analisar os registros do driver CSI: oc logs -n kube-system -l app=ibm-vpc-file-csi-controller

Perfis de armazenamento não atualizados

Se os perfis de armazenamento não estiverem apresentando a configuração correta:

• Verifique se o Operador de Virtualização do OpenShift está instalado
• Aguarde até que os perfis de armazenamento sejam criados automaticamente
• Aplique manualmente correções nos perfis de armazenamento usando os comandos fornecidos
• Verifique se o nome do provisionador está correto vpc.file.csi.ibm.io