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

> Collega un repository GitHub a un'app Square Cloud con squarecloud app deploy, tramite la GitHub App o un webhook, ed elenca i deploy avviati da ogni push.

`squarecloud app deploy` collega un'applicazione a GitHub, così un push ne esegue il deploy. Ci sono due modi per farlo:

* **La GitHub App di Square Cloud** (`app deploy github link`): installa l'app sul tuo repository, poi collega il repository e un branch.
* **Un webhook** (`app deploy webhook`): fornisci un token di accesso GitHub e aggiungi l'URL stampato dalla CLI ai webhook del tuo repository.

Il centro assistenza spiega la parte su GitHub: [collega il tuo repository GitHub](https://help.squarecloud.app/en-us/article/how-to-connect-your-github-repository-and-deploy-automatically-mr6srt/) oppure configura un [deploy automatico con GitHub Actions](https://help.squarecloud.app/en-us/article/workflow-github-actions-automated-deploy-ff34mk/).

`[appID]` e `--app` sono facoltativi: vedi [come la CLI trova la tua app](/it/cli-reference/quickstart#come-la-cli-trova-la-tua-app).

## `squarecloud app deploy github link`

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

Collega un repository e un branch tramite la GitHub App di Square Cloud. L'app deve essere installata sul repository tramite il tuo account GitHub, e il tuo account GitHub deve avere accesso in scrittura al repository.

```bash theme={"system"}
squarecloud app deploy github link octocat/hello-world main
# Collega octocat/hello-world, branch main, all'app della riga ID=.
```

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

Per collegare un altro repository o branch, scollega prima quello attuale.

## `squarecloud app deploy github unlink`

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

Rimuove il collegamento della GitHub App dall'applicazione.

## `squarecloud app deploy webhook`

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

| Flag | Descrizione |
| - | - |
| `--remove` | Rimuove il webhook configurato. Non serve alcun token. |

Crea un'integrazione di deploy tramite webhook a partire da un token di accesso GitHub (`ghp_...` o `github_pat_...`) e stampa l'URL da aggiungere come webhook nelle impostazioni del repository.

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

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

## `squarecloud app deploy current`

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

Mostra l'integrazione Git configurata per l'applicazione: il repository e il branch collegati, l'URL del webhook oppure `No Git integration configured for this application`.

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

## `squarecloud app deploy list`

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

Elenca i deploy più recenti avviati da push Git, una riga per commit, con lo stato più recente di ciascuno: i primi 8 caratteri del commit, la data, lo stato e il branch.

```bash theme={"system"}
squarecloud app deploy list --json
# Stampa le cronologie grezze: un array di eventi per ogni deploy.
```

## Correlati

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