安裝 AlloyDB Omni

選取說明文件版本：

本快速入門導覽課程說明如何安裝 AlloyDB Omni，在支援容器執行階段的任何 UNIX 環境中執行。

如要瞭解 AlloyDB Omni 總覽，請參閱這篇文章。

事前準備

安裝 AlloyDB Omni 前，請確認您符合下列需求。

選擇下載或安裝選項

媒體 下載位置和安裝指南 部署至
Debian 映像檔 DockerHub (標記)
  • Docker、Podman。您可以在任何虛擬機器 (VM) 中，以容器形式執行這些容器化工具。
UBI 映像檔 (Red Hat) Red Hat 生態系統目錄
  • Red Hat 環境。以容器形式執行。

符合軟硬體需求

請確認符合下列最低硬體和軟體需求：

作業系統/平台 最低硬體需求 最低軟體需求
Linux
  • 支援 AVX2 的 x86-64 或 Arm (*) CPU
  • 2 GB RAM
  • 10 GB 磁碟空間
    		•
  • 以 Debian 為基礎的作業系統 (Ubuntu 等)，RHEL 8 或 9
  • Linux 核心 5.3 以上版本
  • 已啟用 Cgroupsv2
  • Docker Engine 20.10 以上版本或 Podman 4.2.0 以上版本
    		•
    macOS
  • 支援 AVX2 的 Intel CPU 或 M 系列晶片
  • 2 GB RAM
  • 10 GB 磁碟空間
    		•
  • Docker Desktop 4.20 以上版本
    		•
    (*) Arm 支援功能處於預先發布階段。

    確認已啟用 cgroupsv2

    如要判斷電腦上是否已啟用 cgroupsv2，請執行下列指令：

    grep cgroup /proc/filesystems

    如果機器支援 cgroupsv2，您會看到下列輸出內容：

    nodev cgroup
nodev cgroupsv2

    如果電腦不支援 cgroupsv2，您會看到下列輸出內容：

    nodev cgroup

    安裝容器執行階段

    安裝容器執行階段，例如 Docker 或 Podman。AlloyDB Omni 會在容器中執行。

    使用 Docker 安裝 AlloyDB Omni

    安裝 AlloyDB Omni 時不需要根存取權。

    Docker

    1. 使用 docker run 指令建立名為 my-omni 的 AlloyDB Omni 新容器：

        docker run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
     -d google/alloydbomni:IMAGE_TAG

      請替換下列變數：

      • NEW_PASSWORD：建立新容器後，要指派給容器 postgres 使用者的密碼。

      • IMAGE_TAG：使用 16.8.0 取得最新版 Debian 映像檔，或使用 16.8.0-ubi 取得最新版 UBI 映像檔。

    2. 使用 psql 連線至容器化 AlloyDB Omni：

        docker exec -it my-omni psql -h localhost -U postgres

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

    Podman

    1. 使用 docker run 指令建立名為 my-omni 的 AlloyDB Omni 新容器：

        podman run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:IMAGE_TAG

      請替換下列變數：

      • NEW_PASSWORD：建立新容器後，要指派給容器 postgres 使用者的密碼。

      • IMAGE_TAG：使用 16.3.0 取得最新版 Debian 映像檔，或使用 16.3.0-ubi 取得最新版 UBI 映像檔。

    2. 使用 psql 連線至容器化 AlloyDB Omni：

      podman exec -it my-omni psql -h localhost -U postgres

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

    清除所用資源

    如要清除在本快速入門導覽課程中建立的 AlloyDB Omni 容器，請按照下列步驟操作：

    Docker

    1. 停止名為 my-omni 的 AlloyDB Omni 容器：

        docker container stop my-omni

    2. 刪除名為 my-omni 的 AlloyDB Omni 容器：

        docker container rm my-omni

    Podman

    1. 停止名為 my-omni 的 AlloyDB Omni 容器：

        podman container stop my-omni

    2. 刪除名為 my-omni 的 AlloyDB Omni 容器：

        podman container rm my-omni

    如需在新的容器中安裝 AlloyDB Omni 以供實際工作環境使用，請前往「自訂 AlloyDB Omni 安裝作業」頁面。

    後續步驟