从 Git 部署

公开仓库

1. 添加服务 → 从 Git → 公开仓库。
2. 粘贴仓库 URL。
3. 选择分支、构建策略（Dockerfile / Compose / 镜像标签），然后点击 部署。

Pier 会使用 gix 克隆、构建并启动服务。

私有仓库

有两种方式：

部署密钥

1. Pier 为该服务生成一对一次性的 SSH 密钥。
2. 将公钥复制到你仓库的 Deploy keys 设置中。
3. Pier 使用私钥进行克隆。

GitHub App

对于仅使用 GitHub 的工作流程，只需安装一次 Pier GitHub App。之后 Pier 即可对所有已连接的仓库拥有读取权限，而无需逐个服务管理密钥。

Webhook

首次部署完成后，Pier 会显示一个 webhook URL。将其添加到你仓库的 webhook 设置中。每次推送时，Pier 会校验签名、拉取、重新构建并重新部署 —— 同时在服务历史中生成一条部署记录。

失败的部署不会替换正在运行的容器。在你排查失败原因期间，上一个版本会保持运行。