Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Vous devez configurer le système d'exploitation de base de vos machines de nœud pour pouvoir utiliser Google Distributed Cloud. Cette page contient la procédure à suivre pour terminer la configuration requise.
Pour en savoir plus sur le dépannage des exigences Google Distributed Cloud, consultez les problèmes connus.
Avant de commencer
Assurez-vous d'utiliser une version compatible de votre système d'exploitation et un noyau d'activation matérielle (HWE) Ubuntu. Pour obtenir la liste des versions compatibles, consultez Sélectionner votre système d'exploitation.
Activer le compilateur opportun BPF
L'option de compilateur opportun BPF doit être activée pour le noyau de votre système d'exploitation (CONFIG_BPF_JIT=y).
Pour savoir si cette option est activée, exécutez la commande suivante :
grepCONFIG_BPF_JIT/boot/config-$(uname-r)
Valider le gestionnaire de packages
Utilisez la commande suivante pour vérifier que le gestionnaire de packages fonctionne correctement :
sudoapt-getcheck
Le résultat ne doit afficher aucune erreur et devrait ressembler à l'exemple suivant :
# Reading package lists... Done
# Building dependency tree
# Reading state information... Done
Désactiver le pare-feu UFW (Uncomplicated Firewall)
Désactivez ufw :
sudo ufw disable
Vérifiez que ufw est désactivé :
sudo ufw status
# Status: inactive
Configurer Docker sur votre poste de travail
Google Distributed Cloud vous permet d'installer Docker sur vos machines physiques dédiées dans les cas suivants :
Si Docker n'est pas installé sur vos machines bare metal, bmctl installe la version 19.03.13 ou une version ultérieure.
Si Docker 19.03.5 ou version antérieure est installé sur vos machines bare metal, bmctl met à niveau Docker vers la version 20.10.0 ou ultérieure.
Pour installer Docker manuellement, procédez comme suit :
Vérifiez que vous utilisez la version 20.10.0 ou une version ultérieure :
sudo docker version
Comparez votre résultat à l'exemple suivant pour vous assurer que les versions Client et Serveur sont en version 20.10.0+ :
Client: Docker Engine - Community
Version: 25.0.3
...
Server: Docker Engine - Community
Engine:
Version: 25.0.3
Configurer la synchronisation horaire
La synchronisation horaire consiste à définir les horloges de vos machines de nœud en utilisant une référence de temps externe désignée. La synchronisation horaire est importante pour les activités de cluster urgentes, telles que la journalisation d'événements et la collecte de métriques.
Le noyau de votre machine de nœud contrôle l'horloge des conteneurs exécutés sur le nœud. Pour assurer une synchronisation horaire appropriée, installez un service de protocole réseau (NTP) sur vos machines en utilisant l'un des services disponibles : chrony, systemd-timesyncd, ntp ou ntpdate. Exécutez timedatectl pour vérifier que l'horloge système est bien synchronisée. La sortie de timedatectl doit contenir l'état suivant :
System clock synchronized: yes
Assurez-vous que les limites de inotify du noyau Linux sont égales ou supérieures au minimum.
Pour les machines exécutant Ubuntu 22.04, les limites inotify du noyau Linux pour le nombre maximal d'instances utilisateur et de montres utilisateur doivent être supérieures ou égales aux valeurs suivantes :
fs.inotify.max_user_instances : 8192
fs.inotify.max_user_watches : 524288
Pour vous assurer que ces valeurs sont correctement définies sur vos machines de nœud :
Vérifiez la valeur de max_user_instances :
cat/proc/sys/fs/inotify/max_user_instances
Si nécessaire, mettez à jour max_user_instances avec la valeur minimale :
Si vous avez modifié l'une des valeurs, redémarrez la machine.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/03 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/03 (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."]]