AlloyDB Omni をインストール

ドキュメントのバージョンを選択してください。

このクイックスタートでは、コンテナ ランタイムをサポートする任意の UNIX ベースの環境で実行できる AlloyDB Omni をインストールする方法について説明します。

AlloyDB Omni の概要については、AlloyDB Omni の概要をご覧ください。

始める前に

AlloyDB Omni をインストールする前に、次の要件を満たしていることを確認してください。

ダウンロード オプションまたはインストール オプションを選択する

メディア ダウンロード場所とインストール ガイド デプロイ先
Debian イメージ DockerHub（タグ）
  • Docker、Podman。これらのコンテナ化ツールは、任意の仮想マシン（VM）でコンテナとして実行できます。
UBI イメージ（Red Hat） Red Hat Ecosystem Catalog
  • Red Hat 環境。これをコンテナとして実行します。

ハードウェアとソフトウェアの要件を満たす

以下のハードウェアとソフトウェアの最小要件を満たしていることを確認してください。

OS / プラットフォーム ハードウェアの最小要件 ソフトウェアの最小要件
Linux
  • AVX2 をサポートする x86-64 または Arm（*）CPU
  • 2 GB の RAM
  • 10 GB のディスク容量
    		•
  • Debian ベースの OS（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 のインストールに root アクセスは必要ありません。

    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: 最新の Debian イメージには 16.8.0、最新の UBI イメージには 16.8.0-ubi を使用します。

    2. psql を使用してコンテナ化された AlloyDB Omni に接続します。

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

      ターミナル ウィンドウに、postgres=# プロンプトで終わる psql ログイン テキストが表示されます。

    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: 最新の Debian イメージには 16.3.0、最新の UBI イメージには 16.3.0-ubi を使用します。

    2. psql を使用してコンテナ化された AlloyDB Omni に接続します。

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

      ターミナル ウィンドウに、postgres=# プロンプトで終わる psql ログイン テキストが表示されます。

    クリーンアップ

    このクイックスタートで作成した 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 のインストールをカスタマイズするをご覧ください。

    次のステップ