Noções básicas sobre as verificações de simulação

No GKE em Bare Metal, você pode executar verificações de simulação para diferentes situações:

  • O GKE em Bare Metal executa verificações de simulação quando você cria ou atualiza clusters de administrador, híbridos, independentes ou de usuários e recursos do pool de nós com bmctl. Se as verificações falharem, nenhuma alteração será feita. Também é possível ignorar essas verificações.
  • O GKE em Bare Metal também executa verificações de simulação internas quando você aplica recursos do Kubernetes a clusters de usuário a partir de um cluster de administrador ou híbrido. As verificações são executadas antes que as alterações sejam aplicadas aos clusters de usuário afetados. Se as verificações falharem, nenhuma alteração será feita. Também é possível ignorar essas verificações ou executá-las de maneira explícita.

Verificações de simulação para criação de clusters com bmctl

Ao criar clusters de admin, híbridos, independentes ou de usuário com o comando bmctl, o GKE em Bare Metal executa automaticamente verificações de simulação antes que sejam feitas alterações.

Quando as verificações são aprovadas, o GKE em Bare Metal cria os clusters.

Ignorar os resultados das verificações automáticas de simulação

Se você quiser ignorar essas verificações de simulação automatizadas, use a sinalização opcional --force no comando.

Executar verificações de simulação de forma independente

Também é possível executar verificações de simulação antes da criação do cluster. Isso pode ajudar a economizar tempo garantindo que os recursos do seu nó e da sua máquina sejam aprovados nas verificações.

  • O comando a seguir valida o arquivo de configuração do cluster especificado, mas não tenta criar o próprio cluster:

    bmctl check config --cluster CLUSTER_NAME

    Substitua CLUSTER_NAME pelo nome do cluster com o arquivo de configuração que você está verificando.

  • Esse comando verifica se as máquinas e a rede estão prontas para a criação do cluster:

    bmctl check preflight --cluster CLUSTER_NAME

    Substitua CLUSTER_NAME pelo nome do cluster que você está verificando.

Executar as verificações de simulação e integridade mais recentes

É possível fazer verificações de simulação no seu sistema. As verificações de simulação garantem que suas máquinas e sua rede estejam prontas para a criação do cluster. O comando a seguir verifica suas máquinas e rede para garantir que elas estejam prontas para a criação do cluster usando a lista mais recente de verificações:

bmctl check preflight --cluster CLUSTER_NAME --check-image-version latest

Substitua CLUSTER_NAME pelo nome do cluster que você está verificando.

Também é possível executar verificações de integridade de um cluster ativo para determinar se ele está íntegro. Para executar as verificações de integridade mais atualizadas em um cluster ativo, execute o seguinte comando:

bmctl check cluster --cluster CLUSTER_NAME --check-image-version latest

Substitua CLUSTER_NAME pelo nome do cluster que você está verificando.

Verificações de simulação para upgrades

O comando bmctl check preflight permite executar uma verificação de simulação antes de fazer upgrade do cluster. Verifique se os clusters estão prontos para um upgrade executando o seguinte comando de verificação de simulação antes de iniciar o upgrade:

  1. Atualize a versão do cluster (anthosBareMetalVersion) no arquivo de configuração do cluster.

  2. O comando a seguir permite verificar se os clusters estão prontos para um upgrade e executar uma verificação de simulação:

    bmctl check preflight --kubeconfig ADMIN_CLUSTER_KUBECONFIG_PATH
 -c CLUSTER_NAME

    Substitua:

    • CLUSTER_NAME: o nome do cluster a se fazer upgrade.
    • ADMIN_CLUSTER_KUBECONFIG_PATH: o caminho até o arquivo kubeconfig do cluster de administrador.

    O bmctl check preflight para upgrade funciona quando o cluster original está na versão 1.13.1 ou posterior.

    Quando você cria a verificação de simulação com esse comando para testar um upgrade de cluster de administrador ou usuário, um recurso personalizado PreflightCheck é criado no cluster de administrador.

Verificações de simulação para criação do cluster de usuário

Clusters de usuário são criados a partir de um cluster híbrido ou de administrador existente. O GKE em Bare Metal executa automaticamente verificações de simulação antes de fazer alterações. Também é possível executar verificações de simulação com bmctl antes de criar um cluster.

  • O comando a seguir valida o arquivo de configuração do cluster especificado, mas não tenta criar o próprio cluster:

    bmctl check config --cluster CLUSTER_NAME --admin-kubeconfig ADMIN_KUBECONFIG_PATH

    Substitua CLUSTER_NAME pelo nome do cluster de usuário que você está verificando e substitua ADMIN_KUBECONFIG_PATH pelo caminho para o arquivo kubeconfig do cluster de administrador associado.

  • Esse comando verifica se as máquinas e a rede estão prontas para a criação do cluster:

    bmctl check preflight --cluster CLUSTER_NAME --admin-kubeconfig ADMIN_KUBECONFIG_PATH

bmctl é compatível com o uso de --kubeconfig como um alias para a sinalização --admin-kubeconfig.

Verificações de simulação interna em clusters atuais

O GKE em Bare Metal também executa verificações internas de simulação quando você aplica recursos do Kubernetes em um cluster. Em caso de erro em uma verificação, o GKE em Bare Metal não fará alterações nos nós relacionados, a menos que você tenha ignorado as verificações especificamente.

Ignorar verificações de simulação ao aplicar recursos do Kubernetes

Para ignorar as verificações de simulação interna ao aplicar recursos a clusters atuais, você precisa definir o campo BypassPreflightCheck como true no arquivo YAML do cluster.

Este é um fragmento de um arquivo YAML de configuração do cluster, mostrando o campo bypassPreflightCheck definido como true.

# Sample cluster config to bypass preflight check errors:

apiVersion: v1
kind: Namespace
metadata:
  name: cluster-user1
---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: user1
  namespace: cluster-user1
spec:
  type: user
  bypassPreflightCheck: true
  # Anthos cluster version.
  anthosBareMetalVersion: 1.14.11
....

Detalhes da verificação de simulação da instalação

O GKE em Bare Metal analisa diversas condições de pré-requisitos de sistema operacional, software e máquina ao executar verificações de simulação.

Saiba mais detalhes em Visão geral dos pré-requisitos de instalação.