Gerenciamento de clusters do Serviço de Virtualização

Virtual Private Cloud 4.21 and later Bare metal worker nodes only RHCOS only

Aprenda a gerenciar seu cluster do Serviço de Virtualização do OpenShift, incluindo o trabalho com componentes pré-configurados, o gerenciamento de nós de trabalho e a execução de tarefas de manutenção.

Entendendo os componentes gerenciados

Os clusters do Serviço de Virtualização incluem vários componentes pré-configurados que são gerenciados de maneira diferente dos clusters padrão do OpenShift.

Componentes essenciais (não podem ser desativados)

Os seguintes componentes são essenciais para o Serviço de Virtualização e não podem ser desativados:

OpenShift Complemento de virtualização: O complemento “ openshift-virtualization ” é ativado automaticamente em todos os clusters do Serviço de Virtualização e não pode ser desativado. Este complemento gerencia a instalação e as atualizações dos operadores de virtualização do OpenShift, do NMState e de manutenção do Node. Para obter mais informações, consulte o documento “Gerenciamento do complemento de virtualização do OpenShift ”.
OpenShift Virtualization Operator: Oferece recursos de gerenciamento de máquinas virtuais. Este operador é instalado automaticamente pelo complemento e atualizado como parte do ciclo de vida do cluster. A instalação a partir de Red Hat OperatorHub está bloqueada.
Operador da NMState: Gerencia a configuração de rede para máquinas virtuais e nós. Este operador é instalado automaticamente pelo complemento.
Node Operador de manutenção: Lida com as operações de manutenção de nós para cargas de trabalho de máquinas virtuais. Este operador é instalado automaticamente pelo complemento.
OpenShift Fundação de Dados (ODF): Oferece armazenamento para discos do tipo “ VM ” e permite a migração dinâmica. O ODF vem pré-configurado para usar armazenamento NVMe local em nós bare metal.

Visualizando complementos gerenciados

Liste todos os complementos do seu cluster:

ibmcloud ks cluster addon ls --cluster CLUSTER_NAME

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)

O complemento “ openshift-virtualization ” é ativado automaticamente e não pode ser desativado em clusters do Virtualization Service.

Para obter informações detalhadas sobre como gerenciar o complemento de virtualização do OpenShift, incluindo a visualização de detalhes, a verificação de versões e a atualização, consulte o artigo “Gerenciando o complemento de virtualização do OpenShift ”.

Gerenciamento de nós de trabalho

Visualizando nós de trabalho

Liste todos os nós de trabalho do seu cluster:

ibmcloud ks workers --cluster CLUSTER_NAME

Ou use a CLI do OpenShift:

oc get nodes

Incluindo nós do trabalhador

Adicionar nós de trabalho a um conjunto de nós de trabalho existente:

ibmcloud ks worker-pool resize --cluster CLUSTER_NAME \
  --worker-pool default \
  --size-per-zone NUMBER_OF_WORKERS

Todos os nós de trabalho em um cluster do Serviço de Virtualização devem utilizar configurações de hardware físico compatíveis.

Substituição de nós de trabalho

Substituir um nó de trabalho:

ibmcloud ks worker replace --cluster CLUSTER_NAME --worker WORKER_ID

O trabalhador substituto recebe a mesma configuração do original.

Reiniciando os nós de trabalho

Antes de reinicializar um nó de trabalho, coloque-o em modo de manutenção usando o Operador de Manutenção do Node ou migre as VMs em execução para outros nós. Para obter mais informações, consulte “Colocando um nó em manutenção ” e “Migração ativa de VMs ”.

Reinicie um nó de trabalho para aplicar atualizações ou corrigir problemas:

ibmcloud ks worker reload --cluster CLUSTER_NAME --worker WORKER_ID

Gerenciamento de grupos de trabalhadores

Visualizando grupos de trabalhadores

ibmcloud ks worker-pool ls --cluster CLUSTER_NAME

Criação de grupos de trabalhadores adicionais

Crie um novo conjunto de workers com um tipo de servidor físico diferente:

ibmcloud ks worker-pool create vpc-gen2 \
  --name POOL_NAME \
  --cluster CLUSTER_NAME \
  --flavor BARE_METAL_FLAVOR \
  --size-per-zone NUMBER_OF_WORKERS

Todos os conjuntos de máquinas de trabalho em um cluster do Serviço de Virtualização devem utilizar versões bare metal compatíveis com a oferta do Serviço de Virtualização de Aplicações ( openshift-vs ).

Adicionando zonas aos conjuntos de trabalhadores

