AlloyDB クラスタに読み取りプール インスタンスを作成する

このページでは、AlloyDB for PostgreSQL クラスタに読み取りプール インスタンスを作成する方法について説明します。

始める前に

• 使用している Google Cloud プロジェクトで AlloyDB へのアクセスが有効になっている必要があります。
• 使用している Google Cloud プロジェクトで、次のいずれかの IAM ロールが必要です。
  • roles/alloydb.admin（AlloyDB 管理者の IAM 事前定義ロール）
  • roles/owner（オーナーの IAM 基本ロール）
  • roles/editor（編集者の IAM 基本ロール）

  これらのロールが付与されていない場合は、アクセス権を付与するよう組織管理者に依頼してください。

読み取りプール インスタンスを作成する

コンソール

1. Google Cloud コンソールで、[クラスタ] ページに移動します。

   [クラスタ] に移動

2. [リソース名] 列でクラスタをクリックします。

3. [クラスタ内のインスタンス] セクションに移動し、[読み取りプールを追加] をクリックします。

4. 読み取りプール インスタンスを構成します。

   1. [プール インスタンス ID の読み取り] フィールドに、読み取りプール インスタンスの ID を入力します。

   2. [ノード数] フィールドにノード数を入力します。

      読み取りプール インスタンス内のノード数によって、インスタンスの全体的なコンピューティング容量が決まります。

      注: クラスタ内のすべての読み取りプール インスタンスに最大 20 個のノードを設定できます。

   3. 次のいずれかのマシンシリーズを選択します。

      • C4A（Google Axion ベースのマシンシリーズ）
      • N2（x86 ベースのマシンシリーズ）。これがデフォルトのマシンシリーズです。

   4. マシンタイプを選択します。

      • C4A は vCPU 数が 1、4、8、16、32、48、64、72 個のマシンタイプまたはシェイプをサポートしています。
      • N2 は、2、4、8、16、32、64、96、128 のマシンタイプまたはシェイプをサポートしています。

      1 vCPU マシンタイプなど、C4A Axion ベースのマシンシリーズの使用の詳細については、C4A Axion ベースのマシンシリーズを使用する場合の考慮事項をご覧ください。

      1. 省略可: パブリック インターネット経由でアプリケーションとクライアントを接続するには、[パブリック IP 接続] で [パブリック IP を有効にする] をクリックします。パブリック IP を有効にすると、安全な接続を確保するために追加の構成が必要になる場合があります。詳細については、パブリック IP を使用して接続するをご覧ください。

      デフォルトでは、プライベート IP は常に有効になっています。詳細については、プライベート サービス アクセスを有効にするをご覧ください。

      1. 省略可: マネージド接続プールを有効にして使用するには、[マネージド接続プール] の [マネージド接続プールを有効にする] チェックボックスをオンにします。詳細については、マネージド接続プールを構成するをご覧ください。

      2. ネットワーク セキュリティ設定を選択します。データを安全に保つには、AlloyDB コネクタを使用した mTLS 暗号化または SSL 暗号化を使用することをおすすめします。

      セキュリティ設定を変更してもインスタンスは使用できますが、既存の非準拠の接続は切断されます。

   5. 省略可: インスタンスにカスタムフラグを設定します。フラグごとに次の操作を行います。

      1. [高度な構成のオプション] をクリックします。
      2. [データベース フラグを追加] をクリックします。
      3. [新しいデータベース フラグ] リストからフラグを選択します。
      4. フラグの値を指定します。
      5. [完了] をクリックします。

5. [読み取りプールを追加] をクリックします。

gcloud

gcloud CLI を使用するには、Google Cloud CLI をインストールして初期化するか、Cloud Shell を使用します。

gcloud alloydb instances create コマンドを使用して、リードプール インスタンスを作成します。

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --read-pool-node-count=NODE_COUNT \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID

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

• INSTANCE_ID: 作成するインスタンスの ID。先頭は英小文字にします。英小文字、数字、ハイフンを使用できます。

• NODE_COUNT: インスタンスのノードの数1～20 の数値を指定します。クラスタ内の読み取りプール インスタンス全体で 20 個を超えるノードを設定することはできない点に注意してください。

