本番環境用に AlloyDB Omni を設定する

huge page を有効にする

AlloyDB Omni は、PostgreSQL と同様に、huge page の使用をサポートしています。これを行うには、マシンで huge page を有効にする必要があります。また、データベース設定 huge_pages も有効にする必要があります。

1. 提供されたスクリプトを実行して、マシンで huge page を有効にします。

   Docker

   docker run --rm --privileged google/alloydbomni setup-host
   

   Docker

   docker run --rm --privileged google/alloydbomni setup-host
   

   Podman

   podman run --rm --privileged google/alloydbomni setup-host
   

   Podman

   podman run --rm --privileged google/alloydbomni setup-host
   

2. huge page を有効にするには、postgresql.conf に次の行を追加します。

     huge_pages=on
   

スワッピングを有効にする

オペレーティング システムでスワッピングを行うと、アクティブでないメモリページをランダムアクセス メモリ（RAM）とハードディスク間で移動し、アクティブなプロセス用の RAM スペースを解放することで、使用可能な物理メモリを拡張できます。AlloyDB Omni は、負荷が高く、追加のメモリが必要な場合にスワッピングを使用します。

システムで有効になっているスワップ領域の量を確認するには、次のコマンドを実行します。

   cat /proc/meminfo | grep SwapTotal

出力は次のようになります。

   SwapTotal:      165748732 kB

出力値が 0 の場合にオペレーティング システムでスワッピングを有効にするには、以下をご覧ください。

• Debian
• Ubuntu
• Red Hat Enterprise Linux 9

コアダンプを有効にする

AlloyDB Omni で回復不能エラーが発生してクラッシュした場合は、分析用のコアダンプを取得すると役に立ちます。コアダンプは、クラッシュした時点での AlloyDB Omni プロセスのメモリのスナップショットです。

コアダンプを設定するには、次のように kernel.core_pattern を設定します。

1. sysctl コマンドを使用して、ランタイム カーネル パラメータを構成します。

2. kernel.core_pattern を直ちに設定するには、次のコードを使用します。

   sysctl -w kernel.core_pattern="CORE_PATTERN"

   CORE_PATTERN は、コアファイル名のパターン（%e-%t.core など）に置き換えます。

   コアファイル名のパターンの詳細については、プロセスのコアファイル名を設定する方法をご覧ください。

   systemd-coredump ハンドラを使用すると、coredump 設定をさらに構成できます。このツールは RHEL にデフォルトでインストールされています。Debian システムと Ubuntu システムでは、sudo apt install coredumpctl を実行してツールをインストールします。

   AlloyDB Omni を起動するときは、docker run コマンドで --ulimit=core:-1:-1 引数を渡してください。

   Docker

   docker run --name CONTAINER_NAME \
   -e POSTGRES_PASSWORD=NEW_PASSWORD \
   --ulimit=core:-1:-1 \
   -p HOST_PORT:5432 -d google/alloydbomni
   

   Docker

   docker run --name CONTAINER_NAME \
   -e POSTGRES_PASSWORD=NEW_PASSWORD \
   --ulimit=core:-1:-1 \
   -p HOST_PORT:5432 -d google/alloydbomni
   

   Podman

   podman run --name CONTAINER_NAME \
   -e POSTGRES_PASSWORD=NEW_PASSWORD \
   --ulimit=core:-1:-1 \
   -p HOST_PORT:5432 -d google/alloydbomni
   

   Podman

   podman run --name CONTAINER_NAME \
   -e POSTGRES_PASSWORD=NEW_PASSWORD \
   --ulimit=core:-1:-1 \
   -p HOST_PORT:5432 -d google/alloydbomni
   

   次のように置き換えます。

   • CONTAINER_NAME: 新しい AlloyDB Omni コンテナの名前（my-omni-1 など）。
   • NEW_PASSWORD: パスワードの作成後に新しいコンテナの postgres ユーザーに割り当てられるパスワード。

内部ロギングを有効にする

AlloyDB Omni は、通常の PostgreSQL ログに加えて、より多くのメッセージを提供します。これらのメッセージは技術的な性質のものであるため、AlloyDB for PostgreSQL サポートを対象としています。ただし、追加情報はデータベースの問題のデバッグに役立ちます。

内部ロギングを有効にするには、次の操作を行います。

1. データベース パラメータ enable_alloydb_internal_log を on に設定します。

   ALTER SYSTEM SET enable_alloydb_internal_log=on;
   

   AlloyDB Omni の設定変更の詳細については、AlloyDB Omni データベース パラメータを構成するをご覧ください。

2. 再起動して変更を適用します。

   Docker

   docker restart CONTAINER_NAME
   

   Docker

   docker restart CONTAINER_NAME
   

   Podman

   podman restart CONTAINER_NAME
   

   Podman

   podman restart CONTAINER_NAME
   

ログファイル名やローテーション ポリシーの構成など、内部ロギングをさらにカスタマイズするには、PostgreSQL パラメータを使用します。

たとえば、log_directory パラメータはログファイルを保存するディレクトリを指定し、log_filename パラメータは個々のログファイルの名前を定義します。

AlloyDB Omni は、log_directory パラメータと log_filename パラメータを組み合わせて、内部ログを次のように保存します。

LOG_DIRECTORY/LOG_FILENAME.internal

オペレーションを自動的に実行するように systemd ユニットを設定する

AlloyDB Omni を専用サーバーで実行する場合は、サーバーの起動時に特定のオペレーションを自動的に開始するように構成できます。これを行う方法の一つとして、systemd ユニットを使用する方法があります。

たとえば、次の手順では、サーバーが起動するたびに huge page が自動的に有効になるように systemd を構成します。

1. /etc/systemd/system/alloydb-setup-env.service にファイルを作成します。

   [Unit]
   Description=Setup huge pages for AlloyDB Omni
   
   [Service]
   Type=oneshot
   
   ExecStart=/usr/bin/docker run --rm --privileged google/alloydbomni setup-host
   
   [Install]
   WantedBy=multi-user.target
   

2. 次のようにサービスを有効にします。

   sudo systemctl enable alloydb-setup-env.service

次のステップ

• AlloyDB Omni を実行して接続する。

• AlloyDB Omni を管理する。

• 読み取り専用レプリカを作成する。