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] をクリックし、認証情報で接続します。
スタジオの左側のペインで、データベース オブジェクトを更新すると、新しく作成されたテーブルが表示されます。
このテーブルにクエリを実行して、挿入が正常に完了したことを確認できます。
7. クリーンアップ
このトライアルラボが完了したら、alloyDB クラスタとインスタンスを削除することを忘れないでください。
クラスタとそのインスタンスをクリーンアップする必要があります。