Instalação do operador de virtualização OpenShift

Nuvem Privada Virtual 4.17 e mais tarde Apenas nós de trabalho em bare metal Apenas RHCOS

Depois de configurar o armazenamento para o cluster, instale o OpenShift Virtualization Operator para ativar os recursos de gerenciamento de máquinas virtuais.

OpenShift O Serviço de Virtualização inclui operadores pré-instalados, portanto, não é necessária nenhuma instalação manual. OpenShift Serviço de virtualização Os clusters têm os operadores de virtualização do OpenShift, NMState e de manutenção do Node pré-instalados e gerenciados pelo complemento openshift-virtualization. Esta página se aplica apenas a clusters padrão do OpenShift com instalação manual do OpenShift Virtualization.

Antes de Iniciar

Antes de instalar o OpenShift Virtualization Operator, conclua as etapas a seguir:

  1. Crie um cluster Red Hat OpenShift on IBM Cloud com os seguintes requisitos:

    • Nós de trabalho bare metal: Necessário para cargas de trabalho de virtualização
    • Sistema operacional RHCOS: Necessário (não RHEL)
    • OVN- Kubernetes CNI: necessário para recursos avançados de rede
    • OpenShift 4.20 ou posterior: Necessário para suporte total à virtualização
    • Proteção do tráfego de saída: Deve ser desativada (pode ser definida durante a criação do cluster ou desativada posteriormente)

    Você pode desativar a proteção do tráfego de saída durante a criação do cluster na interface do usuário ou na CLI, ou desativá-la após a criação do cluster usando o comando na etapa 3.

  2. Configure o armazenamento para a virtualização OpenShift. Seu cluster deve ter exatamente uma solução de armazenamento configurada corretamente (ODF ou VPC File Storage ).

  3. Se você não desativou a proteção do tráfego de saída durante a criação do cluster, desative-a agora.

    ibmcloud oc vpc outbound-traffic-protection disable -c CLUSTER_NAME
    

    Essa etapa só é necessária se a proteção do tráfego de saída não tiver sido desativada durante a criação do cluster.

  4. Habilite as origens de catálogo padrão.

    ibmcloud ks cluster config --admin -c CLUSTER_NAME
    oc patch operatorhub cluster --type json -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": false}]'
    
  5. Verifique se as fontes do catálogo estão disponíveis.

    oc get catalogsource -n openshift-marketplace
    
  6. Confirme se o pacote de virtualização OpenShift está disponível.

    oc get packagemanifests -n openshift-marketplace | grep kubevirt
    

Instalação do OpenShift Virtualization Operator a partir do console

  1. Faça login no console IBM Cloud e navegue até o seu cluster.

  2. Clique em OpenShift web console para abrir o console OpenShift.

  3. No console OpenShift, navegue até Ecosystem > OperatorHub (ou Operators > OperatorHub em versões anteriores).

  4. Pesquise por OpenShift Virtualization.

  5. Clique no bloco OpenShift Virtualization e, em seguida, clique em Install.

  6. Na página “Operador de instalação”, configure as seguintes opções:

    • Canal de atualização: Selecione o canal apropriado para sua versão do OpenShift
    • Modo de instalação: Todos os namespaces do cluster (padrão)
    • Namespace instalado: openshift-cnv (padrão)
    • Aprovação de atualização: Automática (recomendada)
  7. Clique em ** Instalar ** para iniciar a instalação.

  8. Aguarde até que a instalação do operador seja concluída. O status muda para Succeeded quando estiver pronto.

