GitHub verbinden

Diese Anleitung erklärt den vollständigen Einrichtungsprozess: das Verbinden deines GitHub-Kontos mit Atoms, das Erstellen des Repositorys, das Bestätigen, dass die Verbindung funktioniert, und das Synchronisieren der Atoms- und GitHub-Versionen deines Projekts.

So funktioniert die Verbindung

Es gibt 2 Phasen, um GitHub zu verbinden:

1. Verbinde dein GitHub-Konto. Dadurch erhält Atoms die Berechtigung, in deinem Namen mit GitHub zu arbeiten.
2. Erstelle ein Repository für dein Projekt. Ein Repository ist der private Bereich in GitHub, in dem der Code und der Änderungsverlauf deines Projekts gespeichert werden.

Atoms erstellt derzeit ein neues privates Repository im persönlichen GitHub-Konto des verbundenen Benutzers. Du kannst keine Verbindung zu einem bestehenden Repository herstellen, das Repository nicht unter einer Organisation erstellen und es über den Connector nicht öffentlich machen.

Bevor du beginnst

Bevor du dein Projekt mit GitHub verbindest, stelle sicher, dass:

• Dein Atoms-Plan GitHub-Verbindung enthält. Wenn du den Free-Plan verwendest, führt dich die Auswahl von GitHub zur Seite Plans.
• Nur der Arbeitsbereichsinhaber GitHub verbinden oder trennen kann. Wenn du ein Editor bist, bitte den Arbeitsbereichsinhaber, diesen Schritt auszuführen.
• Du ein GitHub-Konto hast oder bereit bist, während der Einrichtung eines zu erstellen.
• Dein Browser Pop-up-Fenster von Atoms zulässt.
• Derzeit keine Agents an deinem Projekt arbeiten.

Du benötigst kein persönliches GitHub-Zugriffstoken, um dein Konto zu verbinden. Füge niemals GitHub-Token, Passwörter oder andere Zugangsdaten in den Chat ein.

Verbinde dein GitHub-Konto

Öffne den GitHub-Connector

1. Öffne das Projekt, das du verbinden möchtest.
2. Klicke oben rechts im Chatbereich auf den Projektnamen.
3. Wähle im angezeigten Dropdown-Menü Connectors aus.
4. Suche Github in der Liste der verfügbaren Connectors und klicke auf connect.

Du kannst auch Settings → Connectors → GitHub öffnen und Connect auswählen.

Öffne Settings → Connectors und wähle Connect für GitHub aus.

Atoms in GitHub autorisieren

Wenn unter Connected Account bereits das GitHub-Konto angezeigt wird, das du verwenden möchtest, wurde es bereits autorisiert. Du kannst mit Create a private repository fortfahren.

1. Atoms öffnet ein GitHub-Autorisierungsfenster. Melde dich bei dem GitHub-Konto an, das du verbinden möchtest, oder erstelle bei Bedarf ein neues Konto.
2. Prüfe, dass du beim richtigen GitHub-Konto angemeldet bist.
3. Prüfe die von Atoms angeforderten Berechtigungen. Wenn du zustimmst, wähle Authorize Atoms-Agents.
4. Kehre zu Atoms zurück und warte auf die Meldung Connect success.
5. Öffne in Atoms Connectors und bestätige, dass dein GitHub-Konto als verbunden angezeigt wird.

Atoms fordert die OAuth-Berechtigungen repo, read:user und workflow an. Diese erlauben Atoms, öffentliche und private Repositorys zu lesen und zu schreiben, auf die das verbundene Konto zugreifen kann, grundlegende Profilinformationen zu lesen und Workflow-Dateien für GitHub Actions hinzuzufügen oder zu aktualisieren.

Diese Autorisierung gilt für das verbundene GitHub-Konto und ist nicht auf das für das aktuelle Atoms-Projekt erstellte Repository beschränkt. Atoms kann nicht auf Repositorys zugreifen, auf die das verbundene Konto selbst nicht zugreifen kann, und Organisationsrichtlinien können zusätzliche Einschränkungen auferlegen.

