> ## 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 desde GitHub con la CLI

> Vincula un repositorio de GitHub a una app de Square Cloud con squarecloud app deploy, por la GitHub App o un webhook, y lista los deploys de cada push.

`squarecloud app deploy` conecta una aplicación a GitHub para que un push haga su deploy. Hay dos formas de hacerlo:

* **La GitHub App de Square Cloud** (`app deploy github link`): instala la app en tu repositorio y luego vincula el repositorio y una rama.
* **Un webhook** (`app deploy webhook`): proporciona un token de acceso de GitHub y agrega la URL que muestra la CLI a los webhooks de tu repositorio.

El centro de ayuda explica la parte de GitHub: [conecta tu repositorio de GitHub](https://help.squarecloud.app/es/article/como-integrar-tu-repositorio-de-github-y-hacer-deploy-automatico-pfvkxx/), o configura un [deploy automático con GitHub Actions](https://help.squarecloud.app/es/article/workflow-github-actions-deploy-automatico-h2c5n4/).

`[appID]` y `--app` son opcionales: consulta [cómo encuentra la CLI tu aplicación](/es/cli-reference/quickstart#cómo-encuentra-la-cli-tu-aplicación).

## `squarecloud app deploy github link`

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

Vincula un repositorio y una rama a través de la GitHub App de Square Cloud. La app debe estar instalada en el repositorio a través de tu cuenta de GitHub, y tu cuenta de GitHub necesita acceso de escritura a él.

```bash theme={"system"}
squarecloud app deploy github link octocat/hello-world main
# Vincula octocat/hello-world, rama main, a la app de la línea ID=.
```

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

Para vincular otro repositorio u otra rama, desvincula primero el actual.

## `squarecloud app deploy github unlink`

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

Elimina de la aplicación el vínculo con la GitHub App.

## `squarecloud app deploy webhook`

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

| Flag | Descripción |
| - | - |
| `--remove` | Elimina el webhook configurado. No necesita token. |

Crea una integración de deploy por webhook a partir de un token de acceso de GitHub (`ghp_...` o `github_pat_...`) y muestra la URL que debes agregar como webhook en la configuración de tu repositorio.

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

```bash Salida 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]
```

Muestra la integración con Git configurada para la aplicación: el repositorio y la rama vinculados, la URL del webhook, o `No Git integration configured for this application`.

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

## `squarecloud app deploy list`

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

Lista los deploys más recientes iniciados por pushes de Git, una fila por commit, con el último estado de cada uno: los primeros 8 caracteres del commit, su fecha, su estado y la rama.

```bash theme={"system"}
squarecloud app deploy list --json
# Muestra las líneas de tiempo sin procesar: un array de eventos por deploy.
```

## Relacionado

| Comando | API | SDK de JavaScript | VS Code |
| - | - | - | - |
| `github link` | [`POST .../deploy/github-app`](/es/api-reference/endpoint/apps/deploy/github-app-link) | [`api.apps.deploys.linkGithubApp()`](/es/sdks/js/deploys) | [Vincular repositorio de GitHub](/es/vscode-extension/features#aplicaciones) |
| `github unlink` | [`DELETE .../deploy/github-app`](/es/api-reference/endpoint/apps/deploy/github-app-unlink) | [`api.apps.deploys.unlinkGithubApp()`](/es/sdks/js/deploys) | [Desvincular repositorio de GitHub](/es/vscode-extension/features#aplicaciones) |
| `webhook` | [`POST .../deploy/webhook`](/es/api-reference/endpoint/apps/deploy/webhooks) | [`api.apps.deploys.setWebhook()`](/es/sdks/js/deploys) | |
| `current` | [`GET .../deployments/current`](/es/api-reference/endpoint/apps/deploy/info) | [`api.apps.deploys.current()`](/es/sdks/js/deploys) | |
| `list` | [`GET .../deployments`](/es/api-reference/endpoint/apps/deploy/list) | [`api.apps.deploys.list()`](/es/sdks/js/deploys) | |