設定 Ubuntu

如要使用 Google Distributed Cloud,您必須在節點機器上設定基礎 Ubuntu 作業系統。設定必要的套件管理工具、核心參數和系統服務,為叢集部署作業做好節點準備。如要排解 Google Distributed Cloud 需求條件的問題,請參閱已知問題。

事前準備

請確認您使用的是支援的作業系統版本和 Ubuntu 硬體啟用 (HWE) 核心。如需支援的版本清單,請參閱「選取作業系統」。

啟用 cgroupsv2

裸機適用的 Google Distributed Cloud 軟體 (僅限軟體) 1.35 以上版本需要 cgroupsv2。作業系統必須支援 cgroupsv2,才能升級或建立叢集。

如果預檢期間偵測到 cgroupsv1,Google Distributed Cloud 會禁止建立或升級叢集。如要瞭解如何將作業系統遷移至 cgroupsv2,請參閱 Kubernetes 說明文件中的「遷移至 cgroup v2」。

啟用 BPF 即時編譯器

作業系統的核心必須啟用 BPF 即時編譯器選項 (CONFIG_BPF_JIT=y)。

  • 如要確認是否已啟用這個選項,請執行下列指令:

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

驗證套件管理工具

  • 使用下列指令,驗證套件管理工具是否正常運作:

    sudo apt-get check
    

    輸出內容應不會顯示任何錯誤,且大致如下:

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

停用 Uncomplicated Firewall (UFW)

  1. 停用 ufw:

    sudo ufw disable
    
  2. 確認 ufw 已停用:

    sudo ufw status
    # Status: inactive
    

在工作站上設定 Docker

在下列情況下,Google Distributed Cloud 可協助您在裸機機器上安裝 Docker:

  • 如果裸機機器未安裝 Docker,bmctl 會安裝 20.10.0 以上版本。
  • 如果裸機機器安裝的是 Docker 19.03.5 或更早版本,bmctl 會將 Docker 升級至 20.10.0 以上版本。

請按照下列步驟手動安裝 Docker:

  1. 移除所有舊版 Docker:

    sudo apt-get remove docker docker-engine docker.io containerd runc
    
  2. 更新套件管理工具:

    sudo apt-get update
    
  3. 安裝 Docker 20.10.0 以上版本:

    sudo apt-get install \
      apt-transport-https \
      ca-certificates \
      curl \
      gnupg-agent \
      software-properties-common \
      docker.io
    
  4. 確認目前執行的是 20.10.0 以上版本:

    sudo docker version
    
  5. 將輸出內容與以下範例比較,確認用戶端和伺服器版本為 20.10.0+:

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

設定時間同步

時間同步處理是指使用指定的外部時間參考,設定節點機器上的時鐘。時間同步處理對於時間敏感的叢集活動 (例如事件記錄和指標收集) 非常重要。節點機器的核心會控制在節點上執行的容器時鐘。為確保時間同步正確,請使用任何可用的服務,在機器上安裝網路時間通訊協定 (NTP) 服務:chrony、systemd-timesyncd、ntp 或 ntpdate。執行 timedatectl,確認系統時鐘已同步。timedatectl 的輸出內容應包含下列狀態:

System clock synchronized: yes

確保 Linux 核心 inotify 限制等於或高於下限

如果機器搭載 Ubuntu 22.04,Linux 核心 inotify 的使用者執行個體和使用者監控上限,必須大於或等於下列值:

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

如要確保節點機器正確設定這些值,請按照下列步驟操作:

  1. 檢查 max_user_instances 的值:

    cat /proc/sys/fs/inotify/max_user_instances
    
  2. 視需要將 max_user_instances 更新為最小值:

    echo 'fs.inotify.max_user_instances=8192' | sudo tee --append /etc/sysctl.conf
    
  3. 檢查 max_user_watches 的值:

    cat /proc/sys/fs/inotify/max_user_watches
    
  4. 視需要將 max_user_watches 更新為最小值:

    echo 'fs.inotify.max_user_watches=524288' | sudo tee --append /etc/sysctl.conf
    
  5. 如果您更新了任一值,請重新啟動機器。