Requisitos previos de la estación de trabajo de administrador

La estación de trabajo de administrador aloja las herramientas de la interfaz de línea de comandos (CLI) y los archivos de configuración para aprovisionar clústeres durante la instalación, así como las herramientas de la CLI con el fin de interactuar con los clústeres aprovisionados después de la instalación.

Debes descargar y ejecutar herramientas, como bmctl y Google Cloud CLI, en la estación de trabajo de administrador para interactuar con los clústeres y los recursos de Google Cloud. La estación de trabajo de administrador aloja archivos de configuración para aprovisionar clústeres durante la instalación y las actualizaciones. Después de la instalación, la estación de trabajo de administrador aloja archivos kubeconfig para que puedas usar kubectl a fin de interactuar con los clústeres aprovisionados. También puedes acceder a los registros de las operaciones esenciales del clúster en la estación de trabajo de administrador. Se puede usar una sola estación de trabajo de administrador para crear y administrar muchos clústeres.

Asegúrate de que la estación de trabajo de administrador cumpla con los requisitos previos que se describen en las siguientes secciones.

Nota: Una estación de trabajo que cumpla con los requisitos de esta página se puede usar como la estación de trabajo de administrador para crear y administrar los clústeres. Además, puedes usar la estación de trabajo como un nodo del plano de control del administrador para uno de tus clústeres.

Sistema operativo y software

Para ejecutar bmctl y funcionar como un nodo del plano de control, la estación de trabajo de administrador tiene los mismos requisitos de sistema operativo (SO) que los nodos. La estación de trabajo de administrador requiere Docker, pero no debe usarse como entorno de ejecución de contenedores. Cuando GKE en Bare Metal crea clústeres, implementa un clúster de Kubernetes en Docker (tipo) en la estación de trabajo de administrador. Este clúster de arranque aloja los controladores de Kubernetes necesarios para crear clústeres. A menos que especifiques lo contrario, el clúster de arranque se quita cuando la creación del clúster se completa de forma correcta. El clúster de arranque necesita Docker para extraer imágenes de contenedor.

Nota: El clúster de arranque usa un solo nodo en la memoria para realizar la instalación y tiene recursos limitados. Si instalas un clúster con más de 20 nodos, crea el clúster solo con nodos del plano de control. Una vez que el clúster esté en funcionamiento, agrega los nodos trabajadores restantes. En esta situación, los nodos del plano de control realizan la instalación del nodo trabajador.

La estación de trabajo de administrador debe cumplir con los siguientes requisitos para poder instalar un clúster:

• El sistema operativo es una distribución compatible con Linux.

  Para obtener una lista de los SO y versiones de Linux compatibles, consulta Selecciona tu sistema operativo. Esa página tiene vínculos a las instrucciones de configuración, incluida la configuración de Docker, para cada SO.

• Tener instalada la versión 19.03 o posterior de Docker Sin embargo, si tu sistema usa cgroup v2, la instalación de Docker en la estación de trabajo de administrador debe ser 20.10.0 o superior. (puedes determinar si tu sistema usa cgroup v2 por la presencia del archivo /sys/fs/cgroup/cgroup.controllers). cgroup v2 solo es compatible como función de Preview. No recomendamos el uso de las características y capacidades de Versión preliminar en entornos de producción.

  Advertencia: Docker instalado por Snap se encuentra en modo de confinamiento estricto de forma predeterminada, lo que significa que Docker no puede acceder a los archivos fuera del directorio $HOME. Ejecuta snap info --verbose docker | grep confinement en la estación de trabajo de administrador para verificar que Docker esté en modo de confinamiento estricto. Si este es tu caso, asegúrate de que la carpeta bmctl-workspace esté en el directorio $HOME.

• El usuario no raíz es miembro del grupo docker (para obtener instrucciones, consulta Administra Docker como un usuario no raíz).

• Google Cloud CLI esté instalado.

  Usas las herramientas de kubectl y bmctl para crear y administrar clústeres. Para instalarlas, necesitas las herramientas de gcloud y gsutil. Las herramientas de línea de comandos de gcloud, gsutil y kubectl son componentes de gcloud CLI. Si quieres obtener instrucciones de instalación, incluidas las instrucciones para instalar componentes, consulta Instala la CLI de gcloud.

