安裝 AlloyDB Omni

選取說明文件版本：

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

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

事前準備

下表列出 AlloyDB Omni 的最低硬體和軟體需求。

作業系統/平台	最低硬體需求	最低軟體需求
Linux	支援 AVX2 的 x86-64 或 Arm (*) CPU 2 GB RAM 10 GB 磁碟空間	以 Debian 為基礎的作業系統 (Ubuntu 等) 或 RHEL 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 支援功能處於預先發布階段。

AlloyDB Omni 會在容器中執行。安裝 AlloyDB Omni 前，請先在電腦上安裝容器執行階段，例如 Docker 或 Podman。

使用 docker run 指令建立名為 my-omni 的 AlloyDB Omni 新容器：
```
  docker run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:15.5.5
```
將 NEW_PASSWORD 替換為密碼，在建立新容器後指派該容器的 postgres 使用者。

注意： 根據預設，AlloyDB Omni 會將資料儲存在容器本身，而非主機檔案系統。刪除 AlloyDB Omni 容器後，資料目錄也會一併刪除。如要掛接儲存在主機檔案系統中的資料目錄，請參閱「自訂 AlloyDB Omni 安裝作業」一文中的操作說明。
使用 psql 連線至容器化 AlloyDB Omni：
```
  docker exec -it my-omni psql -h localhost -U postgres
```
終端機視窗會顯示 psql 登入文字，結尾為 postgres=# 提示。

使用 docker run 指令建立名為 my-omni 的 AlloyDB Omni 新容器：
```
  podman run --name my-omni \
    -e POSTGRES_PASSWORD=NEW_PASSWORD \
    -d google/alloydbomni:15.5.5
```
將 NEW_PASSWORD 替換為密碼，在建立新容器後指派該容器的 postgres 使用者。

注意： 根據預設，AlloyDB Omni 會將資料儲存在容器本身，而非主機檔案系統。刪除 AlloyDB Omni 容器後，資料目錄也會一併刪除。如要掛接儲存在主機檔案系統中的資料目錄，請參閱「自訂 AlloyDB Omni 安裝作業」一文中的操作說明。
使用 psql 連線至容器化 AlloyDB Omni：
```
podman exec -it my-omni psql -h localhost -U postgres
```
終端機視窗會顯示 psql 登入文字，結尾為 postgres=# 提示。

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

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