從 AlloyDB Omni 15.5.2 版和更早版本遷移至最新版本

選取文件版本：

從 AlloyDB Omni 15.5.4 開始，您可以使用常見的套件管理工具控制 AlloyDB Omni。

如果您已安裝 AlloyDB Omni，請按照本頁的指示，遷移至新的單一映像檔安裝程序。

必要條件

如要升級至最新版 AlloyDB Omni，請先完成下列先決條件。

升級至 AlloyDB Omni 15.5.2

支援 AlloyDB Omni CLI 的最新 AlloyDB Omni 版本為 15.5.2。 如要檢查 AlloyDB Omni 版本，請執行下列指令：

sudo alloydb version

輸出看起來類似以下內容：

AlloyDB Omni CLI version: 1.6
AlloyDB Omni database server version: 15.5.2

如果輸出內容顯示的資料庫版本早於 15.5.2，請執行下列指令來升級：

sudo alloydb database-server upgrade

收集現有安裝項目的相關資訊

  1. 執行下列指令：

    cat /var/alloydb/config/dataplane.conf

  2. 從 cat 指令的輸出內容中，記下下列變數的值以供參考：

    • DATADIR_PATH，例如 /var/alloydb/main
    • ENABLE_ALLOYDB_AI，例如 FALSE
    • PGPORT，例如 5432
    • INSTANCE_TYPE，例如 PRIMARY/READ_REPLICA

執行直接升級

  1. 停止現有資料庫：

    sudo alloydb database-server stop

  2. 啟動新的單一映像檔 AlloyDB Omni，並掛接先前的現有資料目錄：

    docker run --name CONTAINER_NAME \
    -e POSTGRES_PASSWORD=PASSWORD \
    -e PGDATA=/var/lib/postgresql/data \
    -v /var/alloydb/main/data:/var/lib/postgresql/data \
    -v /dev/shm:/dev/shm \
    -p PGPORT:5432 \
    --network=host \
    --ulimit=nice=-20:-20 \
    --ulimit=core=-1:-1 \
    --log-driver=journald \
    -d google/alloydbomni:15.5.4

    更改下列內容：

    • CONTAINER_NAME：要在主機的容器登錄中指派給這個新 AlloyDB Omni 容器的名稱，例如 my-omni。

    • PASSWORD：新容器的 postgres 使用者在建立後獲派的密碼。

    • PGPORT：AlloyDB Omni 執行的連接埠 IP 位址。這是您在「收集現有安裝作業的相關資訊」的步驟 2 中記下的值。

    docker run 的引數是舊版 AlloyDB Omni 使用的引數，但您可以進一步自訂。詳情請參閱「自訂 AlloyDB Omni 安裝作業」。

  3. 如果資料庫執行個體類型為 PRIMARY，請執行下列指令來建立下列使用者。這些使用者名稱目前未使用，但保留供日後擴充功能使用。

    for name in alloydbagent alloydbexport alloydbiamgroupuser alloydbiamuser alloydbimportexport alloydbobservability alloydbsqllogical alloydbsuperuser; do
  echo docker exec -it CONTAINER_NAME psql -h localhost -U postgres alloydbadmin \
    -c "CREATE ROLE ${name} NOLOGIN;" \
    -c "CREATE TABLE ${name}_table();" \
    -c "ALTER TABLE ${name}_table OWNER TO ${name};"
done

  4. 如果 ENABLE_ALLOYDB_AI 設為 TRUE，請按照「安裝 AlloyDB Omni 和 AlloyDB AI」中的操作說明設定 AlloyDB AI。

  5. 連線至資料庫，確認資料未變更：

    docker exec -it CONTAINER_NAME psql -h localhost -U postgres

  6. 解除安裝 AlloyDB Omni CLI：

    sudo alloydb database-server uninstall

    解除安裝 AlloyDB Omni CLI 不會影響儲存在 AlloyDB Omni 中的資料。