Antes de Iniciar

Antes de criar uma máquina virtual com o VPC File Storage, conclua as seguintes tarefas:

1. Crie um cluster VPC com nós de trabalho bare metal que use Red Hat CoreOS (RHCOS). Para obter mais informações, consulte Criação de clusters de VPC.
2. Analise as orientações de planejamento em Planejamento da implementação da virtualização do OpenShift.
3. Configure o VPC File Storage conforme descrito em Configuração do armazenamento para a virtualização OpenShift.
4. Instale o OpenShift Virtualization Operator conforme descrito em Instalando o OpenShift Virtualization Operator.
5. Instale a CLI do virtctl. Para obter mais informações, consulte Introdução às ferramentas CLI da OpenShift Virtualization.

Verificação de seu ambiente

Verifique se o cluster está pronto antes de criar uma máquina virtual.

1. Confirme se os componentes da virtualização OpenShift estão implantados.

   oc get hyperconverged -n openshift-cnv
   oc get pods -n openshift-cnv
   

   Procure o valor PHASE Deployed na saída HyperConverged. Na saída do pod, verifique se os pods de virtualização mostram o status Running ou Completed e se não estão presos em Pending, CrashLoopBackOff ou Error.

2. Confirme se o complemento do driver VPC File CSI está instalado.

   ibmcloud ks cluster addon ls -c CLUSTER_NAME | grep vpc-file-csi-driver
   

   Procure o complemento vpc-file-csi-driver na saída e verifique se seu estado de integridade é normal ou se o status indica que o complemento está pronto.

3. Verifique se uma classe VPC File Storage está disponível.

   oc get storageclass | grep vpc-file
   

   Procure classes de armazenamento como ibmc-vpc-file-1000-iops ou ibmc-vpc-file-6000-iops. Anote o nome da classe de armazenamento que você deseja usar nas etapas posteriores.

4. Verifique se o perfil de armazenamento da classe VPC File Storage selecionada está configurado com o modo de acesso ReadWriteMany e o modo de volume Filesystem.

   oc get storageprofile <storage-class-name> -o yaml
   

   Na saída, procure claimPropertySets em spec. Verifique se accessModes inclui ReadWriteMany e se volumeMode está definido como Filesystem.

   claimPropertySets:
   - accessModes:
     - ReadWriteMany
     volumeMode: Filesystem
   

5. Verifique se a classe de armazenamento selecionada pode provisionar uma reivindicação de volume persistente.

   cat <<EOF | oc apply -f -
   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: vpc-file-test-pvc
   spec:
     accessModes:
     - ReadWriteMany
     resources:
       requests:
         storage: 10Gi
     storageClassName: <storage-class-name>
   EOF
   

6. Confirme se a reivindicação de volume persistente de teste está vinculada.

   oc get pvc vpc-file-test-pvc
   

   Na saída, procure a coluna STATUS e verifique se a reivindicação de volume persistente mostra Bound. Se a reivindicação permanecer em Pending, a classe de armazenamento ou o perfil de armazenamento não está configurado corretamente.

7. Revise os detalhes da reivindicação de volume persistente se a reivindicação não for vinculada.

   oc describe pvc vpc-file-test-pvc
   

8. Exclua a reivindicação de volume persistente de teste.

   oc delete pvc vpc-file-test-pvc
   

Criação de uma máquina virtual a partir do console da Web

Use o console da Web OpenShift para criar uma máquina virtual que armazene seu disco no VPC File Storage.

1. Faça login no console da Web OpenShift do seu cluster.
2. No menu de navegação, clique em Virtualização > VirtualMachines.
3. Clique em Create e selecione um modelo ou selecione From YAML se quiser definir a máquina virtual manualmente.
4. Digite um nome para a máquina virtual.
5. Selecione o projeto no qual você deseja criar a máquina virtual.
6. Na seção de armazenamento, selecione uma classe VPC File Storage, como ibmc-vpc-file-1000-iops ou ibmc-vpc-file-6000-iops.
7. Defina o tamanho do disco com base em seus requisitos de carga de trabalho.
8. Revise as configurações da CPU e da memória e atualize-as conforme necessário.
9. Clique em Create VirtualMachine.
10. Na página de detalhes da máquina virtual, examine as guias Disks (Discos ), Network interfaces (Interfaces de rede ) e Configuration (Configuração ) para confirmar que a máquina virtual foi criada com as configurações esperadas.

Depois que a máquina virtual é criada, o console cria a reivindicação de volume persistente associada e os recursos de volume de dados.

Criação de uma máquina virtual pela CLI

Use a CLI se quiser criar uma máquina virtual a partir de um manifesto reutilizável.

1. Crie um namespace para as cargas de trabalho de sua máquina virtual, caso ainda não tenha um.

   oc create namespace vm-project
   

