このチュートリアルでは、Virtual Private Cloud（VPC）ネットワーク上で AlloyDB インスタンスと Compute Engine VM インスタンスを統合します。次に、Compute Engine VM インスタンスに pgbench をインストールして統合を確認し、このベンチマーク ツールを使用して AlloyDB インスタンスに対するパフォーマンス テストを実施します。
目標
このチュートリアルでは、以下のことを行う方法を学習します。
- AlloyDB インスタンスと Compute Engine VM インスタンスが安全に通信できるようにするため、VPC ネットワークを作成する。
- AlloyDB インスタンスと Compute Engine VM インスタンスを作成し、両方のインスタンスに VPC ネットワークを割り当てて構成する。
- Compute Engine VM インスタンスに
pgbenchをインストールし、AlloyDB インスタンスに対して実行した後、AlloyDB インスタンスのパフォーマンス テストを実施する。
費用
このチュートリアルでは、VPC ネットワーク、AlloyDB、Compute Engine など、 Google Cloudの課金対象コンポーネントを使用します。料金計算ツールを使うと、予想使用量に基づいて費用の見積もりを出すことができます。
始める前に
Google Cloud コンソールのプロジェクト セレクタ ページで、 Google Cloud プロジェクトを選択または作成します。
その Google Cloud プロジェクトで課金が有効になっていることを確認します。プロジェクトで課金が有効になっていることを確認する方法をご覧ください。
VPC ネットワーク、AlloyDB、Compute Engine の API を有効にします。
ユーザー アカウントに AlloyDB 管理者のロールが割り当てられていることを確認します。
VPC ネットワークを作成する
このセクションでは、AlloyDB インスタンスと Compute Engine VM インスタンスが安全に通信するための VPC ネットワークを作成します。
Google Cloud コンソールの [VPC ネットワーク] ページに移動します。
[VPC ネットワークを作成] をクリックします。[VPC ネットワークの作成] ページが開きます。
VPC ネットワークの [名前] として「
my-vpc-network」と入力します。[サブネット作成モード] セクションで [カスタム] オプションを選択します。
[サブネットを追加] をクリックします。
サブネットの [名前] として「
my-subnet」と入力します。[リージョン] を選択し、サブネットの [IP アドレス範囲] を入力します。
[完了] をクリックします。
[作成] をクリックします。
AlloyDB インスタンスを作成する
このセクションでは、AlloyDB インスタンスを作成し、VPC ネットワークを割り当てて構成します。
Google Cloud コンソールで、[クラスタ] ページに移動します。
[クラスタを作成] をクリックします。
次のようにクラスタを構成します。
[基本情報] セクションの [クラスタ ID] フィールドに「
my-cluster」と入力します。[パスワード] フィールドに任意のパスワードを入力します。このパスワードは後で再び使用しますので、メモしておいてください。
[ロケーション] セクションの [リージョン] フィールドで、
us-central1 (Iowa)を選択します。[データベースのバージョン] フィールドはデフォルト値のままにします。
[ネットワーク] メニューから [my-vpc-network] を選択します。この VPC ネットワークは、VPC ネットワークを作成するで作成しました。
VPC ネットワークでプライベート サービス アクセスがまだ初期化されていないため、[接続を設定] をクリックします。
表示された [Create a private service connection] ペインで、次の操作を行います。
ネットワークで自動的に割り振られた IP 範囲が選択されるよう、[自動的に割り振られた IP 範囲を使用する] オプションを選択します。
[続行] をクリックします。
[接続を作成] をクリックします。
プライマリ インスタンスを次のように構成します。
[インスタンス ID] フィールドに、プライマリ インスタンスの ID を入力します。
[ゾーンの可用性] で、次のいずれかのオプションを選択します。
自動フェイルオーバーを備えた高可用性の本番環境インスタンスを作成するには、[複数のゾーン（高可用性）] を選択します。
高可用性が不要である基本的なインスタンスを作成するには、[シングルゾーン] を選択します。
マシンタイプを選択します。
[クラスタを作成] をクリックすると、クラスタとプライマリ インスタンスが作成されます。
[AlloyDB インスタンス] ページに表示された AlloyDB インスタンスのプライベート IP アドレスをメモしておきます。このアドレスは、AlloyDB インスタンスと Compute Engine VM インスタンスの統合を確認するために必要になります。
Compute Engine VM インスタンスを作成する
このセクションでは、Compute Engine VM インスタンスを作成し、インスタンスに VPC ネットワークを割り当てて構成します。
Google Cloud コンソールの [VM インスタンス] ページに移動します。
[インスタンスを作成] をクリックします。
[インスタンスの作成] ページの [名前] フィールドに、作成する Compute Engine VM インスタンスの一意の識別子を入力します。このチュートリアルでは「
my-compute-engine-vm-instance」と入力します。ページの [アクセス スコープ] セクションで、[すべての Cloud API に完全アクセス権を許可] オプションを選択します。
[詳細オプション] を開き、次の操作を行います。
[ネットワーキング] サブタブをクリックします。
[ネットワーク インターフェースを追加] をクリックします。
[ネットワーク] メニューから [my-vpc-network] を選択します。この VPC ネットワークは、VPC ネットワークを作成するで作成しました。
[完了] をクリックします。ページの [ネットワーク インターフェース] セクションに、default と my-vpc-network の 2 つの VPC ネットワークが表示されます。
delete [削除] をクリックして default VPC ネットワークを削除します。
default VPC ネットワークを削除することで、このチュートリアルで作成した VPC ネットワークの使用を Compute Engine VM インスタンスに強制します。
[作成] をクリックします。
Compute Engine VM インスタンスが作成されるまで数秒かかることがあります。作成されると [VM インスタンス] ページにインスタンスが表示され、[実行中] のステータス（チェックマークで示される）になります。
統合を確認する
このセクションでは、Compute Engine VM インスタンスに pgbench をインストールし、AlloyDB インスタンスに対して実行した後、AlloyDB インスタンスのパフォーマンス テストを実施します。
Compute Engine VM インスタンスに接続します。これを行うには、VM インスタンスの右側にある [SSH] メニューをクリックし、[ブラウザ ウィンドウで開く] を選択します。
Contributed Extensions and Additions to PostgreSQL パッケージを Compute Engine VM インスタンスにインストールします。
sudo apt-get -y install postgresql-contrib
pgbench用のデータベースを AlloyDB for PostgreSQL インスタンスで初期化します。たとえば、デフォルトのpostgresデータベースを使用します。pgbench -i --host=INSTANCE_PRIVATE_IP --port=PORT_NUMBER --username=USERNAME
次のように置き換えます。
INSTANCE_PRIVATE_IP: AlloyDB インスタンスのプライベート IP アドレス。この IP アドレスは、インスタンスを作成したときにメモしました。PORT_NUMBER: AlloyDB インスタンス用に予約されたポート番号。このチュートリアルでのポート番号は5432です。USERNAME: AlloyDB インスタンスの管理者ユーザー名。このチュートリアルでのユーザー名はpostgresです。
Passwordプロンプトで、AlloyDB インスタンスのパスワードを入力します。このパスワードは、インスタンスを作成するときに指定した（または、AlloyDB によって生成した）ものです。基本的な機能を確認するために引数なしで
pgbenchを実行します。pgbench --host=INSTANCE_PRIVATE_IP --port=PORT_NUMBER --username=USERNAME
Passwordプロンプトで、AlloyDB インスタンスのパスワードを入力します。出力は次のようになります。
starting vacuum...end. transaction type: <builtin: TPC-B (sort of)> scaling factor: 1 query mode: simple number of clients: 1 number of threads: 1 number of transactions per client: 10 number of transactions actually processed: 10/10 latency average = 3.794 ms tps = 263.560171 (including connections establishing) tps = 345.375423 (excluding connections establishing)
いくつかのオプションを使用して、有用なテストを実施します。重要なオプションには、
-c（クライアント数）と--transactions（クライアントあたりのトランザクション数）があります。このチュートリアルでは、AlloyDB for PostgreSQL データベースにアクセスしている
10個のクライアントについて、各クライアントの100件のトランザクションに対するパフォーマンス テストを実施します。pgbench --host=INSTANCE_PRIVATE_IP --port=PORT_NUMBER --username=USERNAME -c 10 --transactions=100
Passwordプロンプトで、AlloyDB インスタンスのパスワードを入力します。出力は次のようになります。
starting vacuum...end. transaction type:
クリーンアップ
このチュートリアルが終了したら、作成したリソースをクリーンアップして、今後料金が発生しないようにします。
このチュートリアルで使用したリソースについて Google Cloud アカウントに課金されないようにするには、次の操作を行います。
- Google Cloud コンソールを使用して、プロジェクト、AlloyDB インスタンス、Compute Engine VM インスタンス、VPC ネットワークを削除します。
以降のセクションで、これらのリソースを削除または無効にする方法を説明します。
プロジェクトを削除する
課金をなくす最も簡単な方法は、このチュートリアル用に作成したプロジェクトを削除することです。
Google Cloud コンソールの [リソースの管理] ページに移動します。
プロジェクト リストで、削除するプロジェクトを選択し、[削除] をクリックします。
ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックしてプロジェクトを削除します。
AlloyDB インスタンスを削除する
Google Cloud コンソールの [AlloyDB インスタンス] ページに移動します。
AlloyDB インスタンスの名前をクリックします。このチュートリアルでは、[my-instance] をクリックします。
[削除] をクリックします。
ダイアログで、テキスト フィールドに AlloyDB インスタンスの名前を入力し、[削除] をクリックします。
Compute Engine VM インスタンスを削除する
Google Cloud コンソールの [VM インスタンス] ページに移動します。
Compute Engine VM インスタンスの名前をクリックします。このチュートリアルでは、[my-compute-engine-vm-instance] をクリックします。
[削除] アイコンをクリックします。このアイコンはゴミ箱に似ています。
ダイアログで [削除] をクリックします。
VPC ネットワークを削除する
Google Cloud コンソールの [VPC ネットワーク] ページに移動します。
VPC ネットワークの名前をクリックします。このチュートリアルでは、[my-vpc-network] をクリックします。
[VPC ネットワークの削除] をクリックします。
ダイアログで [削除] をクリックします。