Prüfe die GitHub-Berechtigungen und wähle Authorize Atoms-Agents aus.

Ein privates Repository erstellen

Nachdem du dein GitHub-Konto autorisiert hast, erstelle das private Repository, in dem der Code deines Projekts gespeichert wird.

1. Prüfe unter Connected Account, dass der angezeigte Benutzername mit dem GitHub-Konto übereinstimmt, das du verwenden möchtest.
2. Gib unter Create New Repository einen Namen für das Repository ein. Der Name muss:
   • 1–100 Zeichen enthalten;
   • nur Buchstaben, Zahlen, Bindestriche (-), Unterstriche (_) oder Punkte (.) verwenden.
3. Wähle Create.
4. Warte auf die Meldung GitHub repository connected successfully!.

Atoms erstellt ein neues privates Repository im persönlichen GitHub-Konto des verbundenen Benutzers, verknüpft es mit dem aktuellen Atoms-Projekt und versucht dann, die aktuellen Dateien des Projekts auf GitHub hochzuladen.

Gib einen Namen ein und erstelle ein neues privates Repository.

Prüfen, ob die Verbindung funktioniert hat

Prüfe die Verbindung sowohl in Atoms als auch in GitHub, bevor du dich auf das Repository verlässt.

1. Bestätige in Atoms, dass unter Repository Status Connected angezeigt wird.
2. Prüfe unter Branches, dass ein Branch mit einem Häkchen markiert ist. Dies ist der Branch, der derzeit mit deinem Atoms-Projekt verbunden ist. Wenn du neu bei GitHub bist, lasse diesen Branch ausgewählt.
3. Wähle View on GitHub.
4. Bestätige in GitHub, dass das Repository:
   • zum richtigen GitHub-Konto gehört;
   • als Private markiert ist;
   • die erwarteten Projektdateien enthält; und
   • mindestens einen commit hat.

Wenn das Repository leer ist und Push Changes in Atoms verfügbar ist, wähle es aus und warte, bis der Vorgang abgeschlossen ist. Aktualisiere dann die Repository-Seite in GitHub und prüfe, dass die Projektdateien jetzt angezeigt werden.

Prüfe das verbundene Repository und den ausgewählten Branch in Atoms.

Überprüfe das private Repository und die Projektdateien in GitHub.

Atoms und GitHub synchron halten

Atoms und GitHub bleiben nicht automatisch synchron. Wenn auf einer Seite Änderungen vorgenommen wurden, verwende die Synchronisierungssteuerungen, um diese Änderungen auf die andere Seite zu übertragen.

Action	Verwende dies, wenn	Was passiert
Push Changes	Du hast in Atoms Änderungen vorgenommen und möchtest sie an GitHub senden.	Atoms sendet die aktuellen Projektdateien an den ausgewählten GitHub-Branch.
Pull Updates	Am ausgewählten Branch in GitHub wurden Änderungen vorgenommen und du möchtest sie in Atoms übernehmen.	Atoms aktualisiert das Projekt mit den neuesten Änderungen aus GitHub.

Bevor du Änderungen pushst oder pullst, warte, bis der Agent seine Arbeit beendet hat, und stelle sicher, dass du im Chat die neueste Version des Projekts ansiehst. Wenn du eine ältere Version aus History geöffnet hast, kehre zur neuesten Versionskarte unten im Chat zurück und öffne dann GitHub erneut.

Wenn du nicht auf der neuesten Version bist, zeigt Atoms You must be on the latest version to pull updates or push changes. an.

Prüfe vor dem Synchronisieren außerdem, dass der ausgewählte Branch derjenige ist, den du aktualisieren möchtest.

Wenn sowohl Atoms als auch GitHub Änderungen enthalten, die du behalten musst, synchronisiere sie noch nicht. Speichere zuerst eine Kopie der wichtigen Arbeit oder bitte jemanden, der mit GitHub vertraut ist, die Änderungen in einem separaten Branch zu sichern.