2. Crie um manifesto de máquina virtual que faça referência a uma classe VPC File Storage.

   cat <<EOF | oc apply -f -
   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     name: rhel9-vm
     namespace: vm-project
   spec:
     running: false
     template:
       metadata:
         labels:
           kubevirt.io/domain: rhel9-vm
       spec:
         domain:
           cpu:
             cores: 2
           devices:
             disks:
             - disk:
                 bus: virtio
               name: rootdisk
             - disk:
                 bus: virtio
               name: cloudinitdisk
           resources:
             requests:
               memory: 4Gi
         volumes:
         - dataVolume:
             name: rhel9-vm-rootdisk
           name: rootdisk
         - cloudInitNoCloud:
             userData: |
               #cloud-config
               user: cloud-user
               password: changeme
               chpasswd: { expire: false }
           name: cloudinitdisk
     dataVolumeTemplates:
     - metadata:
         name: rhel9-vm-rootdisk
       spec:
         pvc:
           accessModes:
           - ReadWriteMany
           resources:
             requests:
               storage: 40Gi
           storageClassName: <storage-class-name>
           volumeMode: Filesystem
         source:
           blank: {}
   EOF
   

3. Verifique se os recursos da máquina virtual e do volume de dados foram criados.

   oc get vm -n vm-project
   oc get dv -n vm-project
   oc get pvc -n vm-project
   

   Na saída, verifique se a máquina virtual rhel9-vm está listada, se o volume de dados rhel9-vm-rootdisk existe e se a reivindicação de volume persistente rhel9-vm-rootdisk foi criada. Se a reivindicação de volume persistente ainda não for Bound, aguarde a conclusão do provisionamento antes de continuar.

4. Revise os detalhes do volume de dados se o volume de dados não estiver pronto.

   oc describe dv rhel9-vm-rootdisk -n vm-project
   oc describe pvc rhel9-vm-rootdisk -n vm-project
   

5. Inicie a máquina virtual.

   virtctl start rhel9-vm -n vm-project
   

6. Verifique se a instância da máquina virtual está em execução.

   oc get vmi -n vm-project
   

   Na saída, procure o nome da instância da máquina virtual e verifique se sua fase é Running. Se nenhuma instância de máquina virtual estiver listada, revise o status da máquina virtual.

   oc get vm rhel9-vm -n vm-project -o yaml
   

Validação da máquina virtual

Depois de criar a máquina virtual, valide se os recursos de armazenamento e computação estão funcionando conforme o esperado.

1. Confirme se a reivindicação de volume persistente está vinculada.

   oc get pvc -n vm-project
   

   Na saída, procure a reivindicação de volume persistente rhel9-vm-rootdisk e verifique se a coluna STATUS mostra Bound.

2. Confirme se a importação ou o provisionamento do volume de dados foi concluído com êxito.

   oc get dv -n vm-project
   

   Na saída, verifique se o volume de dados mostra uma fase bem-sucedida, como Succeeded ou Ready, dependendo do seu ambiente. Se o volume de dados não estiver pronto, revise os eventos de reivindicação do volume de dados e do volume persistente.

   oc describe dv rhel9-vm-rootdisk -n vm-project
   oc describe pvc rhel9-vm-rootdisk -n vm-project
   

3. Confirme se a instância da máquina virtual está em execução.

   oc get vmi -n vm-project
   

4. Revise os detalhes da instância da máquina virtual para confirmar o posicionamento do nó, as interfaces e os volumes anexados.

   oc describe vmi rhel9-vm -n vm-project
   

5. Se tiver configurado as credenciais de inicialização na nuvem, conecte-se ao console da máquina virtual.

   virtctl console rhel9-vm -n vm-project
   

6. Revise os detalhes da máquina virtual se a instância não for iniciada.

   oc describe vm rhel9-vm -n vm-project
   oc describe vmi rhel9-vm -n vm-project
   

Compreensão das limitações e considerações

Analise as considerações a seguir quando você usar o VPC File Storage para máquinas virtuais:

Desempenho do VPC File Storage

O VPC File Storage é uma opção de armazenamento conectado à rede. Em geral, ele é mais adequado para desenvolvimento, teste e cargas de trabalho de E/S mais baixas.

Snapshots e clonagem

O suporte a snapshot e clonagem é diferente do OpenShift Data Foundation. Analise seus requisitos de armazenamento antes de padronizar o VPC File Storage para cargas de trabalho de produção.

Migração em tempo real

A migração em tempo real é suportada quando o perfil de armazenamento é configurado corretamente e a carga de trabalho atende aos requisitos de virtualização do site OpenShift.

Configuração do perfil de armazenamento

Você deve configurar o perfil de armazenamento para o provisionador VPC File CSI para que o CDI possa usar a classe de armazenamento corretamente.

Resolução de problemas

Se a máquina virtual não iniciar ou se o disco não for provisionado corretamente, examine os tópicos a seguir:

• Configuração do armazenamento para a virtualização OpenShift
• Por que meus discos VM falham no provisionamento?
• Por que meus PVCs estão presos em Pendente?
• Por que meu VM não dá partida?

Próximas etapas

Depois que você criar uma máquina virtual com o VPC File Storage:

1. Gerenciar máquinas virtuais em clusters do Virtualization Service
2. Configurar interfaces de rede virtual
3. Consulte a documentação de virtualização do site Red Hat OpenShift