Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Debes configurar el sistema operativo base de tus máquinas de nodo para usar Google Distributed Cloud. En esta página, se incluyen los pasos que debes seguir para completar la configuración necesaria.
Para obtener más información sobre la solución de problemas relacionados con los requisitos de Google Distributed Cloud, consulta los problemas conocidos.
Antes de comenzar
Asegúrate de usar una versión compatible del sistema operativo y un kernel de Habilitación de hardware de Ubuntu (HWE). Para obtener una lista de las versiones compatibles, consulta Selecciona tu sistema operativo.
Habilita el compilador Just In Time de BPF
El kernel de tu sistema operativo debe tener habilitada la opción del compilador BPF Just In Time (CONFIG_BPF_JIT=y).
Para descubrir si esta opción está habilitada, ejecuta el siguiente comando:
grepCONFIG_BPF_JIT/boot/config-$(uname-r)
Valida el administrador de paquetes
Usa el siguiente comando para validar que el administrador de paquetes funcione correctamente:
sudoapt-getcheck
El resultado no debería mostrar errores y debería ser similar al siguiente ejemplo:
# Reading package lists... Done
# Building dependency tree
# Reading state information... Done
Inhabilita el Uncomplicated Firewall (UFW)
Inhabilita ufw:
sudo ufw disable
Verifica que ufw esté inhabilitado:
sudo ufw status
# Status: inactive
Configura Docker en tu estación de trabajo
Google Distributed Cloud te ayuda a instalar Docker en tus máquinas de equipos físicos en las siguientes situaciones:
Si tus máquinas de equipos físicos no tienen Docker instalado, bmctl instala 20.10.0 o versiones posteriores.
Si tus máquinas de equipos físicos tienen Docker 19.03.5 o una versión anterior, bmctl actualiza Docker a la versión 20.10.0 o posterior.
Sigue estos pasos para instalar Docker manualmente:
Verifica que esté ejecutando la versión 20.10.0+ de la siguiente manera:
sudo docker version
Compara tu resultado con el siguiente ejemplo para garantizar que las versiones de cliente y servidor sean 20.10.0+:
Client: Docker Engine - Community
Version: 25.0.3
...
Server: Docker Engine - Community
Engine:
Version: 25.0.3
Configura la sincronización de hora
La sincronización temporal consiste en configurar los relojes en tus máquinas de nodos con una referencia de tiempo externa designada. La sincronización temporal es importante para las actividades de clúster con concepción de tiempo, como el registro de eventos y la recopilación de métricas.
El kernel de tu máquina de nodos controla el reloj en contenedores que se ejecutan en los nodos. Para garantizar una sincronización temporal correcta, instala un servicio de protocolo NTP en tus máquinas con cualquiera de los servicios disponibles: chrony, systemd-timesyncd, ntp o ntpdate. Ejecuta timedatectl para verificar que el reloj del sistema esté sincronizado. El resultado de timedatectl debería contener el siguiente estado:
System clock synchronized: yes
Asegúrate de que los límites de inotify del kernel de Linux sean iguales o superiores al mínimo
Para las máquinas que ejecutan Ubuntu 22.04, los límites de inotify del kernel de Linux para las instancias de usuario y los relojes de usuario máximos deben ser mayores o iguales a los siguientes:
fs.inotify.max_user_instances: 8192
fs.inotify.max_user_watches: 524288
Para asegurarte de que estos valores se configuren correctamente en las máquinas de nodos, haz lo siguiente:
Comprueba el valor de max_user_instances:
cat/proc/sys/fs/inotify/max_user_instances
Si es necesario, actualiza max_user_instances al valor mínimo:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-31 (UTC)"],[],[],null,["You must configure the base operating system of your node machines to use\nGoogle Distributed Cloud. This page contains the steps you need to take to complete the\nneeded configuration.\nFor more information about troubleshooting Google Distributed Cloud requirements,\nsee the [known issues](/kubernetes-engine/distributed-cloud/bare-metal/docs/troubleshooting/known-issues).\n\nBefore you begin\n\nEnsure that you are using a supported version of your operating system and a\nUbuntu Hardware Enablement (HWE) kernel. For a list of supported versions, see\n[Select your operating system](/kubernetes-engine/distributed-cloud/bare-metal/docs/installing/os-reqs).\n\nEnable BPF Just In Time compiler\n\nThe kernel for your operating system must have the BPF Just In Time compiler\noption enabled (`CONFIG_BPF_JIT=y`).\n\n- To find out whether this option is enabled, run the following command:\n\n grep CONFIG_BPF_JIT /boot/config-$(uname -r)\n\nValidate the package manager\n\n- Use the following command to validate that the package manager is operating\n correctly:\n\n sudo apt-get check\n\n The output should show no errors and look similar to the following example: \n\n # Reading package lists... Done\n # Building dependency tree\n # Reading state information... Done\n\nDisable Uncomplicated Firewall (UFW)\n\n1. Disable `ufw`:\n\n sudo ufw disable\n\n2. Check that `ufw` is disabled:\n\n sudo ufw status\n # Status: inactive\n\nConfigure Docker on your workstation\n\nGoogle Distributed Cloud helps you install Docker on your bare metal machines in the\nfollowing scenarios:\n\n- If your bare metal machines don't have Docker installed, `bmctl` installs 20.10.0 or later.\n- If your bare metal machines have Docker 19.03.5 or earlier installed, `bmctl` upgrades Docker to version 20.10.0 or later.\n\n| **Note:** The workstation running `bmctl` needs non-root user access to Docker to start the temporary bootstrap (kind) cluster during installation. To enable non-root user access to Docker, go to [Manage Docker as a non-root user](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user).\n\nFollow these steps to manually install Docker:\n\n1. Remove any previous Docker version:\n\n sudo apt-get remove docker docker-engine docker.io containerd runc\n\n2. Update your package manager:\n\n sudo apt-get update\n\n3. Install Docker 20.10.0+:\n\n sudo apt-get install \\\n apt-transport-https \\\n ca-certificates \\\n curl \\\n gnupg-agent \\\n software-properties-common \\\n docker.io\n\n4. Verify you are now running version 20.10.0+:\n\n sudo docker version\n\n5. Compare your output with the following example to ensure the Client and Server versions are 20.10.0+ :\n\n Client: Docker Engine - Community\n Version: 25.0.3\n ...\n Server: Docker Engine - Community\n Engine:\n Version: 25.0.3\n\nSet up time synchronization\n\nTime synchronization consists of setting the clocks on your node machines, using\na designated external time reference. Time synchronization is important for\ntime-sentive cluster activities, such as event logging and metrics collection.\nThe kernel of your node machine controls the clock in containers that run on the\nnode. To ensure proper time synchronization, install a network time protocol\n(NTP) service on your machines, using any of the available services:\n[`chrony`](https://chrony.tuxfamily.org/), `systemd-timesyncd`,\n`ntp`, or `ntpdate`. Run `timedatectl` to verify the system clock is\nsynchronized. The output of `timedatectl` should contain the following status: \n\n System clock synchronized: yes\n\nEnsure Linux kernel `inotify` limits are at or higher than minimum\n\nFor machines running Ubuntu 22.04, Linux kernel `inotify` limits\nfor maximum user instances and user watches must be greater than or equal to the\nfollowing:\n\n- `fs.inotify.max_user_instances`: `8192`\n- `fs.inotify.max_user_watches`: `524288`\n\nTo ensure these values are set correctly on your node machines:\n\n1. Check the value of `max_user_instances`:\n\n cat /proc/sys/fs/inotify/max_user_instances\n\n2. If needed, update `max_user_instances` to the minimum value:\n\n echo 'fs.inotify.max_user_instances=8192' | sudo tee --append /etc/sysctl.conf\n\n3. Check the value of `max_user_watches`:\n\n cat /proc/sys/fs/inotify/max_user_watches\n\n4. If needed, update `max_user_watches` to the minimum value:\n\n echo 'fs.inotify.max_user_watches=524288' | sudo tee --append /etc/sysctl.conf\n\n5. If you updated either value, reboot the machine."]]