將應用程式連線至 AlloyDB 資料，並部署至 Cloud Run

1. 總覽

在本程式碼研究室中，我們將示範簡單易用的方法，設定 AlloyDB 並將應用程式連線至該資料庫。這項 L100 級的快速學習課程，可協助您升級開發人員體驗，將進階 AI 應用程式整合至 AlloyDB 提供的複雜資料功能。

建構項目

簡易網頁應用程式。

您將在過程中完成下列事項：

  1. 按一下即可建立 AlloyDB 執行個體和叢集
  2. 建立範例應用程式，連線至這個執行個體並設定資料

應用程式只會連線至您在步驟 1 中設定的資料庫，並在其中建立資料表及插入一筆記錄。

需求條件

  • Chrome 或 Firefox 瀏覽器
  • 啟用計費功能的 Google Cloud 專案。

2. 事前準備

建立專案

  1. 在 Google Cloud 控制台的專案選取器頁面中，選取或建立 Google Cloud 專案。
  2. 確認 Cloud 專案已啟用計費功能。瞭解如何檢查專案是否已啟用計費功能。
  1. 您將使用 Cloud Shell，這是 Google Cloud 中執行的指令列環境。點選 Google Cloud 控制台頂端的「啟用 Cloud Shell」。

「啟用 Cloud Shell」按鈕圖片

  1. 連線至 Cloud Shell 後，請使用下列指令確認您已通過驗證，且專案已設為您的專案 ID：
gcloud auth list
  1. 在 Cloud Shell 中執行下列指令，確認 gcloud 指令知道您的專案。
gcloud config list project
  1. 如果未設定專案，請使用下列指令來設定：
gcloud config set project <YOUR_PROJECT_ID>
  1. 啟用必要的 API：按照這個連結啟用 API。

或者，您也可以使用 gcloud 指令執行這項操作。如要瞭解 gcloud 指令和用法，請參閱說明文件。

3. 資料庫設定

在本實驗室中，我們會使用 AlloyDB 做為測試資料的資料庫。並使用「叢集」保存所有資源，例如資料庫和記錄檔。每個叢集都有一個「主要執行個體」，可做為資料的存取點。資料表會保存實際資料。

我們來建立 AlloyDB 叢集、執行個體和資料表，以便載入測試資料集。

  1. 按一下按鈕，或將下方連結複製到已登入 Google Cloud 控制台使用者的瀏覽器。

  1. 完成這個步驟後，存放區會複製到本機 Cloud Shell 編輯器，您就能從專案資料夾執行下列指令 (請務必確認您位於專案目錄中)：
sh run.sh
  1. 現在請使用 UI (按一下終端機中的連結，或按一下終端機中的「preview on web」連結)。
  2. 輸入專案 ID、叢集和執行個體名稱等詳細資料，即可開始使用。
  3. 在記錄檔捲動時去買杯咖啡吧！您可以在這裡瞭解這項功能幕後的運作方式。

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 的左側窗格中，重新整理資料庫物件，您應該會看到新建立的資料表：

c6365c17d2d49eb7.png

您可以快速查詢，確認插入作業是否成功：

480c24fbd45ba150.png

7. 清除

完成這項試用實驗室後，別忘了刪除 AlloyDB 叢集和執行個體。

這項作業應會清除叢集及其執行個體。

8. 結語

開始使用 AlloyDB 快速輕鬆地設定資料！