自訂 AlloyDB Omni 安裝作業

選取文件版本： 15.5.2

• 目前版本 (18.4.0)
• 18.4.0
• 18.3.0
• 18.1.0
• 17.10.0
• 17.9.0
• 17.7.0
• 17.5.0
• 16.14.0
• 16.13.0
• 16.11.0
• 16.9.0
• 16.8.0
• 16.3.0
• 15.18.0
• 15.17.0
• 15.15.0
• 15.13.0
• 15.12.0
• 15.7.1
• 15.7.0
• 15.5.5
• 15.5.4
• 15.5.2

注意：使用 AlloyDB Omni 時，您必須遵守與 Google 簽訂的協議，該協議規範 Google Cloud 產品。如果您沒有帳戶，或尚未與 Google 簽訂管理產品的協議，請先完成這些程序，再繼續或下載這項軟體。如要建立帳戶，請前往 Google Cloud 首頁。 Google Cloud Google Cloud Google Cloud

本頁面說明如何下載、安裝及連線至 AlloyDB Omni。如要使用預設設定快速開始使用 AlloyDB Omni，請參閱「在 Debian 或 Ubuntu 上安裝 AlloyDB Omni」。

本文也會說明如何執行下列操作：

• 建立新的磁碟分割區，以最佳化資料儲存空間。
• 設定伺服器。
• 確保與 Debian、Ubuntu 和 RHEL 相容。

事前準備

系統需求

Debian

• 搭載 Debian 或 Ubuntu 等 Debian 系統的虛擬或實體機器。
• 至少 2 個 CPU，採用 x86/AMD64 架構。
• 至少 2 GB 的 RAM。為獲得最佳效能，建議每個 CPU 分配 8 GB 的 RAM。
• 至少 20 GB 的可用儲存空間。
• OS 內不受限制的根目錄存取權。
• Docker 20.10 以上版本。
• Linux 核心版本 4.18 以上。建議使用 5.3 以上版本的核心版本，以獲得最佳效能。
• 已啟用 Linux cgroup v2。

  根據預設，大多數新式 Linux 系統都會啟用 cgroup v2。如要檢查是否已啟用 cgroup v2，請在殼層中執行 stat -fc %T /sys/fs/cgroup/。如果已啟用 cgroup v2，指令輸出會顯示 cgroup2fs。

• 如要與 Vertex AI 整合，您需要環境中提供的 Google Cloud CLI。

• 如要在雲端平台安裝 AlloyDB Omni，建議使用下列執行個體類型：
  • 建議使用 Google Cloud個 n2-highmem 執行個體。
  • 在 Amazon Web Services 上，我們建議使用 R6i 執行個體。
  • 在 Microsoft Azure 上，建議使用 Ebsv5 執行個體。
• 建議您使用專屬 SSD 儲存裝置來儲存資料。如果使用實體裝置，建議直接連接至主機。

RHEL

• 虛擬或實體機器，搭載 Red Hat Enterprise Linux (RHEL) 8 以上版本。如要讓 AlloyDB Omni 的自動記憶體管理功能正常運作，請使用 RHEL 9 以上版本。
• 至少 2 個 CPU，採用 x86/AMD64 架構。
• 至少 2 GB 的 RAM。為獲得最佳效能，建議每個 CPU 分配 8 GB 的 RAM。
• 至少 20 GB 的可用儲存空間。
• OS 內不受限制的根目錄存取權。
• Docker 20.10 以上版本。
• Linux 核心版本 4.18 以上。為獲得最佳效能，建議使用核心版本 5.3 以上。
• 已啟用 Linux cgroup v2。

  根據預設，大多數新式 Linux 系統都會啟用 cgroup v2。如要確認是否已啟用 cgroup v2，請在殼層中執行 stat -fc %T /sys/fs/cgroup/。如果已啟用 cgroup v2，指令輸出會顯示 cgroup2fs。

• 如要與 Vertex AI 整合，您需要環境中提供的 Google Cloud CLI。

