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:
- Actualiza la versión del clúster (
anthosBareMetalVersion
) en el archivo de configuración del clúster. 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.