Configure o Ubuntu

Tem de configurar o sistema operativo base das suas máquinas de nós para usar o Google Distributed Cloud. Esta página contém os passos que tem de seguir para concluir a configuração necessária. Para mais informações sobre a resolução de problemas dos requisitos do Google Distributed Cloud, consulte os problemas conhecidos.

Antes de começar

Certifique-se de que está a usar uma versão suportada do sistema operativo e um kernel de ativação de hardware (HWE) do Ubuntu. Para ver uma lista das versões suportadas, consulte a secção Selecione o seu sistema operativo.

Ative o compilador Just In Time do BPF

O kernel do seu sistema operativo tem de ter a opção do compilador Just In Time do BPF ativada (CONFIG_BPF_JIT=y).

• Para saber se esta opção está ativada, execute o seguinte comando:

  grep CONFIG_BPF_JIT /boot/config-$(uname -r)
  

Valide o gestor de pacotes

• Use o seguinte comando para validar se o gestor de pacotes está a funcionar corretamente:

  sudo apt-get check
  

  O resultado não deve apresentar erros e deve ser semelhante ao seguinte exemplo:

  # Reading package lists... Done
  # Building dependency tree
  # Reading state information... Done
  

Desative a firewall não complicada (UFW)

1. Desative a ufw:

   sudo ufw disable
   

2. Verifique se a opção ufw está desativada:

   sudo ufw status
   # Status: inactive
   

Configure o Docker na sua 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 suas máquinas bare metal não tiverem o Docker instalado, o bmctl instala a versão 20.10.0 ou posterior.
• Se as suas máquinas bare metal tiverem o Docker 19.03.5 ou anterior instalado, bmctl atualize o Docker para a versão 20.10.0 ou posterior.

Nota: a estação de trabalho que executa o bmctl precisa de acesso de utilizador não root ao Docker para iniciar o cluster de arranque temporário (tipo) durante a instalação. Para ativar o acesso de utilizadores sem acesso de raiz ao Docker, aceda a Faça a gestão do Docker como utilizador sem acesso de raiz.

Siga estes passos para instalar manualmente o Docker:

1. Remova qualquer versão anterior do Docker:

   sudo apt-get remove docker docker-engine docker.io containerd runc
   

2. Atualize o gestor de pacotes:

   sudo apt-get update
   

3. Instale o Docker 20.10.0 ou superior:

   sudo apt-get install \
     apt-transport-https \
     ca-certificates \
     curl \
     gnupg-agent \
     software-properties-common \
     docker.io
   

4. Verifique se está a usar a versão 20.10.0 ou superior:

   sudo docker version
   

5. Compare a sua saída com o exemplo seguinte para garantir que as versões do cliente e do servidor são 20.10.0 ou superior :

    Client: Docker Engine - Community
    Version:           25.0.3
    ...
    Server: Docker Engine - Community
     Engine:
     Version:          25.0.3
   

Configure a sincronização de tempo

A sincronização de tempo consiste em definir os relógios nas máquinas dos nós, usando uma referência de tempo externa designada. A sincronização de tempo é importante para atividades de cluster sensíveis ao tempo, como o registo de eventos e a recolha de métricas. O kernel da máquina do nó controla o relógio nos contentores executados no nó. Para garantir a sincronização de tempo adequada, instale um serviço de protocolo de tempo de rede (NTP) nas suas 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. O resultado de timedatectl deve conter o seguinte estado:

System clock synchronized: yes

Certifique-se de que os limites do kernel do Linux inotify estão no mínimo ou acima do mínimo

Para máquinas com o Ubuntu 22.04, os limites do kernel Linux inotify para o número máximo de instâncias de utilizadores e observações de utilizadores têm de ser superiores ou iguais aos seguintes:

• fs.inotify.max_user_instances: 8192
• fs.inotify.max_user_watches: 524288

Para garantir que estes valores estão definidos corretamente nas máquinas de nós:

1. Verifique o valor de max_user_instances:

   cat /proc/sys/fs/inotify/max_user_instances
   

2. Se necessário, atualize max_user_instances para o valor mínimo:

   echo 'fs.inotify.max_user_instances=8192' | sudo tee --append /etc/sysctl.conf
   

3. Verifique o valor de max_user_watches:

   cat /proc/sys/fs/inotify/max_user_watches
   

4. Se necessário, atualize max_user_watches para o valor mínimo:

   echo 'fs.inotify.max_user_watches=524288' | sudo tee --append /etc/sysctl.conf
   

5. Se atualizou algum dos valores, reinicie a máquina.