Configura Ubuntu

Per utilizzare Google Distributed Cloud, devi configurare il sistema operativo di base delle macchine nodo. Questa pagina contiene i passaggi da seguire per completare la configurazione necessaria. Per ulteriori informazioni sulla risoluzione dei requisiti di Google Distributed Cloud, consulta i problemi noti.

Prima di iniziare

Assicurati di utilizzare una versione supportata del tuo sistema operativo e un kernel HWE (Ubuntu Hardware Enablement). Per un elenco delle versioni supportate, vedi Selezionare il tuo sistema operativo.

Attiva compilatore BPF Just In Time

Nel kernel del tuo sistema operativo deve essere abilitata l'opzione del compilatore BPF Just In Time (CONFIG_BPF_JIT=y).

• Per verificare se questa opzione è abilitata, esegui questo comando:

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

Convalida del gestore di pacchetti

• Utilizza il seguente comando per verificare il corretto funzionamento del gestore di pacchetti:

  sudo apt-get check
  

  L'output non dovrebbe mostrare errori ed essere simile all'esempio seguente:

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

Disabilita firewall senza complicazioni (UFW)

1. Disabilita ufw:

   sudo ufw disable
   

2. Verifica che ufw sia disattivato:

   sudo ufw status
   # Status: inactive
   

Configura Docker sulla workstation

Google Distributed Cloud ti aiuta a installare Docker sulle tue macchine bare metal negli scenari seguenti:

• Se nelle tue macchine bare metal non è installato Docker, bmctl installa 20.10.0 o versioni successive.
• Se nelle tue macchine bare metal è installato Docker 19.03.5 o versioni precedenti, bmctl esegue l'upgrade di Docker alla versione 20.10.0 o successive.

Nota: la workstation che esegue bmctl deve accedere a Docker da un utente non root per avviare il cluster di bootstrap temporaneo (kind) durante l'installazione. Per abilitare l'accesso di utenti non root a Docker, vai a Gestire Docker come utente non root.

Segui questi passaggi per installare manualmente Docker:

1. Rimuovi qualsiasi versione precedente di Docker:

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

2. Aggiorna il gestore di pacchetti:

   sudo apt-get update
   

3. Installa Docker 20.10.0 o versioni successive:

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

4. Verifica che sia in esecuzione la versione 20.10.0 o successive:

   sudo docker version
   

5. Confronta l'output con l'esempio seguente per assicurarti che le versioni client e server siano 20.10.0+ :

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

Configurare la sincronizzazione dell'ora

La sincronizzazione dell'ora consiste nell'impostare gli orologi sulle macchine nodo, utilizzando un riferimento temporale esterno designato. La sincronizzazione dell'ora è importante per le attività del cluster con sentenza temporale, come il logging degli eventi e la raccolta di metriche. Il kernel della macchina nodo controlla l'orologio nei container in esecuzione sul nodo. Per garantire una corretta sincronizzazione dell'ora, installa un servizio NTP (Network Time Protocol) sulle tue macchine utilizzando uno dei servizi disponibili: chrony, systemd-timesyncd, ntp o ntpdate. Esegui timedatectl per verificare che l'orologio di sistema sia sincronizzato. L'output di timedatectl dovrebbe contenere il seguente stato:

System clock synchronized: yes

Assicurati che i limiti inotify del kernel Linux siano uguali o superiori al minimo

Per le macchine che eseguono Ubuntu 22.04, i limiti del kernel Linux inotify per il numero massimo di istanze e orologi utente devono essere maggiori o uguali al seguente:

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

Per assicurarti che questi valori siano impostati correttamente sulle tue macchine nodo:

1. Verifica il valore di max_user_instances:

   cat /proc/sys/fs/inotify/max_user_instances
   

2. Se necessario, aggiorna max_user_instances impostandolo sul valore minimo:

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

3. Verifica il valore di max_user_watches:

   cat /proc/sys/fs/inotify/max_user_watches
   

4. Se necessario, aggiorna max_user_watches impostandolo sul valore minimo:

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

5. Se hai aggiornato uno dei due valori, riavvia la macchina.