Tutorials

How To Connect GitHub To Antigravity: Schritt-für-Schritt-Anleitung

Melden

Die Verknüpfung von GitHub mit Antigravity ermöglicht es Ihnen, Repositories nahtlos zu synchronisieren, automatisierte Workflows zu starten und Deployments direkt über Ihre Code-Basis zu steuern.

In dieser Anleitung erfahren Sie Schritt für Schritt, wie Sie die Autorisierung einrichten und Ihre Projekte erfolgreich verbinden.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes bereitgestellt haben:

  • Ein aktives GitHub-Konto mit Administratorrechten für die Repositories, die Sie verknüpfen möchten.
  • Ein registriertes Antigravity-Konto.
  • Eine stabile Internetverbindung.

Schritt 1: Bei Antigravity anmelden und zu den Integrationen navigieren

  1. Loggen Sie sich in Ihr Antigravity-Dashboard ein.
  2. Navigieren Sie in der linken Seitenleiste oder im Benutzermenü zu den Settings (Einstellungen).
  3. Wählen Sie den Reiter Integrations (Integrationen) oder Connected Services aus.
  4. Suchen Sie nach dem Eintrag GitHub in der Liste der verfügbaren Dienste.

Schritt 2: Den Autorisierungsprozess starten

  1. Klicken Sie neben dem GitHub-Symbol auf die Schaltfläche Connect (Verbinden) oder Authorize.
  2. Sie werden automatisch auf eine Autorisierungsseite von GitHub weitergeleitet.
    • Hinweis: Falls Sie im Browser noch nicht bei GitHub angemeldet sind, werden Sie zunächst aufgefordert, Ihre Zugangsdaten einzugeben.

Schritt 3: GitHub-Berechtigungen festlegen

Auf der GitHub-Bestätigungsseite müssen Sie Antigravity den Zugriff auf Ihre Daten gewähren:

  1. Account wählen: Wählen Sie aus, ob Sie die Verbindung für Ihr persönliches Konto oder eine GitHub-Organisation einrichten möchten.
  2. Repository-Zugriff auswählen:
    • All repositories: Antigravity erhält Zugriff auf alle bestehenden und zukünftigen Repositories.
    • Only select repositories: (Empfohlen) Wählen Sie nur die Repositories aus, die Sie tatsächlich mit Antigravity verwenden möchten.
  3. Klicken Sie auf die grüne Schaltfläche Install & Authorize (bzw. Authorize Antigravity).

Schritt 4: Repository in Antigravity verknüpfen

Nach erfolgreicher Autorisierung leitet GitHub Sie zurück zum Antigravity-Dashboard.

  1. Erstellen Sie ein neues Projekt in Antigravity oder öffnen Sie ein bestehendes.
  2. Gehen Sie auf Source (Quelle) oder Repository Setup.
  3. Wählen Sie im Dropdown-Menü den Provider GitHub aus.
  4. Wählen Sie das gewünschte Repository und den Ziel-Branch (z. B. main oder master) aus.
  5. Speichern Sie die Einstellungen mit einem Klick auf Link Repository oder Save.

Schritt 5: Verbindung testen

Um sicherzustellen, dass die Webhooks und die Verbindung ordnungsgemäß funktionieren:

  1. Nehmen Sie eine kleine Änderung in Ihrem GitHub-Repository vor (z. B. eine Zeile in der README.md bearbeiten) und erstellen Sie einen Commit.
  2. Wechseln Sie zurück zu Antigravity.
  3. Prüfen Sie im Dashboard oder Activity-Log, ob der neue Commit erkannt und der entsprechende Prozess (z. B. Build, Sync oder Deployment) automatisch gestartet wurde.

Fehlerbehebung (Troubleshooting)

  • Repository wird nicht angezeigt: Wenn Sie ein bestimmtes Repository in Antigravity nicht finden, prüfen Sie in den GitHub-Einstellungen unter Settings > Applications > Installed GitHub Apps, ob Antigravity die Leserechte für dieses spezifische Repository besitzt.
  • Organisations-Rechte fehlen: Wenn Sie ein Projekt einer Organisation verknüpfen wollen, muss der Organisations-Admin den Zugriff für Antigravity genehmigen (Request Access).
  • Verbindung trennen und neu aufsetzen: Sollten Synchronisationsprobleme auftreten, entfernen Sie die Integration in den Antigravity-Einstellungen und autorisieren Sie die App auf GitHub erneut.
0