> ## 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.

# Deploy pelo GitHub com a CLI

> Vincule um repositório do GitHub a uma aplicação da Square Cloud com squarecloud app deploy, pelo GitHub App ou por webhook, e liste os deploys de cada push.

O `squarecloud app deploy` conecta uma aplicação ao GitHub para que um push faça o deploy dela. Há duas formas de fazer isso:

* **O GitHub App da Square Cloud** (`app deploy github link`): instale o app no seu repositório e depois vincule o repositório e uma branch.
* **Um webhook** (`app deploy webhook`): informe um token de acesso do GitHub e adicione a URL que a CLI imprime aos webhooks do seu repositório.

A central de ajuda mostra o lado do GitHub: [integre seu repositório do GitHub](https://help.squarecloud.app/pt-br/article/como-integrar-seu-repositorio-do-github-e-fazer-deploy-automatico-1nk6gr9/) ou configure um [deploy automático com GitHub Actions](https://help.squarecloud.app/pt-br/article/workflow-github-actions-deploy-automatico-o6c7e2/).

`[appID]` e `--app` são opcionais: veja [como a CLI encontra sua aplicação](/pt-br/cli-reference/quickstart#como-a-cli-encontra-sua-aplicação).

## `squarecloud app deploy github link`

```bash Uso theme={"system"}
squarecloud app deploy github link <owner/repository> <branch> [--app <appID>]
```

Vincula um repositório e uma branch pelo GitHub App da Square Cloud. O app precisa estar instalado no repositório pela sua conta do GitHub, e a sua conta do GitHub precisa ter acesso de escrita a ele.

```bash theme={"system"}
squarecloud app deploy github link octocat/hello-world main
# Vincula octocat/hello-world, branch main, à aplicação da linha ID=.
```

```bash Saída theme={"system"}
✓ Repository octocat/hello-world (branch main) linked successfully
```

Para vincular outro repositório ou outra branch, desvincule o atual antes.

## `squarecloud app deploy github unlink`

```bash Uso theme={"system"}
squarecloud app deploy github unlink [--app <appID>]
```

Remove o vínculo do GitHub App com a aplicação.

## `squarecloud app deploy webhook`

```bash Uso theme={"system"}
squarecloud app deploy webhook <githubToken> [--app <appID>]
squarecloud app deploy webhook --remove [--app <appID>]
```

| Flag | Descrição |
| - | - |
| `--remove` | Remove o webhook configurado. Não precisa de token. |

Cria uma integração de deploy por webhook a partir de um token de acesso do GitHub (`ghp_...` ou `github_pat_...`) e imprime a URL para adicionar como webhook nas configurações do seu repositório.

```bash theme={"system"}
squarecloud app deploy webhook <githubToken> --app <appID>
```

```bash Saída theme={"system"}
✓ Webhook created successfully; add it to your GitHub repository:
  <webhook URL>
```

## `squarecloud app deploy current`

```bash Uso theme={"system"}
squarecloud app deploy current [appID] [--json]
```

Mostra a integração com o Git configurada na aplicação: o repositório e a branch vinculados, a URL do webhook ou `No Git integration configured for this application`.

```bash Saída theme={"system"}
GitHub App: octocat/hello-world (branch main)
```

## `squarecloud app deploy list`

```bash Uso theme={"system"}
squarecloud app deploy list [appID] [--json]
```

Lista os deploys mais recentes iniciados por pushes no Git, uma linha por commit, com o estado mais recente de cada um: os 8 primeiros caracteres do commit, a data, o estado e a branch.

```bash theme={"system"}
squarecloud app deploy list --json
# Imprime as timelines brutas: um array de eventos por deploy.
```

## Relacionados

| Comando | API | SDK JavaScript | VS Code |
| - | - | - | - |
| `github link` | [`POST .../deploy/github-app`](/pt-br/api-reference/endpoint/apps/deploy/github-app-link) | [`api.apps.deploys.linkGithubApp()`](/pt-br/sdks/js/deploys) | [Vincular repositório do GitHub](/pt-br/vscode-extension/features#aplicações) |
| `github unlink` | [`DELETE .../deploy/github-app`](/pt-br/api-reference/endpoint/apps/deploy/github-app-unlink) | [`api.apps.deploys.unlinkGithubApp()`](/pt-br/sdks/js/deploys) | [Desvincular repositório do GitHub](/pt-br/vscode-extension/features#aplicações) |
| `webhook` | [`POST .../deploy/webhook`](/pt-br/api-reference/endpoint/apps/deploy/webhooks) | [`api.apps.deploys.setWebhook()`](/pt-br/sdks/js/deploys) | |
| `current` | [`GET .../deployments/current`](/pt-br/api-reference/endpoint/apps/deploy/info) | [`api.apps.deploys.current()`](/pt-br/sdks/js/deploys) | |
| `list` | [`GET .../deployments`](/pt-br/api-reference/endpoint/apps/deploy/list) | [`api.apps.deploys.list()`](/pt-br/sdks/js/deploys) | |