Adicionar uma zona a um grupo de trabalhadores já existente:

ibmcloud ks zone add vpc-gen2 \
  --cluster CLUSTER_NAME \
  --zone ZONE \
  --subnet-id SUBNET_ID \
  --worker-pool POOL_NAME

Atualização do cluster

Verificando as atualizações do

Verifique se há atualizações disponíveis para o seu cluster:

ibmcloud ks cluster get --cluster CLUSTER_NAME | grep "Master Version"

Ver versões disponíveis:

ibmcloud ks versions --show-version openshift

Atualização do mestre do cluster

Atualize o mestre do cluster para uma nova versão:

ibmcloud ks cluster master update --cluster CLUSTER_NAME --version VERSION

A atualização principal geralmente leva de 30 a 60 minutos. Durante esse período, você não poderá acessar a API do Kubernetes nem o console do OpenShift.

Atualizando nós do trabalhador

Após atualizar o nó mestre, atualize os nós de trabalho:

ibmcloud ks worker update --cluster CLUSTER_NAME --worker WORKER_ID

Ou atualizar todos os trabalhadores de um grupo de trabalhadores:

ibmcloud ks worker-pool update --cluster CLUSTER_NAME --worker-pool POOL_NAME

Antes de atualizar os nós de trabalho, coloque cada nó em modo de manutenção usando o Operador de Manutenção do Node ou migre as VMs em execução para outros nós. Para obter mais informações, consulte “Colocando um nó em manutenção ” e “Migração ativa de VMs ”.

Monitorando o funcionamento do cluster

Verificando o status do cluster

ibmcloud ks cluster get --cluster CLUSTER_NAME

Procure por:

Condição: Deve ser normal
Status principal: Deveria ser Ready
Master Health: Deveria ser normal

Monitoramento do estado dos componentes

Verifique o estado da virtualização do OpenShift:

oc get hyperconverged -n openshift-cnv

Verificar o estado do ODF:

oc get storagecluster -n openshift-storage

Visualizando os registros do cluster

Visualizar a atividade do cluster:

ibmcloud ks cluster get --cluster CLUSTER_NAME --show-resources

Para obter registros detalhados, configure IBM Log Analysis. Consulte o registro de logs para clusters.

Gerenciando máquinas virtuais

Visualizando máquinas virtuais

Listar todas as VMs do cluster:

oc get vms -A

Exibir VMs em um namespace específico:

oc get vms -n NAMESPACE

Colocando um nó em manutenção

Antes de realizar ações de manutenção, como atualizar, recarregar ou substituir um nó de trabalho bare metal, coloque o nó no modo de manutenção. O Operador de Manutenção do Node isola o nó e, automaticamente, retira ou migra em tempo real todas as cargas de trabalho de máquinas virtuais elegíveis para outros nós na mesma zona, sem interromper as cargas de trabalho.

Se o seu cluster utilizar o Data Foundation d OpenShift (ODF), os nós que executam componentes de armazenamento do ODF devem seguir os procedimentos de atualização e manutenção do ODF, em vez deste processo. Para mais informações, consulte Entender o OpenShift Data Foundation.

Iniciando a manutenção do nó pelo console da web

É possível iniciar a manutenção do nó diretamente do console da web do Red Hat OpenShift.

Na perspectiva do administrador do console da web do OpenShift, acesse Compute > Nodes.
Encontre o nó de trabalho “bare metal” no qual você deseja realizar a manutenção.
Clique no menu de ações (três pontos verticais) desse nó e selecione “Iniciar manutenção ”.
Na caixa de diálogo de confirmação, verifique as configurações de manutenção e clique em Iniciar.
Verifique se o status do nó aparece como “ Scheduling disabled ” e se o menu de ações exibe “Interromper manutenção ” em vez de “Iniciar manutenção ”. Aguarde até que todas as instâncias do VM sejam migradas para outros nós disponíveis antes de prosseguir com sua ação no nível do nó (como ibmcloud ks worker reload ou ibmcloud ks worker update``).
Após a conclusão da ação de manutenção e quando o nó estiver em bom estado, volte para Compute > Nós, clique no menu de ações do nó e selecione “Encerrar manutenção ”.

Iniciando a manutenção do nó pela CLI

Você também pode iniciar a manutenção do nó criando um recurso personalizado do tipo “ NodeMaintenance ”.

