将应用连接到 AlloyDB 数据并在 Cloud Run 上部署

1. 概览

在此 Codelab 中，我们将演示一种简单易行的方法来设置 AlloyDB 并将应用连接到该数据库。这是一项快速的 L100 级学习，旨在升级开发者体验，将高级 AI 应用集成到 AlloyDB 提供的复杂数据功能中。

构建内容

一个简单的 Web 应用。

在此过程中，您将：

  1. 通过一键安装创建 AlloyDB 实例和集群
  2. 创建用于连接到此实例并设置数据的示例应用

应用将仅连接到您在第 1 步中设置的数据库，并将在其中创建一个表并插入一条记录。

要求

  • 一个浏览器，例如 Chrome 或 Firefox
  • 启用了结算功能的 Google Cloud 项目。

2. 准备工作

创建项目

  1. 在 Google Cloud Console 的项目选择器页面上，选择或创建一个 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. 现在，使用界面（点击终端中的链接或点击终端中的“在网页上预览”链接）。
  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”，然后使用您的凭据进行连接。

在工作室中，刷新左侧窗格中的数据库对象，您应该会看到新创建的表：

c6365c17d2d49eb7.png

您可以快速查询该表，以验证插入操作是否成功完成：

480c24fbd45ba150.png

7. 清理

完成此试用实验后，请务必删除 AlloyDB 集群和实例。

它应清理集群及其实例。

8. 总结

开始使用 AlloyDB 快速轻松地设置数据！