• 如要在雲端平台安裝 AlloyDB Omni，建議使用下列執行個體類型：
  • 建議使用 Google Cloud個 n2-highmem 執行個體。
  • 在 Amazon Web Services 上，我們建議使用 R6i 執行個體。
  • 在 Microsoft Azure 上，建議使用 Ebsv5 執行個體。
• 建議您使用專屬 SSD 儲存裝置來儲存資料。如果您使用實體裝置，建議直接將裝置連接至主體機器。

下載並安裝 AlloyDB Omni

注意： 如要安裝最新版本 AlloyDB Omni，請參閱「自訂 AlloyDB Omni 安裝作業」。

1. 安裝 AlloyDB Omni CLI。

2. 使用 AlloyDB Omni CLI，確認 Linux 機器已準備好安裝 AlloyDB Omni：

   sudo alloydb system-check

   視需要修改系統，直到 system-check 指令的輸出內容傳回檢查成功為止。

3. 選用：如要建立新的磁碟分區，供 AlloyDB Omni 用於資料儲存庫，建議使用 ext4 檔案系統，以達到最佳效能。

   1. 如要建立 ext4 檔案系統，請使用下列指令：

      mkfs.ext4 -m 1 -F "$disk_path"

   2. 如要掛接磁碟，請使用下列指令：

      mount --make-shared -o noatime,discard,errors=panic "$disk_path" "$disk_mountpoint"

4. 請使用下列任一方式安裝伺服器軟體：

   注意： 如要安裝 AlloyDB Omni 並啟用機器學習 (ML) 函式，包括查詢大型語言模型 (LLM) 的功能，請參閱「安裝 AlloyDB Omni 並啟用 AlloyDB AI」。

   • 如要將伺服器設為主要執行個體，請執行下列指令：

     sudo alloydb database-server install --data-dir=$(realpath DATA_DIR)

     將 DATA_DIR 替換為本機檔案系統上的目錄，AlloyDB Omni 會將資料、中繼資料和設定檔儲存在該目錄中。如果這個目錄不存在，AlloyDB Omni 會嘗試建立。如未指定這個值，AlloyDB Omni 會預設為 /var/alloydb/main/。

     如要讓 AlloyDB Omni 監聽預設 5432 以外的 TCP 通訊埠連線，請加入 --pg-port 旗標：

     sudo alloydb database-server install \
         --data-dir=$(realpath DATA_DIR) \
         --pg-port=PORT

     將 PORT 替換為您要 AlloyDB Omni 接受連線的 TCP 通訊埠。

   • 如要將伺服器設定為唯讀副本，請加入 --replica-source-ip 和 --replica-source-port 旗標：

     sudo alloydb database-server install \
         --data-dir=$(realpath DATA_DIR) \
         --replica-source-ip=SOURCE_IP \
         --replica-source-port=SOURCE_PORT

     更改下列內容：

     • DATA_DIR：本機檔案系統中的目錄，用於儲存 AlloyDB Omni 的資料、中繼資料和設定檔。如果這個目錄不存在，AlloyDB Omni 會嘗試建立。如未指定這個值，AlloyDB Omni 會預設為 /var/alloydb/main/。

     • SOURCE_IP：要從中複製資料的 AlloyDB Omni 主要執行個體 IP 位址。

     • SOURCE_PORT：主要 AlloyDB Omni 執行個體的 TCP 連接埠，用於複製資料。如未提供這個值，AlloyDB Omni 會套用預設值 5432。

     如要進一步瞭解 AlloyDB Omni 唯讀副本，請參閱「建立唯讀副本」。

5. 如果系統執行 Red Hat Enterprise Linux，請使用下列內容更新 /usr/lib/tuned/virtual-guest/tuned.conf 檔案：

   vm.swappiness=1
   

連線至資料庫伺服器並加以使用

使用 psql 連線至 AlloyDB Omni：

sudo docker exec -it pg-service psql -h localhost -U postgres

終端機視窗會顯示 psql 登入文字，結尾為 postgres=# 提示。