Gerenciamento do complemento de virtualização do OpenShift
Nuvem Privada Virtual 4.21 e mais tarde Apenas nós de trabalho em bare metal Apenas RHCOS
O complemento “ openshift-virtualization ” oferece uma experiência de configuração com um único clique para instalar a plataforma de virtualização em clusters do Serviço de Virtualização d OpenShift. Este complemento é ativado automaticamente
por padrão em todos os clusters do Serviço de Virtualização.
Entendendo o complemento de virtualização do OpenShift
O complemento de virtualização do OpenShift coordena a implantação e o gerenciamento dos seguintes operadores para habilitar os recursos de máquinas virtuais no seu cluster do Virtualization Service:
- OpenShift Operador de virtualização (hiperconvergência)
- Oferece os principais recursos de virtualização para a execução e o gerenciamento de máquinas virtuais. Para obter mais informações, consulte a seção “Instalação da virtualização d OpenShift ”.
- Operador da NMState
- Gerencia a configuração de rede para máquinas virtuais e nós. Para obter mais informações, consulte a seção “Sobre o operador NMState do Kubernetes ”.
- Node Operador de manutenção
- Lida com as operações de manutenção de nós para cargas de trabalho de máquinas virtuais. Para obter mais informações, consulte Operador de manutenção do Node.
A instalação desses operadores, disponíveis em Red Hat e OperatorHub, está bloqueada em clusters do Virtualization Service. O complemento gerencia todas as instalações e atualizações do operador.
Características adicionais
O complemento de virtualização do OpenShift apresenta as seguintes características:
- Ativação automática
- O complemento é ativado automaticamente quando você cria um cluster do Serviço de Virtualização. Não é possível ativar manualmente o complemento pela CLI ou pelo console.
- Não pode ser desativado
- A desativação do complemento não é suportada. Essa opção não está disponível no console, e tentar desativá-la por meio da CLI gera um erro.
- Sem opções de configuração
- O complemento não possui parâmetros configuráveis pelo usuário.
- Vinculação de versão
- A versão do complemento está vinculada à versão do cluster do Serviço de Virtualização (por exemplo, 4.21 ). O complemento é compatível com a versão secundária atual e com a próxima versão secundária ( n+1 ). Por exemplo, a versão do complemento 4.21 pode ser usada com as versões do Serviço de Virtualização 4.21 e 4.22.
- Atualizações automáticas de patches
- As atualizações de patch são aplicadas automaticamente ao seu cluster por meio da estratégia de aprovação automática. IBM avisa você com pelo menos uma semana de antecedência da implementação na produção, informando os detalhes
das alterações. Todos os operadores dependentes são atualizados automaticamente caso existam novas versões no catálogo de operadores espelhado. O complemento utiliza o canal
stablepara todas as atualizações do operador. - Atualizações manuais de versão
- Para atualizar o complemento para uma versão mais recente (por exemplo, de 4.20 para 4.21 ), você deve primeiro atualizar seu cluster do Virtualization Service para a versão de destino e, em seguida, atualizar manualmente a versão do complemento
usando o comando da CLI
ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSION. - Atualizar canal
- O complemento utiliza o canal "
stable" para atualizações, que fornece atualizações Z-stream para correções de bugs e questões de segurança. - Compatibilidade entre versões
- Cada versão do complemento é compatível com a versão atual do Serviço de Virtualização (n) e com a próxima versão secundária ( n+1 ). Por exemplo, a versão do complemento 4.20 é compatível com as versões do Serviço de Virtualização 4.20 e 4.21.
- Catálogo customizado
- Um catálogo personalizado com operadores dependentes espelhados é configurado automaticamente durante a ativação do complemento e é colocado no namespace
openshift-marketplace.
Recursos instalados
Quando o complemento é ativado, os seguintes recursos são criados:
- Espaço de nomes do operador pai
- O namespace
- Catálogo customizado
- O catálogo personalizado está localizado no namespace
openshift-marketplace. - Operadores dependentes
- O operador pai atua como um metaoperador e instala os seguintes operadores dependentes durante a reconciliação:
- OpenShift Virtualização (no namespace
openshift-cnv) - NMState (no namespace
openshift-nmstate) - Node Operador de manutenção (no namespace
openshift-operators)
- OpenShift Virtualização (no namespace
Visualizando informações sobre o complemento
Se o sinalizador de recurso estiver ativado para sua conta, você poderá visualizar informações sobre o complemento de virtualização do OpenShift por meio da CLI. Se o sinalizador de recurso não estiver ativado, use o console e os detalhes do cluster para verificar o status do complemento.
Lista de complementos instalados
Liste todos os complementos instalados no seu cluster do Serviço de Virtualização.
ibmcloud ks cluster addon ls --cluster CLUSTER_NAME_OR_ID
Saída de exemplo:
Name Version Health State Health Status
ibm-storage-operator 1.0 normal Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
openshift-virtualization 4.21 normal Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
Obter detalhes do complemento
Se o sinalizador de recurso estiver ativado para sua conta, obtenha informações detalhadas sobre o complemento de virtualização do OpenShift.
ibmcloud ks cluster addon get --addon openshift-virtualization --cluster CLUSTER_NAME_OR_ID
Saída de exemplo:
name: openshift-virtualization
Version: 4.21
Health State: normal
Health Status: Addon Ready. For more info: http://ibm.biz/addon-state (H1500)
Lista das versões de complementos disponíveis
Se o sinalizador de recurso estiver ativado para sua conta, exiba as versões disponíveis do complemento de virtualização do OpenShift.
ibmcloud ks cluster addon versions --addon openshift-virtualization
Saída de exemplo:
Name Version Supported Kubernetes Range Supported OpenShift Range Kubernetes Default OpenShift Default
openshift-virtualization 4.19 unsupported >=4.19.0 <4.21.0 - >=4.19.0 <4.21.0
openshift-virtualization 4.21 unsupported >=4.21.0 <4.23.0 - >=4.21.0 <4.23.0
Esta saída mostra quais versões do Serviço de Virtualização são compatíveis com cada versão do complemento.
Verificando as opções de configuração
Se o sinalizador de recurso estiver ativado para a sua conta, você poderá verificar que o complemento de virtualização do OpenShift não oferece opções de configuração.
ibmcloud ks cluster addon options --addon openshift-virtualization
Saída de exemplo:
FAILED
No addon installation options are available for openshift-virtualization.
Atualizando o complemento
O complemento de virtualização do OpenShift oferece suporte a dois tipos de atualizações:
Atualizações automáticas de patches
As atualizações de patch (como, por exemplo, de 4.21.1 para 4.21.2 ) são aplicadas automaticamente a todos os clusters. Essas atualizações incluem correções de erros e patches de segurança. IBM avisa com pelo menos uma semana de antecedência antes de implementar atualizações de patch no ambiente de produção.
O processo automático de atualização de patches realiza o seguinte:
- Reinicia o operador pai
- Reconcilia a fonte do catálogo
- Atualiza todos os operadores filhos com base na assinatura do canal
stable
Atualizações manuais de versão
Para atualizar o complemento de virtualização do OpenShift para uma versão secundária mais recente (por exemplo, de 4.20 para 4.21 ), é necessário primeiro atualizar seu cluster do Serviço de Virtualização para a versão de destino. Se o sinalizador de recurso não estiver ativado para a sua conta, entre em contato com o suporte do IBM antes de tentar a atualização via CLI.
-
Atualize seu cluster do Serviço de Virtualização para a versão desejada. Para obter mais informações, consulte Atualização de clusters.
-
Após a conclusão da atualização do cluster, atualize o complemento para a versão correspondente.
ibmcloud ks cluster addon update openshift-virtualization --cluster CLUSTER_NAME_OR_ID --version VERSIONPor exemplo, para atualizar para a versão 4.21:
ibmcloud ks cluster addon update openshift-virtualization --cluster my-rovs-cluster --version 4.21
É altamente recomendável atualizar a versão do complemento para que ela corresponda à versão do seu cluster, a fim de garantir compatibilidade e suporte ideais.
Desativando o complemento
A desativação do complemento de virtualização “ OpenShift ” não é compatível com clusters do Serviço de Virtualização (Fase 1). O complemento é um componente essencial do Serviço de Virtualização e não pode ser removido. Se o sinalizador de recurso estiver ativado para a sua conta e você tentar executar o comando da CLI, o comando resultará em um erro.
ibmcloud ks cluster addon disable openshift-virtualization --cluster CLUSTER_NAME_OR_ID
O suporte à desinstalação de complementos está previsto para os clusters ROKS padrão na Fase 2.
Resolução de problemas do complemento
Se você tiver problemas com o complemento de virtualização do OpenShift, reúna as seguintes informações antes de abrir um ticket de suporte.
Recolha de informações sobre complementos
Execute os seguintes comandos para obter informações sobre o complemento de virtualização do OpenShift e seus operadores dependentes.
-
Obtenha o recurso personalizado de virtualização do IBM OpenShift.
oc get ibmopenshiftvirtualizations.openshiftvirt.ibm.io -n ibm-openshift-virt-operator -o yaml -
Listar todos os recursos no namespace do operador pai.
oc get all -n ibm-openshift-virt-operator -
Verifique o status do operador de virtualização do OpenShift.
oc get csv -n openshift-cnv -
Veja os detalhes do recurso " HyperConverged ".
oc get hco -n openshift-cnv kubevirt-hyperconverged -o yaml -
Listar todos os recursos no espaço de nomes de virtualização do OpenShift.
oc get all -n openshift-cnv -
Verifique o status do operador NMState.
oc get csv -n openshift-nmstate -
Listar todos os recursos no namespace NMState.
oc get all -n openshift-nmstate -
Veja os detalhes do recurso da NMState.
oc get nmstate nmstate -o yaml -
Listar os recursos d NodeNetworkConfigurationPolicy.
oc get nncp -
Verifique o status do Operador de Manutenção do Node.
oc get csv -n openshift-operators -
Listar todos os recursos no namespace "operadores".
oc get all -n openshift-operators -
Verifique a fonte do catálogo personalizado.
oc get catalogsource custom-redhat-operators-openshiftvirt -n openshift-marketplace -
Listar os manifestos de pacotes do catálogo personalizado.
oc get packagemanifests -n openshift-marketplace | grep "Custom Redhat Operators for Openshift Virtualization"
Abrindo um caso de suporte
Se o seu problema não for resolvido, abra um ticket de suporte e inclua o resultado dos comandos de diagnóstico. Para obter mais informações, veja Obtendo suporte.