Instalação do operador de virtualização OpenShift a partir da CLI

  1. Crie um namespace para o Operador de Virtualização do OpenShift.
    oc create namespace openshift-cnv
    
  2. Crie um OperatorGroup.
    cat <<EOF | oc apply -f -
    apiVersion: operators.coreos.com/v1
    kind: OperatorGroup
    metadata:
      name: kubevirt-hyperconverged-group
      namespace: openshift-cnv
    spec:
      targetNamespaces:
      - openshift-cnv
    EOF
    
  3. Crie uma assinatura para instalar o operador.
    cat <<EOF | oc apply -f -
    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: hco-operatorhub
      namespace: openshift-cnv
    spec:
      source: redhat-operators
      sourceNamespace: openshift-marketplace
      name: kubevirt-hyperconverged
      startingCSV: kubevirt-hyperconverged-operator.v4.20.8
      channel: "stable"
    EOF
    
  4. Verifique a instalação do operador.
    oc get csv -n openshift-cnv
    
    Aguarde até que a coluna PHASE mostre Succeeded.

Criação do recurso personalizado “ HyperConverged ”

Depois que o operador estiver instalado, crie um recurso personalizado HyperConverged para implementar os componentes da virtualização OpenShift.

Entendendo o posicionamento dos nós

Red Hat OpenShift on IBM Cloud não têm nós rotulados como master. Você deve configurar políticas de posicionamento de nós para especificar onde os componentes de virtualização e as cargas de trabalho do VM são executados.

Criação do HyperConverged CR a partir do console

  1. No console OpenShift, navegue até Ecosystem > Installed Operators (ou Operators > Installed Operators em versões anteriores).

  2. Clique em OpenShift Virtualization.

  3. Clique na HyperConverged aba.

  4. Clique em Create HyperConverged.

  5. Configurar o posicionamento dos nós para os componentes da infraestrutura:

    • Clique na guia Infra
    • Adicionar seletores de nó ou tolerâncias para direcionar os nós VSI
  6. Configure o posicionamento dos nós para cargas de trabalho do VM:

    • Clique na guia Cargas de trabalho
    • Adicionar seletores de nós ou tolerâncias para direcionar nós bare metal
  7. Clique em Criar.

Criação do HyperConverged CR a partir da CLI

Crie um recurso personalizado HyperConverged com a configuração padrão.

cat <<EOF | oc apply -f -
apiVersion: hco.kubevirt.io/v1beta1
kind: HyperConverged
metadata:
  name: kubevirt-hyperconverged
  namespace: openshift-cnv
spec:
EOF

Verificando a Instalação

  1. Verifique o status do recurso HyperConverged.

    oc get hyperconverged -n openshift-cnv
    

    Aguarde até que a coluna PHASE mostre Deployed.

  2. Verifique se os pods de virtualização estão em execução.

    oc get pods -n openshift-cnv
    
  3. Verifique se há o menu Virtualização no console OpenShift.

    • Faça login no console do OpenShift
    • Procure por Virtualization no menu de navegação principal
  4. Verifique se os perfis de armazenamento foram criados.

    oc get storageprofile
    
  5. Se estiver usando o VPC File Storage, configure os perfis de armazenamento conforme descrito em Configuração do armazenamento para a virtualização OpenShift.

Resolução de problemas de instalação

HyperConverged falha na implantação do recurso

Se o recurso HyperConverged não for implantado com erros de posicionamento de nó:

  1. Verifique os rótulos dos nós.
    oc get nodes --show-labels
    
  2. Atualize o HyperConverged CR com os seletores de nó corretos.
    oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv
    
  3. Analise os registros do operador do HyperConverged.
    oc logs -n openshift-cnv -l name=hyperconverged-cluster-operator
    

Falha na instalação do operador

Se a instalação do operador falhar:

  1. Verifique se as origens do catálogo estão ativadas.
    oc get catalogsource -n openshift-marketplace
    
  2. Verifique o status da assinatura do operador.
    oc get subscription -n openshift-cnv
    
  3. Analise os registros do operador.
    oc logs -n openshift-cnv -l app=kubevirt-hyperconverged-operator
    

Próximas etapas

Depois de instalar o OpenShift Virtualization:

Para obter instruções completas de instalação, consulte Instalando a virtualização do OpenShift na documentação do Red Hat.