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

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

始める前に

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

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

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

Console

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

    [クラスタ] に移動

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

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

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

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

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

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

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

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

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

      • C4A は、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. [Advanced Configuration Options] をクリックします。
      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 \
    --cpu-count=CPU_COUNT \
    --machine-type=MACHINE_TYPE \
    --read-pool-node-count=NODE_COUNT \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID

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

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

  • CPU_COUNT: インスタンスに必要な N2 vCPU の数。デフォルトは 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: このパラメータは、N2 マシンをデプロイする場合に省略可能です。C4A Axion ベースのマシンシリーズ（プレビュー）をデプロイする場合、または C4A マシンと N2 マシン間で移行する場合は、次の値でこのパラメータを選択します。

    MACHINE_TYPE と CPU_COUNT を一緒に使用する場合は、CPU_COUNT と 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

    4 個以上の vCPU で C4A をデプロイするには、接尾辞 lssd を使用して超高速キャッシュを有効にします。

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

    N2 x86 ベースのマシンシリーズの場合は、次の値を使用します。

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

  • NODE_COUNT: インスタンス内のノード数。1～20 の数値を指定します。クラスタ内のすべての読み取りプール インスタンスに 20 個を超えるノードを設定することはできません。

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

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

  • 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 \
            --cpu-count=CPU_COUNT \
            --region=REGION_ID \
            --cluster=CLUSTER_ID \
            --project=PROJECT_ID \
            --allowed-psc-projects=ALLOWED_PROJECT_LIST

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

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

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

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

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

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

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

次のステップ