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

# Déployer depuis GitHub avec la CLI

> Liez un dépôt GitHub à une app Square Cloud avec squarecloud app deploy, via la GitHub App ou un webhook, et listez les déploiements lancés par chaque push.

`squarecloud app deploy` connecte une application à GitHub pour qu'un push la déploie. Il existe deux façons de le faire :

* **La GitHub App de Square Cloud** (`app deploy github link`) : installez l'app sur votre dépôt, puis liez le dépôt et une branche.
* **Un webhook** (`app deploy webhook`) : fournissez un jeton d'accès GitHub et ajoutez l'URL affichée par la CLI aux webhooks de votre dépôt.

Le centre d'aide détaille la partie GitHub : [connecter votre dépôt GitHub](https://help.squarecloud.app/en-us/article/how-to-connect-your-github-repository-and-deploy-automatically-mr6srt/), ou mettre en place un [déploiement automatisé avec GitHub Actions](https://help.squarecloud.app/en-us/article/workflow-github-actions-automated-deploy-ff34mk/).

`[appID]` et `--app` sont facultatifs : consultez [comment la CLI trouve votre application](/fr/cli-reference/quickstart#comment-la-cli-trouve-votre-application).

## `squarecloud app deploy github link`

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

Lie un dépôt et une branche via la GitHub App de Square Cloud. L'app doit être installée sur le dépôt depuis votre compte GitHub, et votre compte GitHub doit avoir un accès en écriture au dépôt.

```bash theme={"system"}
squarecloud app deploy github link octocat/hello-world main
# Lie octocat/hello-world, branche main, à l'app de la ligne ID=.
```

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

Pour lier un autre dépôt ou une autre branche, dissociez d'abord le dépôt actuel.

## `squarecloud app deploy github unlink`

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

Retire le lien de la GitHub App de l'application.

## `squarecloud app deploy webhook`

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

| Option | Description |
| - | - |
| `--remove` | Supprime le webhook configuré. Aucun jeton nécessaire. |

Crée une intégration de déploiement par webhook à partir d'un jeton d'accès GitHub (`ghp_...` ou `github_pat_...`) et affiche l'URL à ajouter comme webhook dans les paramètres de votre dépôt.

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

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

## `squarecloud app deploy current`

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

Affiche l'intégration Git configurée pour l'application : le dépôt et la branche liés, l'URL du webhook, ou `No Git integration configured for this application`.

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

## `squarecloud app deploy list`

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

Liste les déploiements les plus récents lancés par des push Git, une ligne par commit, avec le dernier état de chacun : les 8 premiers caractères du commit, sa date, son état et la branche.

```bash theme={"system"}
squarecloud app deploy list --json
# Affiche les chronologies brutes : un tableau d'événements par déploiement.
```

## Voir aussi

| Commande | API | SDK JavaScript | VS Code |
| - | - | - | - |
| `github link` | [`POST .../deploy/github-app`](/fr/api-reference/endpoint/apps/deploy/github-app-link) | [`api.apps.deploys.linkGithubApp()`](/fr/sdks/js/deploys) | [Lier un dépôt GitHub](/fr/vscode-extension/features#applications) |
| `github unlink` | [`DELETE .../deploy/github-app`](/fr/api-reference/endpoint/apps/deploy/github-app-unlink) | [`api.apps.deploys.unlinkGithubApp()`](/fr/sdks/js/deploys) | [Dissocier le dépôt GitHub](/fr/vscode-extension/features#applications) |
| `webhook` | [`POST .../deploy/webhook`](/fr/api-reference/endpoint/apps/deploy/webhooks) | [`api.apps.deploys.setWebhook()`](/fr/sdks/js/deploys) | |
| `current` | [`GET .../deployments/current`](/fr/api-reference/endpoint/apps/deploy/info) | [`api.apps.deploys.current()`](/fr/sdks/js/deploys) | |
| `list` | [`GET .../deployments`](/fr/api-reference/endpoint/apps/deploy/list) | [`api.apps.deploys.list()`](/fr/sdks/js/deploys) | |