1. 概要
この Codelab では、AlloyDB を設定してアプリケーションを接続する簡単でシンプルな方法について説明します。AlloyDB が提供する高度な AI アプリケーションを高度なデータ機能に統合するデベロッパー エクスペリエンスを向上させるための L100 レベルのクイック学習です。
作成するアプリの概要
シンプルなウェブ アプリケーション。
この一環として、次のことを行います。
- ワンクリック インストールで AlloyDB インスタンスとクラスタを作成する
- このインスタンスに接続してデータを設定するサンプル アプリケーションを作成する
アプリケーションは、ステップ 1 で設定したデータベースに接続し、テーブルを作成して 1 つのレコードを挿入します。
要件
2. 始める前に
プロジェクトを作成する
- Google Cloud コンソールのプロジェクト選択ページで、Google Cloud プロジェクトを選択または作成します。
- Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトで課金が有効になっているかどうかを確認する方法については、こちらをご覧ください。
- Google Cloud 上で動作するコマンドライン環境の Cloud Shell を使用します。Google Cloud コンソールの上部にある「Cloud Shell をアクティブにする」アイコン をクリックします。
![[Cloud Shell をアクティブにする] ボタンの画像](https://codelabs.developers.google.com/static/connect-to-alloydb-on-cloudrun/img/91567e2f55467574.png?hl=ja)
- Cloud Shell に接続したら、次のコマンドを使用して、すでに認証済みであることと、プロジェクトがプロジェクト ID に設定されていることを確認します。
gcloud auth list
- Cloud Shell で次のコマンドを実行して、gcloud コマンドがプロジェクトを認識していることを確認します。
gcloud config list project
- プロジェクトが設定されていない場合は、次のコマンドを使用して設定します。
gcloud config set project <YOUR_PROJECT_ID>
- 必要な API を有効にします。リンクに沿って API を有効にします。
または、gcloud コマンドを使用することもできます。gcloud コマンドとその使用方法については、ドキュメントをご覧ください。
3. データベースの設定
このラボでは、テストデータのデータベースとして AlloyDB を使用します。データベースやログなどのすべてのリソースを保持するためにクラスタを使用します。 各クラスタには、データへのアクセス ポイントを提供するプライマリ インスタンスがあります。 テーブルには実際のデータが格納されます。
テストデータセットを読み込む AlloyDB クラスタ、インスタンス、テーブルを作成しましょう。
- ボタンをクリックするか、Google Cloud コンソール ユーザーがログインしているブラウザに次のリンクをコピーします。
- この手順が完了すると、リポジトリがローカルの Cloud Shell エディタにクローンされます。プロジェクト フォルダから次のコマンドを実行できます（プロジェクト ディレクトリにいることを確認することが重要です）。
sh run.sh
- UI を使用します（ターミナルでリンクをクリックするか、ターミナルで [ウェブでプレビュー] リンクをクリックします）。
- プロジェクト ID、クラスタ名、インスタンス名の詳細を入力して開始します。
- ログがスクロールしている間にコーヒーを飲んでください。舞台裏での処理については、こちらをご覧ください。
4. 接続をテストするサンプル アプリケーションを作成する
Cloud Shell ターミナルで次のコマンドを実行します。
git clone https://github.com/AbiramiSukumaran/verify-easy-alloydb-connection
前のセクションで構成した AlloyDB 設定の verify_connection.py ファイルを変更します。
# Replace this with the Private IP of your AlloyDB Instance
DB_HOST = <<>>
DB_PORT = "5432"
DB_NAME = "postgres"
DB_USER = "postgres"
# Replace this with your actual AlloyDB password
DB_PASS = <<>>
5. Cloud Run にデプロイする
Cloud Shell ターミナルで、メイン フォルダとプロジェクト フォルダ内にあることを確認します 。
プロジェクト フォルダにいることを確認したら、次のコマンドを実行します。
gcloud beta run deploy verify-alloydb \
--source . \
--region=us-central1 \
--network=easy-alloydb-vpc \
--subnet=easy-alloydb-subnet \
--allow-unauthenticated \
--vpc-egress=all-traffic
デプロイが完了すると、次のようなデプロイされた Cloud Run エンドポイントが表示されます。
https://verify-alloydb-**********-uc.a.run.app/
6. デモ
動作していることを確認するには、ブラウザまたはログ エクスプローラで結果を確認します。
Google Cloud コンソールで AlloyDB に移動し、新しく作成したインスタンスを開きます。左側のナビゲーション パネルで [AlloyDB Studio] をクリックし、認証情報で接続します。
Studio の左側のペインで、データベース オブジェクトを更新すると、新しく作成したテーブルが表示されます。
クエリを実行して、挿入が正常に完了したことを確認できます。
7. クリーンアップ
このトライアル ラボが完了したら、alloyDB クラスタとインスタンスを削除してください。
クラスタとそのインスタンスがクリーンアップされます。