• Se instaló kubectl. Usa gcloud CLI para instalar kubectl con el siguiente comando:

  gcloud components install kubectl
  

• bmctl está instalado para la versión del clúster que estás creando u operando.

  La instalación consiste en usar gsutil para descargar el paquete de imágenes o objetos binarios bmctl. Para obtener instrucciones, consulta Descargas de clústeres de Anthos alojados en Bare Metal.

Requisitos de recursos de hardware

La estación de trabajo de administrador requiere una potencia de procesamiento, memoria y almacenamiento significativos para ejecutar herramientas y almacenar los recursos asociados con la creación y administración de clústeres.

De forma predeterminada, las operaciones de actualización y creación del clúster usan un clúster de arranque. Cuando se usa un clúster de arranque, hay un aumento significativo en el uso de CPU y memoria. Si pretendes usar la estación de trabajo de administrador como un nodo de plano de control, no uses menos de la cantidad recomendada de CPU y RAM más alta para evitar que las actividades de la estación de trabajo de administrador interrumpan las funciones del plano de control del clúster.

Según el tamaño de la base de datos de etcd y la cantidad de nodos del plano de control, las operaciones de copia de seguridad y restablecimiento del clúster consumen una cantidad considerable de RAM. La estimación aproximada de RAM necesaria para las copias de seguridad es de 3 a 5 GiB por nodo del plano de control. El proceso de copia de seguridad falla porque no hay suficiente memoria. Planifica los requisitos de RAM en función de ello.

En la siguiente tabla, se proporcionan los requisitos de hardware mínimos y recomendados para la estación de trabajo de administrador:

Recurso	Mínimo	Recomendado
CPU / CPU virtuales^*	2 núcleos	4 núcleos
RAM	Ubuntu: 4 GiB RHEL: 6 GiB	Ubuntu: 8 GiB RHEL: 12 GiB
Almacenamiento	128 GiB	256 GiB

^* GKE en Bare Metal solo admite CPU x86-64 y CPU virtuales en el nivel de microarquitectura de CPU v3 (x86-64-v3) y superior.

Requisitos de Herramientas de redes

La estación de trabajo de administrador necesita acceso a Google Cloud y a todos los nodos del clúster.

Acceso a Google Cloud

La estación de trabajo de administrador accede a Google Cloud para descargar y también instalar imágenes y herramientas, procesar solicitudes de autorización, crear cuentas de servicio, administrar el registro y la supervisión, y mucho más. No puedes crear clústeres sin acceso a Google Cloud.

El acceso a Google Cloud puede ser directo o a través de un servidor proxy. Para obtener información sobre las diferentes formas de conectarse a Google Cloud, consulta Conéctate a Google. Si quieres obtener información para configurar un servidor proxy, consulta Cómo realizar la instalación detrás de un proxy.

Para obtener información sobre las consecuencias de la interrupción del acceso a Google Cloud, consulta Impacto de la desconexión temporal de Google Cloud.

Acceso a nodos

Para crear y administrar clústeres desde la estación de trabajo de administrador, necesitas el siguiente acceso a las máquinas del nodo:

• Conectividad de capa 3 a todas las máquinas de nodo del clúster.
• Acceso SSH sin contraseña a todas las máquinas de nodos del clúster como root o como un usuario no raíz con privilegios sudo sin contraseña
• Acceso a la VIP del plano de control.

Reenvío de IP

El reenvío de IP debe estar habilitado en la estación de trabajo de administrador. Sin el reenvío de IP, no se puede crear el clúster de arranque, lo que bloquea la creación de clústeres. Si el reenvío de IP está inhabilitado, verás un error como el siguiente cuando intentes crear un clúster:

Error message: E0202 14:53:25.979322 225917 console.go:110] Error creating cluster: create kind cluster failed: error creating bootstrap cluster: failed to init node with kubeadm: command "docker exec --privileged bmctl-control-plane kubeadm init --skip-phases=preflight --config=/kind/kubeadm.conf --skip-token-print --v=6" failed with error: exit status 1

