自訂 AlloyDB Omni 安裝作業

選取文件版本：

本頁說明如何下載、安裝及連線至 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 CLI。
使用 AlloyDB Omni CLI 確認 Linux 電腦已準備好安裝 AlloyDB Omni：
```
sudo alloydb system-check
```
視需要修改系統，直到 system-check 指令的輸出內容傳回檢查成功為止。
選用：如要為 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"
```
使用下列其中一個選項安裝伺服器軟體：

注意： 如要安裝已啟用機器學習 (ML) 功能的 AlloyDB Omni，包括查詢大型語言模型 (LLM) 的功能，請參閱「安裝 AlloyDB Omni with 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 唯讀副本，請參閱「建立唯讀副本」。
如果系統執行 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=# 提示。