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

# Mit der CLI aus GitHub deployen

> Verknüpfe mit squarecloud app deploy ein GitHub-Repository über die GitHub App oder einen Webhook mit einer App und liste die Deploys jedes Pushs auf.

`squarecloud app deploy` verbindet eine Anwendung mit GitHub, sodass ein Push sie deployt. Dafür gibt es zwei Wege:

* **Die Square Cloud GitHub App** (`app deploy github link`): Installiere die App in deinem Repository und verknüpfe dann das Repository und einen Branch.
* **Ein Webhook** (`app deploy webhook`): Übergib ein GitHub-Zugriffstoken und füge die URL, die die CLI ausgibt, zu den Webhooks deines Repositorys hinzu.

Das Hilfe-Center erklärt die Schritte auf GitHub-Seite: [GitHub-Repository verbinden](https://help.squarecloud.app/en-us/article/how-to-connect-your-github-repository-and-deploy-automatically-mr6srt/) oder einen [automatisierten Deploy mit GitHub Actions](https://help.squarecloud.app/en-us/article/workflow-github-actions-automated-deploy-ff34mk/) einrichten.

`[appID]` und `--app` sind optional: siehe [Wie die CLI deine Anwendung findet](/de/cli-reference/quickstart#wie-die-cli-deine-anwendung-findet).

## `squarecloud app deploy github link`

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

Verknüpft ein Repository und einen Branch über die Square Cloud GitHub App. Die App muss über dein GitHub-Konto im Repository installiert sein, und dein GitHub-Konto benötigt Schreibzugriff darauf.

```bash theme={"system"}
squarecloud app deploy github link octocat/hello-world main
# Verknüpft octocat/hello-world, Branch main, mit der App aus der Zeile ID=.
```

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

Um ein anderes Repository oder einen anderen Branch zu verknüpfen, trenne zuerst die aktuelle Verknüpfung.

## `squarecloud app deploy github unlink`

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

Entfernt die Verknüpfung mit der GitHub App von der Anwendung.

## `squarecloud app deploy webhook`

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

| Flag | Beschreibung |
| - | - |
| `--remove` | Entfernt den eingerichteten Webhook. Kein Token nötig. |

Erstellt aus einem GitHub-Zugriffstoken (`ghp_...` oder `github_pat_...`) eine Deploy-Integration per Webhook und gibt die URL aus, die du in den Einstellungen deines Repositorys als Webhook hinzufügst.

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

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

## `squarecloud app deploy current`

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

Zeigt die für die Anwendung eingerichtete Git-Integration: das verknüpfte Repository und den Branch, die Webhook-URL oder `No Git integration configured for this application`.

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

## `squarecloud app deploy list`

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

Listet die neuesten durch Git-Pushs gestarteten Deploys auf, eine Zeile pro Commit mit dem jeweils letzten Zustand: die ersten 8 Zeichen des Commits, sein Datum, sein Zustand und der Branch.

```bash theme={"system"}
squarecloud app deploy list --json
# Gibt die Rohdaten der Zeitleisten aus: ein Array von Ereignissen pro Deploy.
```

## Siehe auch

| Befehl | API | JavaScript SDK | VS Code |
| - | - | - | - |
| `github link` | [`POST .../deploy/github-app`](/de/api-reference/endpoint/apps/deploy/github-app-link) | [`api.apps.deploys.linkGithubApp()`](/de/sdks/js/deploys) | [GitHub-Repository verknüpfen](/de/vscode-extension/features#anwendungen) |
| `github unlink` | [`DELETE .../deploy/github-app`](/de/api-reference/endpoint/apps/deploy/github-app-unlink) | [`api.apps.deploys.unlinkGithubApp()`](/de/sdks/js/deploys) | [GitHub-Repository trennen](/de/vscode-extension/features#anwendungen) |
| `webhook` | [`POST .../deploy/webhook`](/de/api-reference/endpoint/apps/deploy/webhooks) | [`api.apps.deploys.setWebhook()`](/de/sdks/js/deploys) | |
| `current` | [`GET .../deployments/current`](/de/api-reference/endpoint/apps/deploy/info) | [`api.apps.deploys.current()`](/de/sdks/js/deploys) | |
| `list` | [`GET .../deployments`](/de/api-reference/endpoint/apps/deploy/list) | [`api.apps.deploys.list()`](/de/sdks/js/deploys) | |