Astro Studio
Astro Studio 网页门户 允许你通过网页界面或使用 CLI 命令 连接并管理你的远程托管的 Astro DB 数据库。
在你的 Studio 仪表板,你可以访问账号管理、帮助文章和支持消息控制台等。
访问 Astro Studio 进行注册或登录。
创建新的 Studio 项目
段落标题 创建新的 Studio 项目在 Astro Studio 中有两种方式创建项目:
-
使用 Astro Studio 网页界面从新的或现有的 GitHub 仓库创建。
点击页头中的 “create project” 按钮并按照说明开始操作。Astro Studio 将连接到你的 GitHub 仓库,并为你的项目创建一个新的托管数据库。
-
使用 Astro Studio CLI 从任何本地 Astro 项目创建。你可以运行以下命令开始:
一旦你已经成功登录并链接,你就可以运行所有的 Astro DB 命令来管理你的远程数据库。
查看 Astro DB CLI 参考 获取所有可用命令。
使用 Studio 连接进行部署
段落标题 使用 Studio 连接进行部署你可以使用与你的 Studio 数据库的实时连接来部署你的 Astro DB 项目。这可以在任何使用静态构建或 SSR 适配器 的部署平台上实现。
首先,配置你的构建命令以使用 --remote
标志与 Studio 连接。这个示例将该标志应用到你项目 package.json
中的 "build"
脚本。如果你的部署平台接受构建命令,确保这被设置成 npm run build
。
创建一个 Studio 应用令牌
段落标题 创建一个 Studio 应用令牌你需要创建一个应用令牌来从生产部署访问你的 Studio 数据库。你可以通过导航到 Settings 标签页并选择 Tokens 从你的 Studio 项目仪表板创建一个应用令牌。
复制生成的令牌并在你的部署平台中使用名称 ASTRO_STUDIO_APP_TOKEN
作为环境变量 / 环境秘钥。
设置 GitHub CI Action
段落标题 设置 GitHub CI Action你可以使用 Studio CI 流水线自动推送模式更改到你的 Studio 数据库。每当你合并到 main
时,这将会校验更改是否可以安全地进行,并且都会保持你的配置更新。
按照 GitHub 的文档 在你的仓库中配置一个新的秘钥,名称为 ASTRO_STUDIO_APP_TOKEN
,并将你的 Studio 应用令牌作为秘钥的值。
一旦你的秘钥配置好,就在你的项目的 .github/workflows
目录中创建一个新的 GitHub Actions 工作流文件,将检出仓库和安装 Node.js 作为步骤,并使用 withastro/action-studio
动作来同步模式更改。
该动作会在所有 事件触发器 上运行 astro db verify
,以确保架构更改可以安全地应用。如果你特别添加了 push 触发器,那么该动作会将这些更改推送到你的 Studio 数据库。
这个示例 GitHub Action _studio.yml
在 main
分支更新时推送更改: