Configurar o Ubuntu

É 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:

    grep CONFIG_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:

    sudo apt-get check
    

    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)

  1. Desative ufw:

    sudo ufw disable
    
  2. 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:

  1. Remova qualquer versão anterior do Docker:

    sudo apt-get remove docker docker-engine docker.io containerd runc
    
  2. Atualize seu gerenciador de pacotes:

    sudo apt-get update
    
  3. Instale o Docker 20.10.0 ou posterior:

    sudo apt-get install \
      apt-transport-https \
      ca-certificates \
      curl \
      gnupg-agent \
      software-properties-common \
      docker.io
    
  4. Verifique se você está usando a versão 20.10.0 ou posterior:

    sudo docker version
    
  5. 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ó:

  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 você tiver atualizado um dos valores, reinicie a máquina.