从 Cloud Run 连接

本页将引导您使用 Google Cloud 控制台和客户端应用，在 Cloud Run 服务上部署示例应用。此示例应用会将 Cloud Run 连接到 AlloyDB for PostgreSQL。

准备工作

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  5. Make sure that billing is enabled for your Google Cloud project.

  6. 启用在 Cloud Run 上运行 AlloyDB for PostgreSQL 示例应用所需的 Cloud API。

    启用 API

    1. 在确认项目步骤中，点击下一步以确认要更改的项目的名称。

    2. 在启用 API 步骤中，点击启用以启用以下各项：

      • AlloyDB API
      • Cloud Run Admin API
      • Compute Engine API
      • Cloud Build API
      • Container Registry API
      • Service Networking API
      • Cloud Resource Manager API

创建集群及其主实例

  1. 在 Google Cloud 控制台中，前往集群页面。

    转到集群

  2. 点击创建集群。

    Google Cloud 控制台会显示可供选择的集群类型。选择高可用性。

  3. 点击继续。

    配置集群部分会展开。

  4. 在基本信息下，在集群 ID 字段中，输入 my-cluster。

  5. 在密码字段中，输入您想要的任意密码。请记下此密码。您稍后将在本快速入门的后续部分中再次使用该 ID。

  6. 在区域字段中，选择 us-central1 (Iowa)。

  7. 在网络下，选择 default。

    如果您尚未设置专用服务访问权限，系统会显示标题为需要专用服务访问通道连接的对话框。

    在需要专用服务访问通道连接对话框中，如需创建专用服务访问通道连接，请完成以下操作：

    1. 点击设置连接。

      系统会显示标签为 Enable Service Networking API（启用 Service Networking API）的新窗格。

    2. 在该窗格中，选择使用自动分配的 IP 范围。

    3. 点击继续。

    4. 点击创建连接，然后等待连接配置完成。

      该窗格会被移除。

  8. 点击继续。

    配置主实例部分会展开。

  9. 在基本信息下，在实例 ID 字段中，输入 my-primary。

  10. 对于机器值，请选择 2 vCPU, 16 GB。

  11. 点击创建集群。

    等待集群创建完成。

连接到您的实例并创建数据库

  1. 如果您当前不在新创建的集群的概览页面中，请在 Google Cloud 控制台中前往集群页面。

    转到集群

  2. 如需显示集群概览页面，请点击 my-cluster 集群名称。

  3. 在导航菜单中，点击 AlloyDB Studio。

  4. 在登录 AlloyDB Studio 页面上的数据库列表中，选择 postgres。

  5. 在用户下拉列表中，选择 postgres。

  6. 在密码字段中，输入您在创建集群及其主实例中创建的密码。

  7. 点击身份验证。探索器窗格会显示数据库中的对象列表。

  8. 在 Editor 1 标签页中，创建一个数据库：

    CREATE DATABASE quickstart_db;

  9. 点击运行。等待 Results 窗格中显示 Statement executed successfully 消息。

查找您的项目 ID

  1. 前往 Google Cloud 控制台中的信息中心页面。

    转到信息中心

  2. 在项目信息卡片上找到项目 ID。

  3. 记下您的项目 ID。您将在本快速入门的后续步骤中用到它。

使用示例应用的映像填充 Artifact Registry

  1. 在 Google Cloud 控制台中，打开 Cloud Shell。

    打开 Cloud Shell

  2. 在 Cloud Shell Editor 中，使用以下命令从 GitHub 克隆包含示例应用代码的代码库：

    cloudshell_open --repo_url \
