每个拉取请求预览数据库
分支是项目的副本,具有自己的 URL 和 API 密钥。在 CI 中为每个拉取请求创建一个,将预览指向它,然后让它过期或在合并时将其删除。
一个 Pull 请求 = 一个数据库#
aura branch create 将 PostgreSQL 项目(架构、行级安全策略、函数、触发器、视图和行)克隆到 新项目 中,并具有自己的 URL 和 API 密钥。拉取请求可以在那里运行其迁移,审阅者可以尝试结果,而不会对源项目产生任何争用。克隆内容和未克隆内容以及限制的完整列表位于 数据库分支中。
分支是创建分支时创建的副本,其时间与数据成正比(本地测试堆栈上的 333 MB 为 14 秒)。它不是写时复制克隆,并且之后不会遵循源。
在 CI 中#
无需安装 GitHub 操作:CLI 即可完成工作。使用个人访问令牌 (aura login --token) 进行身份验证,然后从您测试的项目创建分支并保留预览所需的内容。将每个片段保存为管道的脚本:
aura login --token "$AURA_PAT"
aura branch create "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --ttl 3d --json > branch.json
# Branch.json:id、slug、url、anon_key、service_role_key、expires_at
aura login --token "$AURA_PAT"
aura branch delete "pr-$PR_NUMBER" --from "$AURA_PROJECT_ID" --force
创建分支时,密钥仅打印一次:然后将它们存储在作业中(或作为预览部署的秘密)。要在分支上运行拉取请求的迁移,请将文件夹链接到它并推送: aura link --project-id <branch id> 然后是 aura db push。
aura branch 命令针对本地堆栈运行; aura login --token 是 部署中 CI 配方的登录名。围绕它们的 GitHub 或 GitLab 工作流程由您编写。
分支包含什么#
该分支具有源行(仅针对架构添加 --no-data),包括它们保存的任何个人数据:没有匿名化。如果预览不能看到真实数据,则从暂存项目而不是生产中创建分支。认证用户、存储对象、边缘功能和秘密不会被克隆;将它们播种到您的预览设置中。
TTL 和配额#
默认情况下,分支的生存时间为 72 小时,最多 30 天 (--ttl)。过期的分支会被自动删除,创建失败的分支也会被自动删除。分支不会计入您的项目限制;它计入您计划的活动分支的限制(免费 1 个、专业版 10 个、团队 25 个),请参阅 限制。超过限制, aura branch create 失败并显示 BRANCH_LIMIT_REACHED:删除分支或等待其 TTL。