Os clusters do Anthos em bare metal agora são o Google Distributed Cloud (somente software) em bare metal. Para mais informações, consulte a visão geral do produto.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
É necessário configurar o sistema operacional de base das máquinas de nó para usar
o Google Distributed Cloud. Esta página contém as etapas necessárias para concluir a configuração necessária.
Para mais informações sobre como resolver problemas de requisitos do Google Distributed Cloud,
consulte os problemas conhecidos.
Antes de começar
Verifique se você está usando uma versão compatível do sistema operacional e um
kernel de ativação de hardware do Ubuntu (HWE). Para acessar uma lista de versões compatíveis, consulte
Selecionar seu sistema operacional.
Ativar o compilador Just in Time do BPF
O kernel do sistema operacional precisa ter a opção do compilador Just In Time
BPF ativada (CONFIG_BPF_JIT=y).
Para saber se essa opção está ativada, execute o seguinte comando:
grepCONFIG_BPF_JIT/boot/config-$(uname-r)
Validar o gerenciador de pacotes
Use o seguinte comando para validar se o gerenciador de pacotes está funcionando
corretamente:
sudoapt-getcheck
A resposta não mostrará erros e será semelhante ao exemplo a seguir:
# Reading package lists... Done
# Building dependency tree
# Reading state information... Done
Desativar Uncomplicated Firewall (UFW)
Desative ufw:
sudo ufw disable
Verifique se ufw está desativado:
sudo ufw status
# Status: inactive
Configurar o Docker na estação de trabalho
O Google Distributed Cloud ajuda a instalar o Docker nas suas máquinas bare metal nos
seguintes cenários:
Se as máquinas bare metal não tiverem o Docker instalado, o bmctl vai instalar
20.10.0 ou mais recente.
Se as máquinas bare metal tiverem o Docker 19.03.5 ou anterior instalado, o bmctl
fará upgrade do Docker para a versão 20.10.0 ou mais recente.
Siga estas etapas para instalar o Docker manualmente:
Verifique se você está usando a versão 20.10.0 ou posterior:
sudo docker version
Compare o resultado com o exemplo a seguir para garantir que as versões do cliente e do servidor sejam 20.10.0 ou posterior :
Client: Docker Engine - Community
Version: 25.0.3
...
Server: Docker Engine - Community
Engine:
Version: 25.0.3
Configurar a sincronização de horário
A sincronização de tempo consiste em definir os relógios nas máquinas de nós, usando uma
referência de hora externa designada. A sincronização de tempo é importante para atividades de cluster com base em tempo, como geração de registros de eventos e coleta de métricas.
O kernel da máquina de nó controla o relógio nos contêineres executados no nó. Para garantir a sincronização de tempo adequada, instale um serviço
Network Time Protocol (NTP) nas máquinas usando qualquer um dos serviços disponíveis:
chrony, systemd-timesyncd,
ntp ou ntpdate. Execute timedatectl para verificar se o relógio do sistema está
sincronizado. A saída de timedatectl precisa conter o status a seguir:
System clock synchronized: yes
Confira se os limites inotify do kernel do Linux são iguais ou maiores que o mínimo
Para máquinas com Ubuntu 22.04, os limites de inotify do kernel do Linux
para instâncias de usuário máximas e monitoramentos de usuário precisam ser maiores
ou iguais a estes:
fs.inotify.max_user_instances: 8192
fs.inotify.max_user_watches: 524288
Para garantir que esses valores sejam definidos corretamente nas máquinas de nó:
Verifique o valor de max_user_instances:
cat/proc/sys/fs/inotify/max_user_instances
Se necessário, atualize max_user_instances para o valor mínimo:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-14 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."]]