Crie um arquivo YAML chamado node-maintenance.yaml com a definição do recurso personalizado NodeMaintenance . Especifique o nome do nó de trabalho “bare metal” de destino no campo “ nodeName ”.
```
apiVersion: nodemaintenance.medik8s.io/v1beta1
kind: NodeMaintenance
metadata:
  name: nodemaintenance-NODE_NAME
spec:
  nodeName: NODE_NAME
  reason: Node maintenance for update or reload
```
Aplique o recurso personalizado para colocar o nó no modo de manutenção:
```
oc apply -f node-maintenance.yaml
```
Monitore o status do recurso NodeMaintenance para verificar se a operação de esvaziamento foi bem-sucedida:
```
oc get nodemaintenance nodemaintenance-NODE_NAME -o jsonpath='{.status.phase}'
```
Verifique se o relatório de fase indica “ Succeeded ” antes de prosseguir com a recarga, atualização ou substituição do nó.
Execute a ação planejada no nível do nó, como recarregar ou atualizar o nó de trabalho:
```
ibmcloud ks worker reload --cluster CLUSTER_NAME --worker WORKER_ID
```
Após a conclusão da recarga ou atualização do nó e quando o status do nó em oc get nodes estiver como “ Ready ”, remova o nó da manutenção excluindo o recurso NodeMaintenance:
```
oc delete nodemaintenance nodemaintenance-NODE_NAME
```

Migração manual de VMs em tempo real

Se você quiser acionar manualmente uma migração ativa para uma máquina virtual específica, em vez de usar o Operador de Manutenção do Node:

Liste as instâncias de máquinas virtuais no namespace para identificar o nome do VM que você deseja migrar:
```
oc get vmi -n NAMESPACE
```
Iniciar uma migração em tempo real para o VM:
```
virtctl migrate VM_NAME -n NAMESPACE
```

Se um servidor de aplicativos ( VM ) tiver uma interface de rede virtual (VNI) conectada, a migração dinâmica só é suportada dentro da mesma zona. A migração de um “ VM ” entre zonas é bem-sucedida, mas o “ VM ” acaba ficando com a rede inoperante, pois os VNIs não podem ser conectados entre zonas.

Parar e iniciar máquinas virtuais

Como interromper um VM:

virtctl stop VM_NAME -n NAMESPACE

Crie um VM:

virtctl start VM_NAME -n NAMESPACE

Gerenciamento de armazenamento

Monitoramento da capacidade de armazenamento

Verifique a capacidade de armazenamento do ODF:

oc get cephcluster -n openshift-storage -o jsonpath='{.items[0].status.ceph.capacity}'

Verificar o uso do armazenamento:

oc get cephblockpool -n openshift-storage

Gerenciamento de reivindicações de volume persistente

Lista de PVCs utilizados pelas VMs:

oc get pvc -A | grep virtualmachine

Ver detalhes do PVC:

oc describe pvc PVC_NAME -n NAMESPACE

Resolução de problemas

Para solucionar problemas comuns em clusters do Serviço de Virtualização, consulte os tópicos a seguir:

Resolução de problemas em clusters — Problemas nos nós de trabalho, acesso ao cluster e problemas gerais do cluster
Resolução de problemas na virtualização do OpenShift: problemas com máquinas virtuais, dificuldades do operador e erros específicos da virtualização
Solução de problemas de armazenamento- Problemas com o Data Foundation do OpenShift e e volumes persistentes

Gerenciamento de clusters do Serviço de Virtualização

Gerenciamento de clusters do Serviço de Virtualização

Entendendo os componentes gerenciados

Componentes essenciais (não podem ser desativados)

Visualizando complementos gerenciados

Gerenciamento de nós de trabalho

Visualizando nós de trabalho

Incluindo nós do trabalhador

Substituição de nós de trabalho

Reiniciando os nós de trabalho

Gerenciamento de grupos de trabalhadores

Visualizando grupos de trabalhadores

Criação de grupos de trabalhadores adicionais

Adicionando zonas aos conjuntos de trabalhadores

Atualização do cluster

Verificando as atualizações do

Atualização do mestre do cluster

Atualizando nós do trabalhador

Monitorando o funcionamento do cluster

Verificando o status do cluster

Monitoramento do estado dos componentes

Visualizando os registros do cluster

Gerenciando máquinas virtuais

Visualizando máquinas virtuais

Colocando um nó em manutenção

Iniciando a manutenção do nó pelo console da web

Iniciando a manutenção do nó pela CLI

Migração manual de VMs em tempo real

Parar e iniciar máquinas virtuais

Gerenciamento de armazenamento

Monitoramento da capacidade de armazenamento

Gerenciamento de reivindicações de volume persistente

Resolução de problemas

Próximas etapas