• REGION_ID: インスタンスを配置するリージョン。

• CLUSTER_ID: インスタンスを配置するクラスタの ID。

• CPU_COUNT: インスタンスに必要な vCPU の数。

  • cpu_count または machine_type を指定する必要があります。
  • cpu_count のみが指定されている場合、次の仕様で N2 インスタンスが作成されます。
    • 2: 2 vCPU、16 GB RAM
    • 4: 4 vCPU、32 GB RAM
    • 8: 8 vCPU、64 GB RAM
    • 16: 16 vCPU、128 GB RAM
    • 32: 32 個の vCPU、256 GB の RAM
    • 64: 64 vCPU、512 GB RAM
    • 96: 96 vCPU、768 GB RAM
    • 128: 128 vCPU、864 GB RAM
  • machine_type と cpu_count の両方が指定されている場合、cpu_count の値は machine_type で指定された vCPU の数と一致する必要があります。たとえば、machine_type が n2-highmem-4 の場合は、cpu_count を 4 に設定する必要があります。

• MACHINE_TYPE: インスタンスのマシンタイプ。

  • C4A Axion ベースのマシンシリーズの場合、有効な値は次のとおりです。

    • c4a-highmem-1
    • c4a-highmem-4-lssd
    • c4a-highmem-8-lssd
    • c4a-highmem-16-lssd
    • c4a-highmem-32-lssd
    • c4a-highmem-48-lssd
    • c4a-highmem-64-lssd
    • c4a-highmem-72-lssd
    注: 開発用ワークロードとサンドボックス ワークロードには c4a-highmem-1 マシンのみをデプロイします。

  • N2 マシンシリーズの場合、有効な値は次のとおりです。

    • n2-highmem-2
    • n2-highmem-4
    • n2-highmem-8
    • n2-highmem-16
    • n2-highmem-32
    • n2-highmem-64
    • n2-highmem-96
    • n2-highmem-128

  • machine_type と cpu_count を一緒に使用する場合、cpu_count と machine_type の値は一致している必要があります。たとえば、machine_type が n2-highmem-4 の場合は、cpu_count を 4 に設定する必要があります。

• PROJECT_ID: クラスタが配置されるプロジェクトの ID。

Private Service Connect が有効なクラスタの読み取りプール インスタンスを作成するには、--allowed-psc-projects フラグを追加して、インスタンスへのアクセスを許可するプロジェクト ID または[プロジェクト番号](/resource-manager/docs/creating-managing-projects#identifying_projects)のカンマ区切りリストを設定します（例: my-project-1、12345、my-project-n）。

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID \
 --allowed-psc-projects=ALLOWED_PROJECT_LIST

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

• ALLOWED_PROJECT（省略可）: インスタンスへのアクセスを許可するプロジェクト ID またはプロジェクト番号のカンマ区切りリスト（例: my-project-1、12345、my-project-n）。インスタンスへの接続方法としてクラスタが Private Service Connect を使用している場合は、許可するプロジェクトまたは番号のリストを設定する必要があります。

読み取りプール インスタンスでマネージド接続プールを有効にするには、gcloud alloydb instances create コマンドに --enable-connection-pooling フラグを追加します。

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID \
 --enable-connection-pooling

パブリック IP 対応クラスタの読み取りプール インスタンスを作成するには、--assign-inbound-public-ip=ASSIGN_IPV4 パラメータを追加します。

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID \
 --assign-inbound-public-ip=ASSIGN_IPV4

必要に応じて、64.233.160.0/16 などの CIDR ブロックのカンマ区切りのリストを --authorized-external-networks パラメータに渡して、インスタンスに承認済みの外部ネットワークを設定します。

注: PSC が有効になっているインスタンスの場合は、追加の設定が必要です。詳細については、Private Service Connect を使用してインスタンスに接続するをご覧ください。

次のステップ

• 読み取りプール インスタンスの接続オプションについて学習する。
• インスタンスの詳細情報を表示
• インスタンスをスケーリングする
• インスタンスまたは読み取りプールノードを再起動する
• 読み取りプールクエリのトラブルシューティング
• サイズ設定の推奨事項について。