> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# squarecloud app deploy

> 管理你在 Square Cloud 上应用程序的部署和 Git 集成。

查看部署历史，并管理两种基于 Git 的 deploy 集成：webhook token 或 Square Cloud GitHub App。对于 `list` 和 `current`，应用 ID 是可选的，CLI 会先从参数中解析，然后是 `squarecloud.app` 配置文件，最后回退到交互式选择器；`webhook` 和 `github link`/`unlink` 则改用 `--app` 传入。

```bash theme={null}
squarecloud app deploy list
# 列出最近的部署记录，每个 commit 对应一行。
```

```bash theme={null}
squarecloud app deploy current <appID>
# 显示该应用当前配置的 Git 集成（如果有）。
```

```bash theme={null}
squarecloud app deploy list --json
# 以 JSON 格式打印原始部署时间线。
```

```bash theme={null}
squarecloud app deploy webhook <githubToken> --app <appID>
# 创建一个 webhook deploy 集成，并打印需要添加到 GitHub 仓库的 URL。
```

```bash theme={null}
squarecloud app deploy webhook --remove --app <appID>
# 移除已配置的 webhook 集成。
```

```bash theme={null}
squarecloud app deploy github link owner/repository main --app <appID>
# 通过 Square Cloud GitHub App 关联一个仓库和分支。
```

```bash theme={null}
squarecloud app deploy github unlink --app <appID>
# 从应用中取消关联 GitHub App 仓库。
```

使用 `squarecloud app deploy --help` 获取有关此命令的更多信息。