将 Data Connect 模拟器用于 CI/CD

Firebase Data Connect 为您提供了一个本地模拟器，用于进行端到端原型设计以及持续集成和持续部署 (CI/CD) 流程：

• Data Connect 模拟器与本地集成式 PGLite 数据库实例互动，让您可以在完全本地的环境中对查询和突变进行原型设计，并测试客户端代码。
• Data Connect 模拟器也可用于非互动式工作。它可让您运行自动化测试，并且适合与 CI/CD 工作流搭配使用。当您的架构稳定且您想要对客户端代码进行原型设计和测试时，此功能非常有用。

本指南比快速入门更详细地介绍了模拟器的安装和使用。

安装 Data Connect 模拟器

在安装 Local Emulator Suite 以使用 Data Connect 模拟器之前，您需要：

• Node.js 版本 18.0 或更高版本。

安装 Firebase CLI 并设置项目目录

注意： 如果您已经按照Firebase Data Connect 使用入门指南中的说明操作，则可以跳过本部分。

1. 按照安装指南安装 Firebase CLI。 请务必定期更新，因为 Data Connect 模拟器正在积极开发中，会不断修复 bug 并推出新功能。

2. 如果您尚未执行此操作，请将当前工作目录初始化为 Firebase 项目，并按照提示指定要使用的产品：

   firebase init

设置或修改 Local Emulator Suite 配置

如果您通过 Firebase VS Code 扩展程序启动了 Data Connect 模拟器，则系统会根据需要为您安装该模拟器。

您可以使用 Firebase CLI 手动安装模拟器以及 Local Emulator Suite 的其他所选组件。此命令会启动配置向导，让您选择所需的模拟器，下载相应的模拟器二进制文件，以及在默认设置不合适时设置模拟器端口。

  firebase init emulators

安装模拟器后，系统将不会执行更新检查，并且在您更新 Firebase CLI 版本之前不会自动进行额外的下载。

选择一个 Firebase 项目

在设置流程中，Firebase CLI 会提示您选择或创建 Firebase 项目。如果您选择已在 Firebase 控制台中设置了 Data Connect 的现有项目，系统会建议您使用之前选择的配置。

设置模拟器

注意： 有关在 Firebase Data Connect VS Code 扩展程序中使用模拟器的信息，请参阅Firebase Data Connect 使用入门。

配置模拟器

运行 firebase init 流程将引导您完成模拟器设置选项。 与 Local Emulator Suite 中的其他模拟器一样，配置参数存储在本地项目文件中。

• 您的 firebase.json 文件包含模拟器端口分配。
  • emulators:ui 键不适用于 Data Connect 模拟器。

使用本地和生产 Data Connect 资源

如果您想确保不影响生产资源，请设置 demo- projectID 或确保您的客户端代码已检测到可连接到模拟器，如后续部分所述。

启动模拟器

如果您以非交互方式运行模拟器（例如，用于 CI/CD 工作流），请使用 exec 选项启动模拟器。

firebase emulators:exec ./path/to/test-script.sh

如果您要在客户端代码中集成预定义的查询和突变，并且专门使用模拟器来测试客户端，则可以使用 start 选项进行交互式工作。您还可以通过 VS Code 扩展程序启动模拟器。

firebase emulators:start

注意： 当您使用 firebase emulators:start 启动模拟器时，系统会自动生成 SDK 代码，就像您运行了 firebase sdk:generate 一样。

对客户端代码进行插桩处理，以便与模拟器通信

按照以下步骤设置您的应用内配置或测试类，以便与 Data Connect 模拟器进行交互。

JavaScript

import { initializeApp } from "firebase/app";
import { connectorConfig } from "@name-of-package";
import { connectDataConnectEmulator, getDataConnect } from 'firebase/data-connect';

// TODO: Replace the following with your app's Firebase project configuration
const firebaseConfig = {
  //...
};

const app = initializeApp(firebaseConfig);

const dataConnect = getDataConnect(app, connectorConfig);
connectDataConnectEmulator(dataConnect, "localhost", 9399);

// Make calls from your app
  

Kotlin Android

val connector = MoviesConnector.instance

// Connect to the emulator on "10.0.2.2:9399"
connector.dataConnect.useEmulator()

// (Alternatively) if you're running your emulator on non-default port:
connector.dataConnect.useEmulator(port = 9999)

// Make calls from your app
  

iOS

let connector = DataConnect.dataConnect(DefaultConnectorClient.connectorConfig)

// Connect to the emulator on "127.0.0.1:9399"
connector.useEmulator()

// (alternatively) if you're running your emulator on non-default port:
connector.useEmulator(port: 9999)

// Make calls from your app
  

使用模拟器进行测试和持续集成

运行容器化 Local Emulator Suite 映像

在典型的 CI 设置中，安装和配置使用容器的 Local Emulator Suite 非常简单。

您需要注意以下几个问题：

• 模拟器二进制文件安装在 ~/.cache/firebase/emulators/ 中并在该目录下缓存。您可能需要将此路径添加到 CI 缓存配置，以免重复下载。
• 如果您的代码库中没有 firebase.json 文件，则必须向 emulators:start 或 emulators:exec 命令添加命令行实参，以指定应启动的模拟器。例如 --only dataconnect。

在多轮测试之间清空数据库

为了在每次运行之间重置测试环境，Firebase 建议：

• 编写专用突变来处理以下情况：
  • 在设置中，使用初始数据填充本地数据库实例。
  • 在拆解中，从测试后数据库实例中删除修改后的数据。

Data Connect 模拟器与生产环境的区别

Data Connect 模拟器可模拟服务器端产品的许多功能。不过，需要注意一些例外情况：

• PGLite 的版本和详细配置可能与生产 Cloud SQL 实例的版本不同。
• 如果您使用模拟器开发 Data Connect 的 pgvector 和 Vertex API 集成，则对 Cloud Vertex API 的调用是直接进行的，而不是通过 Cloud SQL 的 Vertex 集成进行的。不过，系统仍会调用正式版 API，这意味着您必须使用真实的 Firebase 项目，而不能使用 demo- 项目，并且会产生 Vertex API 的费用。