Wenn unter Repository Status Upstream Changes Available angezeigt wird, enthält GitHub Änderungen, die Atoms noch nicht hat. Prüfe das Repository, bevor du eine Aktion auswählst.

Verwende Pull Updates und Push Changes für den ausgewählten Branch.

Änderungen von Atoms nach GitHub pushen

1. Schließe deine Änderungen in Atoms ab und warte, bis der Agent nicht mehr arbeitet.
2. Stelle sicher, dass du die neueste Version des Projekts ansiehst.
3. Öffne Settings → Connectors → GitHub und prüfe, dass der richtige Branch ausgewählt ist.
4. Wähle Push Changes.
5. Lasse die Seite geöffnet, während die Änderungen gepusht werden.
6. Wenn Changes pushed successfully angezeigt wird, wähle View on GitHub und prüfe, dass die neuesten Projektdateien dort vorhanden sind.

Push Changes ist nur verfügbar, wenn Atoms Änderungen hat, die noch nicht an GitHub gesendet wurden. Es ist nicht verfügbar, während der Agent arbeitet oder wenn du eine ältere Version des Projekts ansiehst.

Sobald du Push Changes auswählst, werden die Änderungen sofort an GitHub gesendet, ohne dass eine Bestätigung angefordert wird. Wenn dieselbe Datei sowohl in Atoms als auch in GitHub geändert wurde, hat die Version in Atoms Vorrang und überschreibt die derzeit in GitHub gespeicherte Version.

Updates aus GitHub in Atoms pullen

Anders als beim Pushen erfordert das Pullen von Änderungen zuerst eine Bestätigung. Wenn dieselbe Datei sowohl in GitHub als auch in Atoms geändert wurde, hat die GitHub-Version Vorrang und überschreibt die aktuelle Version in Atoms.

1. Öffne Settings → Connectors → GitHub.
2. Prüfe, dass unter Repository Status neue Änderungen aus GitHub angezeigt werden und dass der richtige Branch ausgewählt ist.
3. Wähle Pull Updates.
4. Lies die Warnung Pull May Affect Project. Wenn du die GitHub-Änderungen in dein aktuelles Atoms-Projekt übernehmen möchtest, wähle Confirm.
5. Lasse die Seite geöffnet, während die Änderungen gepullt werden.
6. Wenn Changes pulled successfully angezeigt wird, öffne den App-Viewer und teste die von den Änderungen betroffenen Teile deines Projekts, um sicherzustellen, dass weiterhin alles wie erwartet funktioniert.

Pull Updates ist nur verfügbar, wenn der ausgewählte GitHub-Branch Änderungen enthält, die noch nicht in Atoms übernommen wurden.

GitHub trennen

Trenne GitHub, wenn du nicht mehr möchtest, dass Atoms auf das verbundene Konto zugreift. Das GitHub-Repository und seine Dateien bleiben in GitHub erhalten, aber Atoms kann keine Änderungen mehr pushen oder pullen.

Die GitHub-Autorisierung gilt für das verbundene Konto. Das Widerrufen des Zugriffs trennt jedes Atoms-Projekt, das dieses GitHub-Konto verwendet, also prüfe deine anderen Projekte, bevor du fortfährst.

1. Öffne Settings → Connectors → GitHub.
2. Wähle Disconnect.
3. Wähle in der Bestätigung Disconnect GitHub erneut Disconnect.
4. GitHub sollte die relevante Autorisierungsseite automatisch öffnen. Falls nicht, gehe in GitHub zu Settings → Applications → Authorized OAuth Apps.
5. Suche Atoms, wähle rechts in seiner Zeile ... und dann Revoke. Wähle nicht Revoke all; diese Aktion entfernt den Zugriff für jede autorisierte OAuth-App, die auf der Seite aufgeführt ist.
6. Folge allen erforderlichen Bestätigungsschritten in Github.
7. Kehre zu Atoms zurück und öffne den GitHub-Connector erneut, um zu bestätigen, dass das Konto nicht mehr verbunden ist.

Wähle Disconnect im GitHub-Connector aus.

Widerrufe nur die Atoms-OAuth-Anwendung in GitHub.