"https://github.com/GoogleCloudPlatform/alloydb-auth-proxy" \
--dir \
"examples/go" \
--force_new_clone

  3. 在 Artifact Registry 中为 Docker 映像创建代码库：

    gcloud artifacts repositories create cloud-run-source-deploy --location us-central1 --repository-format=docker --project PROJECT_ID

    将 PROJECT_ID 替换为您的项目 ID。

  4. 在为 Cloud Shell 提供授权对话框中，点击授权。如果您之前已完成此步骤，系统不会显示此提示。

  5. 如需构建 Docker 容器并将其发布到 Artifact Registry，请使用以下命令：

     gcloud builds submit --tag  us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy/run-sql --project PROJECT_ID

    将 PROJECT_ID 替换为您的项目 ID。

查找新实例的 IP 地址

  1. 在 Google Cloud 控制台中，前往集群页面。

    转到集群

  2. 在表中找到资源名称为 my-primary 的行。

  3. 记下该行的专用 IP 地址。您将在本快速入门的后续步骤中用到它。

    IP 地址的示例格式为 172.19.209.2:5432。

为 Cloud Run 创建服务

  1. 在 Google Cloud 控制台中，转到 Cloud Run 页面。

    转到 Cloud Run

  2. 在服务标签页中，点击创建服务。

  3. 在容器映像网址字段中，点击选择。

  4. 在选择容器映像窗格中，完成以下步骤：

    1. 选择 Artifact Registry（工件注册库）标签页。
    2. 展开 us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy。
    3. 展开 run-sql。
    4. 选择最新的映像。
    5. 点击选择。

  5. 在服务名称字段中，输入 quickstart-service。

  6. 确保默认情况下在地区列表中选择了 us-central1 (Iowa)。

  7. 在身份验证部分中，选择允许未通过身份验证的调用。

  8. 确保在 CPU 分配和价格部分中选择了仅在请求处理期间分配 CPU。

  9. 展开容器、卷、网络、安全性部分。

  10. 在容器标签页中，选择变量和 Secret 标签页，然后完成以下步骤：

    1. 在环境变量部分中，点击添加变量。

    2. 在 Name 和 Value 字段中输入以下内容：

      • DB_NAME：quickstart_db
      • DB_USER：postgres
      • DB_PASS：您在创建集群及其主实例中创建集群时输入的密码。
      • DB_PORT：5432
      • INSTANCE_HOST：集群的主实例的 IP 地址，您可以在查找新实例的 IP 地址中找到该地址。请勿添加端口号，例如，请将其设置为 172.19.209.2，而不是 172.19.209.2:5432。

  11. 从容器标签页切换到网络标签页，然后完成以下步骤：

    1. 选中连接到 VPC 以获取出站流量复选框。

    2. 选择将流量直接发送到 VPC 选项。

    3. 在网络下拉列表中，选择 default 值。

    4. 在子网下拉列表中，确保选择了 default 值。

  12. 点击创建以创建 Cloud Run 服务。

    部署 Cloud Run 服务后，quickstart-service 页面会在 网址 字段中显示示例应用的网址。

    该应用使用 AlloyDB 作为其数据存储区。

查看示例应用

  1. 在 Google Cloud 控制台中，转到 Cloud Run 页面。

    转到 Cloud Run

  2. 在 quickstart-service 页面上，点击 Copy to clipboard 复制应用网址。

  3. 在新的浏览器标签页中，粘贴复制的应用网址，然后点击 Enter 键。

    系统随即会显示一个投票收集 Web 应用示例，该示例与以下内容类似：

    标签页和聊天室示例应用

清理

为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用，请按照以下步骤操作。

清理集群

  1. 在 Google Cloud 控制台中，前往集群页面。

    转到集群

  2. 在要删除的 my-cluster 集群旁边，点击 操作，然后点击 删除。

  3. 在随即显示的删除集群对话框中，在 my-cluster 字段中输入 my-cluster，确认您要删除该集群。

  4. 点击删除。

清理服务

  1. 在 Google Cloud 控制台中，转到 Cloud Run 页面。

    转到 Cloud Run

  2. 选中 quickstart-service 服务名称旁边的复选框。

  3. 点击 Cloud Run 页面顶部的 删除。

  4. 在随即显示的删除 quickstart-service 对话框中，点击删除进行确认。

后续步骤