制限事項
次の制限が適用されます。
AlloyDB Omni はポート
5432で実行されます。カスタムポートの構成はサポートされていません。クラスタを作成する前に、すべてのデータベース パラメータ構成が正しいことを確認してください。クラスタを作成した後は、データベース パラメータを変更できません。
始める前に
クラスタを作成する前に、次の操作を行います。
オーケストレータ内にプロビジョニングされたすべてのデータベース ノードの PG_DATA_DIR に外部ボリューム（
DataDisk）をマウントする。Ansible の代わりに
alloydbctlを使用する場合は、必要なpolicycoreutils-python-utilsパッケージがすべての VM にインストールされていることを確認してください。このパッケージをインストールするには、次のコマンドを実行します。sudo dnf install policycoreutils-python-utils環境を使用している場合は、
ENVIRONMENT_TYPEをgcpに設定します。 Google Cloud 次に、rootユーザーとしてgcloud auth loginを実行して、gcloud CLI アカウントを認証する必要があります。また、認証されたアカウントには次の権限が必要です。compute.instances.getcompute.instances.listcompute.instances.updateNetworkInterface
クラスタ仕様を準備する
クラスタを作成するには、AlloyDB Omni でクラスタを構成する方法を把握する必要があります。必要な仕様を作成するには、
DBCluster 形式で YAML ファイルを作成します。
Secret:
metadata:
name: db-pw-DBCLUSTER_NAME
spec:
type: Opaque
data:
DBCLUSTER_NAME: BASE64_PASSWORD
---
DBCluster:
metadata:
name: DBCLUSTER_NAME
spec:
databaseVersion: 18.1.0
mode: ""
availability:
numberOfStandbys: NUM_STANDBY_NODES
enableAutoFailover: true
enableAutoHeal: true
autoFailoverTriggerThreshold: AUTOFAILOVER_TRIGGER_THRESHOLD
autoHealTriggerThreshold: AUTOHEAL_TRIGGER_THRESHOLD
healthcheckPeriodSeconds: HEALTHCHECK_PERIOD
replayReplicationSlotsOnStandbys: false
primarySpec:
adminUser:
passwordRef:
name: db-pw-DBCLUSTER_NAME
resources:
cpu: CPU_LIMIT
memory: MEMORY_LIMIT
disks:
- name: DataDisk
path: PG_DATA_DIR
parameters:
max_connections: "MAX_CONNECTIONS"
max_wal_size: "MAX_WAL_SIZE"
max_worker_processes: "MAX_WORKER_PROCESSES"
log_connections: "LOG_CONNECTIONS"
log_disconnections: "LOG_DISCONNECTS"
log_hostname: "LOG_HOSTNAME"
log_statement: "LOG_STATEMENT"
huge_pages: "HUGE_PAGES"
tcp_keepalives_idle: "TCP_KEEPALIVES_IDLE"
tcp_keepalives_interval: "TCP_KEEPALIVES_INTERVAL"
tcp_keepalives_count: "TCP_KEEPALIVES_COUNT"
dbLoadBalancerOptions:
DB_LOAD_BALANCER_TYPE:
loadBalancerIP: "VIRTUAL_IP"
loadBalancerType: "internal"
loadBalancerInterface: "VIRTUAL_IP_INTERFACE"
次の変数を置き換えます。
DBCLUSTER_NAME: データベース クラスタの名前。例:my-dbclusterBASE64_PASSWORD:postgres管理者ユーザーに使用される base64 エンコードされたパスワード。NUM_STANDBY_NODES: クラスタ内のスタンバイ ノードの数。例:2（省略可）
AUTOFAILOVER_TRIGGER_THRESHOLD: フェイルオーバーが発生するまでにヘルスチェックが失敗する回数。デフォルト値は3です。最小値は0ですが、値が0に設定されている場合、AlloyDB Omni はデフォルト値を使用します。ヘルスチェックが
AUTOFAILOVER_TRIGGER_THRESHOLD回失敗した場合、またはヘルスチェックの累積時間がHEALTHCHECK_PERIOD * AUTOFAILOVER_TRIGGER_THRESHOLD秒に達した場合、自動フェイルオーバーが発生します。（省略可）
AUTOHEAL_TRIGGER_THRESHOLD: 自動修復が開始するまでにヘルスチェックが失敗する回数。デフォルト値は3です。最小値は0ですが、値が0に設定されている場合、AlloyDB Omni はデフォルト値を使用します。ヘルスチェックが
AUTOHEAL_TRIGGER_THRESHOLD回失敗した場合、またはヘルスチェックの累積時間がHEALTHCHECK_PERIOD * AUTOHEAL_TRIGGER_THRESHOLD秒に達した場合、自動復旧が発生します。（省略可）
HEALTHCHECK_PERIOD: 次のヘルスチェックまでの待機時間（秒数）。デフォルト値は30です。最小値は1です。最大値は86400（1 日）です。CPU_LIMIT: データベース コンテナに割り当てる CPU の数。例:4MEMORY_LIMIT: データベース コンテナに割り当てるメモリ量。例:32Gi、500MiPG_DATA_DIR: データベース データが保存されるディレクトリのホストパス。（省略可）
MAX_CONNECTIONS: PostgreSQL データベースへの同時接続の最大数。デフォルト値は50です。サポートされている最小値も50です。詳細については、 PostgreSQLmax_connectionsリファレンスをご覧ください。（省略可）
MAX_WAL_SIZE: 自動チェックポイント中にログ先行書き込み（WAL）が増加する最大サイズ。デフォルト値は1GBです。詳細については、 PostgreSQLmax_wal_sizeリファレンスをご覧ください。（省略可）
MAX_WORKER_PROCESSES：単一のGatherまたはGather Mergeで開始できるワーカーの最大数。デフォルト値は64です。詳細については、 PostgreSQLmax_worker_processesリファレンスをご覧ください。（省略可）
LOG_CONNECTIONS: PostgreSQL サーバーへの接続をロギングするかどうかを指定します。 デフォルト値はonです。詳細については、 PostgreSQLlog_connectionsリファレンスをご覧ください。（省略可）
LOG_DISCONNECTS: PostgreSQL セッションの終了をロギングするかどうかを指定します。デフォルト値はonです。詳細については、 PostgreSQLlog_disconnectionsリファレンスをご覧ください。（省略可）
LOG_HOSTNAME: 接続ホストの IP に加えてホスト名をロギングするかどうかを指定します。デフォルト値はonです。詳細については、 the PostgreSQLlog_hostnameリファレンスをご覧ください。（省略可）
LOG_STATEMENT: ロギングする SQL ステートメントを指定します。デフォルト値はnoneです。詳細については、 PostgreSQLlog_statementリファレンスをご覧ください。（省略可）
HUGE_PAGES: メインの共有メモリ領域に巨大ページをリクエストするかどうかを指定します。デフォルト値はoffです。詳細については、 PostgreSQLhuge_pagesリファレンスをご覧ください。（省略可）
TCP_KEEPALIVES_IDLE: OS がクライアントに TCPkeepaliveメッセージを送信しようとするまでの、ネットワーク アクティビティがない時間（秒単位）。デフォルト値は10です。 詳細については、 PostgreSQLtcp_keepalives_idleリファレンスをご覧ください。（省略可）
TCP_KEEPALIVES_INTERVAL: クライアントによって確認応答されていない TCPkeepaliveメッセージを再送信するまでの時間（秒単位）。デフォルト値は10です。詳細については、 PostgreSQLtcp_keepalives_intervalリファレンスをご覧ください。（省略可）
TCP_KEEPALIVES_COUNT: サーバーからクライアントへの接続が非アクティブと見なされるまでに失われる可能性のある TCPkeepaliveメッセージの数。デフォルト値は10です。 詳細については、 PostgreSQLtcp_keepalives_countリファレンスをご覧ください。（省略可）
ENVIRONMENT_TYPE: クラスタが設定される環境（onpremまたはgcp）を指定します。（省略可）
VIRTUAL_IP: ロードバランサで使用される仮想 IP アドレス。dbLoadBalancerOptionsを定義する場合は必須です。詳細については、 高可用性を管理するをご覧ください。（省略可）
VIRTUAL_IP_INTERFACE:VIRTUAL_IPが構成されているネットワーク インターフェース。 デフォルト値はeth0です。
クラスタを作成する
クラスタを作成するには、環境に一致するタブを選択し、手順に沿って操作します。
Ansible
クラスタを作成する手順は次のとおりです。
データベース クラスタ仕様のハンドブックを作成します。
- name: Create DBCluster hosts: localhost vars: ansible_become: true ansible_user: ANSIBLE_USER ansible_ssh_private_key_file: ANSIBLE_SSH_PRIVATE_KEY_FILE roles: - role: google.alloydbomni_orchestrator.bootstrap次の変数を置き換えます。
ANSIBLE_USER: Ansible が AlloyDB Omni ノードにログインするために使用する OS ユーザー。ANSIBLE_SSH_PRIVATE_KEY_FILE: Ansible が SSH を使用して AlloyDB Omni ノードに接続するために使用する秘密鍵。
ハンドブックを実行します。
ansible-playbook DBCLUSTER_PLAYBOOK -i "DEPLOYMENT_SPEC" \ -e resource_spec="DBCLUSTER_SPECIFICATIONS"次の変数を置き換えます。
DBCLUSTER_PLAYBOOK: データベース クラスタ用に作成したハンドブックのパス。DEPLOYMENT_SPEC: AlloyDB Omni コンポーネントをインストールするで作成したデプロイ仕様のパス。DBCLUSTER_SPECIFICATIONS: クラスタ仕様のパス。
alloydbctl
クラスタを作成するには、次のコマンドを実行します。
alloydbctl apply -d "DEPLOYMENT_SPEC" -r "DBCLUSTER_SPECIFICATIONS"次の変数を置き換えます。
DEPLOYMENT_SPEC: AlloyDB Omni コンポーネントをインストールするで作成したデプロイ仕様のパス。DBCLUSTER_SPECIFICATIONS: クラスタ仕様のパス。
クラスタの削除
クラスタを削除するには、環境に一致するタブを選択し、手順に沿って操作します。
Ansible
Ansible を使用してクラスタを削除する手順は次のとおりです。
teardown.yamlという名前のハンドブックを作成します。- name: Tear down AlloyDB Omni cluster hosts: localhost vars: ansible_become: true ansible_user: ANSIBLE_USER ansible_ssh_private_key_file: ANSIBLE_SSH_PRIVATE_KEY_FILE roles: - role: google.alloydbomni_orchestrator.deleteansible-playbookを使用してハンドブックを実行します。resource_typeとしてDBClusterを指定し、削除するクラスタの名前をresource_nameとして指定する必要があります。ansible-playbook -i "DEPLOYMENT_SPEC" teardown.yaml \ -e `resource_type`=`DBCluster` -e `resource_name`="DBCLUSTER_NAME"
クラスタの状態の不整合（ノードに到達できないなど）が原因で削除プロセスが失敗した場合は、コマンドに -e force=true を追加して、クラスタの強制削除を試みることができます。これにより、削除プロセス中のエラーが無視され、できるだけ多くのリソースを削除しようとします。
ansible-playbook -i "DEPLOYMENT_SPEC" teardown.yaml \
-e resource_type=DBCluster -e resource_name="DBCLUSTER_NAME" -e force=true alloydbctl
alloydbctl を使用してクラスタを削除するには、次のコマンドを実行します。
alloydbctl delete -d "DEPLOYMENT_SPEC" \
--resource_type DBCluster --resource_name "DBCLUSTER_NAME"次の変数を置き換えます。
DEPLOYMENT_SPEC: AlloyDB Omni コンポーネントをインストールするで作成したデプロイ仕様のパス。DBCLUSTER_NAME: データベース クラスタの名前。例:my-dbcluster