Comprender las comprobaciones previas

En GKE en Bare Metal, puedes ejecutar comprobaciones preliminares para diferentes situaciones:

  • GKE en Bare Metal ejecuta comprobaciones previas cuando creas o actualizas clústeres de administrador, híbridos, independientes o de usuario y recursos de grupo de nodos con bmctl. Si las verificaciones fallan, no se realizan cambios. También puedes omitir estas verificaciones.
  • GKE en Bare Metal también ejecuta comprobaciones preliminares internas cuando aplicas recursos de Kubernetes a los clústeres de usuario desde un clúster híbrido o de administrador. Las verificaciones se ejecutan antes de que los cambios se apliquen en los clústeres de usuarios afectados. Si las verificaciones fallan, no se realizan cambios. También puedes omitir estas verificaciones o ejecutarlas de forma explícita.

Comprobaciones previas para la creación de clústeres con bmctl

Cuando creas clústeres de admin, híbridos, independientes o de usuario con el comando bmctl, GKE en Bare Metal ejecuta de forma automática las comprobaciones preliminares antes de que se realice cualquier cambio.

Cuando se aprueben las verificaciones, GKE en Bare Metal creará los clústeres.

Ignora los resultados de las comprobaciones previas

Si deseas omitir estas verificaciones previas automatizadas, puedes usar la marca opcional --force en el comando.

Ejecuta comprobaciones previas de forma independiente

También puedes ejecutar verificaciones previas por sí solas antes de crear un clúster. Esto puede ayudar a ahorrar tiempo, ya que garantiza que los recursos de tu máquina y nodo aprueben las verificaciones.

  • El siguiente comando valida el archivo de configuración del clúster especificado, pero no intenta crear el clúster en sí:

    bmctl check config --cluster CLUSTER_NAME
    

    Reemplaza CLUSTER_NAME por el nombre del clúster cuyo archivo de configuración verificas.

  • Este comando comprueba si las máquinas y la red están listas para la creación del clúster:

    bmctl check preflight --cluster CLUSTER_NAME
    

    Reemplaza CLUSTER_NAME por el nombre del clúster que deseas verificar.

Ejecuta las comprobaciones preliminares y las verificaciones de estado más recientes

Puedes realizar comprobaciones preliminares en tu sistema. Las comprobaciones preliminares garantizan que las máquinas y la red estén listas para la creación de clústeres. El siguiente comando verifica las máquinas y la red a fin de asegurarse de que estén listas para la creación de clústeres mediante la lista de verificaciones más reciente:

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

Reemplaza CLUSTER_NAME por el nombre del clúster que estás verificando.

También puedes realizar verificaciones de estado de un clúster activo para determinar si está en buen estado. Para realizar las verificaciones de estado más actualizadas en un clúster activo, ejecuta el siguiente comando:

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

Reemplaza CLUSTER_NAME por el nombre del clúster que estás verificando.

Verificaciones previas para actualizaciones

El comando bmctl check preflight te permite ejecutar una verificación previa antes de actualizar el clúster. A fin de verificar si los clústeres están listos para una actualización, ejecuta el siguiente comando de comprobación previa antes de comenzar la actualización:

  1. Actualiza la versión del clúster (anthosBareMetalVersion) en el archivo de configuración del clúster.
  2. El siguiente comando te permite comprobar si los clústeres están listos para una actualización y ejecutar una verificación previa:

    bmctl check preflight --kubeconfig ADMIN_CLUSTER_KUBECONFIG_PATH
     -c CLUSTER_NAME
    

    Reemplaza lo siguiente:

    • CLUSTER_NAME: el nombre del clúster que se actualizará
    • ADMIN_CLUSTER_KUBECONFIG_PATH: Es la ruta de acceso al archivo kubeconfig del clúster de administrador.

    Ten en cuenta que la bmctl check preflight para la actualización funciona cuando el clúster original es la versión 1.13.1 o posterior.

    Cuando creas la verificación previa con este comando para probar una actualización de clúster de administrador o de usuario, se crea un recurso personalizado PreflightCheck en el clúster de administrador.

Comprobaciones previas para la creación de clústeres de usuarios

Los clústeres de usuario en equipos físicos se crean a partir de un clúster existente de administrador o híbrido. GKE en Bare Metal ejecuta de manera automática verificaciones previas antes de realizar cambios. También puedes ejecutar verificaciones previas con bmctl antes de crear un clúster.

  • El siguiente comando valida el archivo de configuración del clúster especificado, pero no intenta crear el clúster en sí:

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

    Reemplaza CLUSTER_NAME por el nombre del clúster de usuario que verificas y reemplaza ADMIN_KUBECONFIG_PATH por la ruta de acceso al archivo kubeconfig del clúster de administrador asociado.

  • Este comando comprueba si las máquinas y la red están listas para la creación del clúster:

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

bmctl admite el uso de --kubeconfig como alias para la marca --admin-kubeconfig.

Comprobación previas interna en clústeres existentes

GKE en Bare Metal también realiza comprobaciones previas internas cuando aplicas recursos de Kubernetes a un clúster existente. Si alguna verificación falla, GKE en Bare Metal no realizará ningún cambio en los nodos relacionados, a menos que hayas pasado las verificaciones de forma específica.

Omite las verificaciones previas cuando apliques recursos de Kubernetes

Para ignorar las comprobaciones preliminares internas cuando se aplican recursos a clústeres existentes, debes establecer el campo BypassPreflightCheck en true en el archivo YAML del clúster.

Este es un fragmento de un archivo YAML de configuración del clúster que muestra el campo bypassPreflightCheck establecido en 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
....

Detalles de la comprobación previa de la instalación

GKE en Bare Metal verifica una variedad de condiciones de requisitos previos del sistema operativo, software y máquina cuando se ejecutan comprobaciones preliminares.

Para obtener información más detallada, consulta Descripción general de los requisitos previos de instalación.