用 CLI 从 GitHub 部署

squarecloud app deploy 把应用连接到 GitHub，让每次推送都会部署它。有两种方式：

Square Cloud GitHub App（app deploy github link）：在你的仓库上安装该 App，然后关联仓库和分支。
Webhook（app deploy webhook）：提供一个 GitHub 访问令牌，并把 CLI 打印的 URL 添加到仓库的 webhook 中。

帮助中心介绍了 GitHub 端的操作：连接你的 GitHub 仓库，或设置使用 GitHub Actions 自动部署。 [appID] 和 --app 是可选的：参见 CLI 如何找到你的应用。

`squarecloud app deploy github link`

用法

squarecloud app deploy github link <owner/repository> <branch> [--app <appID>]

通过 Square Cloud GitHub App 关联一个仓库和分支。该 App 必须通过你的 GitHub 账户安装在这个仓库上，且你的 GitHub 账户需要拥有该仓库的写入权限。

squarecloud app deploy github link octocat/hello-world main
# 把 octocat/hello-world 的 main 分支关联到 ID= 行中的应用。

输出

✓ Repository octocat/hello-world (branch main) linked successfully

要关联其他仓库或分支，请先取消当前的关联。

用法

squarecloud app deploy github unlink [--app <appID>]

从应用中移除 GitHub App 关联。

用法

squarecloud app deploy webhook <githubToken> [--app <appID>]
squarecloud app deploy webhook --remove [--app <appID>]

标志	说明
`--remove`	移除已配置的 webhook。不需要令牌。

用 GitHub 访问令牌（ghp_... 或 github_pat_...）创建 webhook 部署集成，并打印需要在仓库设置中添加为 webhook 的 URL。

squarecloud app deploy webhook <githubToken> --app <appID>

输出

✓ Webhook created successfully; add it to your GitHub repository:
  <webhook URL>

用法

squarecloud app deploy current [appID] [--json]

显示该应用配置的 Git 集成：已关联的仓库和分支、webhook URL，或 No Git integration configured for this application。

输出

GitHub App: octocat/hello-world (branch main)

用法

squarecloud app deploy list [appID] [--json]

列出由 Git 推送触发的最近部署，每个 commit 一行，并显示每次部署的最新状态：commit 的前 8 个字符、日期、状态和分支。

squarecloud app deploy list --json
# 打印原始时间线：每次部署对应一个事件数组。

命令	API	JavaScript SDK	VS Code
`github link`	`POST .../deploy/github-app`	`api.apps.deploys.linkGithubApp()`	关联 GitHub 仓库
`github unlink`	`DELETE .../deploy/github-app`	`api.apps.deploys.unlinkGithubApp()`	取消关联 GitHub 仓库
`webhook`	`POST .../deploy/webhook`	`api.apps.deploys.setWebhook()`
`current`	`GET .../deployments/current`	`api.apps.deploys.current()`
`list`	`GET .../deployments`	`api.apps.deploys.list()`