Orbit是什么?

Orbit 是 Kapsule 的基于 git 的部署平台: 连接一个仓库, 推送一次提交, 你的应用就会自动构建并在其自己的 URL 上线, 配备免费 SSL 证书, 无需配置服务器也无需编写部署脚本。

使用 Orbit 部署的一切都称为项目。一个项目有生产 URL、完整的部署历史记录(支持一键回滚)、可选的预览和分支预览环境, 以及自己的构建设置、环境变量、域名和边缘函数。

你可以从 KPanel 侧边栏的 Orbit 访问它, 或直接访问 /orbit。

Orbit 为你做什么

• 推送即部署。 推送到生产分支, Orbit 会克隆、安装、构建、打包输出并开始提供服务。大多数项目在几分钟内就能上线。
• 即时回滚。 每次成功构建的工件都会保留。回滚会提升一个已构建的版本, 因此只需几秒钟, 永不重新运行构建。
• 多个环境。 生产环境、可选的预览环境, 以及为你推送的每个分支自动创建的预览环境。
• 构建管道。 从你的 lockfile 自动检测 npm、yarn 和 pnpm。安装命令、构建命令、输出目录、根目录和 Node.js 版本都可以覆盖。
• 免费 SSL, 处处可用。 你的 kaps.run URL 和你附加的每个自定义域名都会自动配置证书。
• 部署锁定和批准。 在事件期间冻结生产, 或要求人工批准每个由推送触发的部署。
• 每个项目的支出上限。 默认上限为 US$63.16 的超额支出(每月), 并在达到 50% 和 80% 时发送电子邮件警告, 防止失控的构建循环产生意外账单。

你的项目 URL

创建项目时, 你选择一个部署 URL 段, Orbit 会在 kaps.run 下给项目一个子域名。一个段为 my-app 的项目会在 my-app.kaps.run 提供服务。

分支预览获得自己的主机名, 由分支名称派生而来, 形式为 branch-<branch-name>.kaps.run。分支名称中的非字母数字字符会变成连字符, 名称会被截断为 48 个字符, 所以一个名为 feat/new-checkout 的分支会在 branch-feat-new-checkout.kaps.run 预览。

你可以随时从项目的域名选项卡附加你自己的域名。参见将自定义域名添加到你的项目。

Git 提供商

Orbit 连接到 GitHub、GitLab 和 Bitbucket。每个提供商每个账户连接一次, 然后可用于任意数量的项目。操作指南:

• 连接 GitHub 仓库
• 连接 GitLab 仓库
• 连接 Bitbucket 仓库

你也可以从起始模板而不是自己的仓库开始一个项目。在新建项目屏幕上, 从导入 Git 仓库切换到从模板开始, 并选择一个预制堆栈(Next.js、Astro、Remix、SvelteKit、Nuxt 3 或 Express REST API)。Orbit 会复制模板并立即部署。

入门指南

1. 点击 KPanel 侧边栏中的 Orbit。
2. 点击新建项目。
3. 连接你的 Git 提供商, 然后选择你想部署的仓库。
4. 填写项目名称和部署 URL。
5. 点击创建项目。你的第一个构建会立即开始, 你会进入项目概览。

在项目中导航

一旦项目存在, 其页面就会沿着项目顶部分组为五个部分:

账户级 Orbit 页面

一些页面位于单个项目之上, 可从 /orbit 的 Orbit 索引上的按钮访问:

• 任务控制(/orbit/mission-control): 一次查看所有项目的实时控制台视图。
• 队列(/orbit/queue): 所有项目中当前正在运行或等待的每个构建。
• 使用情况(/orbit/usage): 账户的构建分钟数和带宽。
• 环境组(/orbit/env-groups): 在多个项目间共享的变量。
• 令牌(/orbit/tokens): 用于 CI/CD 管道的 API 访问令牌。
• 洞察和搜索: 跨项目的构建分析, 以及跨项目和部署的搜索。

计划和限制

Orbit 有三个计划: Launch(永久免费, 无需信用卡)、Liftoff(US$12.00/月)和 Apex(US$30.00/月)。它们在你可以运行的项目数、每个项目可以有的环境数, 以及你的月构建分钟数和带宽方面有所不同。

无限团队席位和商业使用包括在每个计划中, 包括免费计划。拒绝服务攻击产生的流量永不计入你的带宽。

点击 Orbit 索引上的查看计划以比较和切换。完整的细则见Orbit 计划限制。