Puedes verificar la configuración de reenvío de IP con el siguiente comando:

cat /proc/sys/net/ipv4/ip_forward

Un valor de 1 indica que el reenvío de IP está habilitado. Si el reenvío de IP está inhabilitado (0), usa el siguiente comando para habilitarlo:

echo '1' | sudo tee /proc/sys/net/ipv4/ip_forward

Configura el acceso SSH de root a los nodos

Para habilitar conexiones seguras y sin contraseña entre la estación de trabajo de administrador y las máquinas de nodos del clúster, crea una clave SSH en tu estación de trabajo de administrador y comparte la clave pública con los nodos del clúster.

Nota: En las siguientes instrucciones, se configura el acceso SSH sin contraseña a los nodos para el usuario root. Como alternativa, puedes usar un usuario que no sea raíz y que tenga privilegios de sudo sin contraseña. Este usuario no raíz debe especificarse en el archivo de configuración del clúster (nodeAccess.loginUser). Para obtener más información, consulta Configura un usuario de acceso.

1. Para habilitar la autenticación con contraseña SSH de root en la máquina de cada nodo del clúster, quita los comentarios o agrega las líneas PermitRootLogin y PasswordAuthentication en el archivo /etc/ssh/sshd_config, y configura los valores como yes.

   # $OpenBSD: sshd_config,v 1.103 2018/04/09 20:41:22 tj Exp $
   
   # This is the sshd server system-wide configuration file.  See
   # sshd_config(5) for more information.
   
   ...
   
   # Authentication:
   
   #LoginGraceTime 2m
   PermitRootLogin yes
   #StrictModes yes
   #MaxAuthTries 6
   #MaxSessions 10
   
   ...
   
   PasswordAuthentication yes
   

   Al principio, necesitas que la autenticación con contraseña SSH esté habilitada en las máquinas de nodo del clúster remoto para compartir claves desde la estación de trabajo de administrador.

2. Para aplicar los cambios en la configuración de SSH, reinicia el servicio SSH:

   sudo systemctl restart ssh.service
   

3. Generar un par de claves privadas y públicas en la estación de trabajo de administrador No establezcas una frase de contraseña para las claves. Genera las claves con el siguiente comando:

   ssh-keygen -t rsa
   

   También puedes usar el acceso de usuario sudo a las máquinas del nodo del clúster para configurar SSH. Sin embargo, para las conexiones de usuario no raíz sin contraseña, debes actualizar el archivo de configuración del clúster con el campo spec.nodeAccess.loginUser. Este campo está marcado como comentario de forma predeterminada. Puedes especificar tu nombre de usuario no raíz con loginUser durante la creación del clúster o en cualquier momento posterior. Si deseas obtener más información, consulta loginUser.

4. Agrega la clave pública generada a las máquinas del nodo del clúster:

   ssh-copy-id -i PATH_TO_IDENTITY_FILE root@CLUSTER_NODE_IP
   

   Reemplaza lo siguiente:

   • PATH_TO_IDENTITY_FILE: Es la ruta de acceso al archivo que contiene la clave pública SSH. De forma predeterminada, la ruta de acceso al archivo de identidad que contiene la clave pública es /home/USERNAME/.ssh/id_rsa.pub.
   • CLUSTER_NODE_IP: Es la dirección IP de la máquina de nodos a la que agregas la clave pública SSH.

5. Para inhabilitar la autenticación con contraseña SSH en las máquinas de nodo del clúster, configura PasswordAuthentication como no en el archivo sshd_config y reinicia el servicio SSH.

6. Usa el siguiente comando en la estación de trabajo de administrador para verificar que la autenticación de clave pública funcione entre la estación de trabajo y las máquinas del nodo.

   ssh -o IdentitiesOnly=yes -i PATH_TO_IDENTITY_FILE root@CLUSTER_NODE_IP
   

   Cuando SSH se configura de forma correcta, puedes acceder a la máquina de nodos desde la estación de trabajo de administrador (como root) sin tener que ingresar una contraseña.

¿Qué sigue?

• Requisitos previos de la máquina de nodo