Verbinden Sie Ihr Atoms-Projekt mit GitHub, um den Code in einem privaten Repository zu speichern und Änderungen zwischen Atoms und GitHub zu übertragen, ohne Git-Befehle zu verwenden.

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

So funktioniert die Verbindung

Das Verbinden mit GitHub erfolgt in 2 Schritten:

1. Verbinden Sie Ihr GitHub-Konto. Dadurch erhält Atoms die Berechtigung, in Ihrem Namen mit GitHub zu arbeiten.
2. Erstellen Sie ein Repository für Ihr Projekt. Ein Repository ist der private Bereich in GitHub, in dem der Code und der Änderungsverlauf Ihres Projekts gespeichert werden.

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

Bevor Sie beginnen

Bevor Sie Ihr Projekt mit GitHub verbinden, stellen Sie sicher, dass:

• Ihr Atoms-Plan GitHub-Verbindung enthält. Wenn Sie den Free-Plan verwenden, führt die Auswahl von GitHub Sie zur Seite Plans.
• Nur der Arbeitsbereichsinhaber GitHub verbinden oder trennen kann. Wenn Sie ein Editor sind, bitten Sie den Arbeitsbereichsinhaber, diesen Schritt auszuführen.
• Sie ein GitHub-Konto haben oder bereit sind, während der Einrichtung eines zu erstellen.
• Ihr Browser Pop-up-Fenster von Atoms zulässt.
• Derzeit keine Agent an Ihrem Projekt arbeiten.

Sie benötigen kein persönliches GitHub-Zugriffstoken, um Ihr Konto zu verbinden. Fügen Sie niemals GitHub-Token, Passwörter oder andere Zugangsdaten in den Chat ein.

Verbinden Sie Ihr GitHub-Konto

Öffnen Sie den GitHub-Connector

1. Öffnen Sie das Projekt, das Sie verbinden möchten.
2. Klicken Sie oben rechts im Chat-Bereich auf den Projektnamen.
3. Wählen Sie im angezeigten Dropdown-Menü Connectors aus.
4. Suchen Sie in der Liste der verfügbaren Connectors nach Github und klicken Sie auf connect.

Sie können auch Settings → Connectors → GitHub öffnen und Connect auswählen.

Öffnen Sie Settings → Connectors und wählen Sie Connect für GitHub aus.

Autorisieren Sie Atoms in GitHub

Wenn unter Connected Account bereits das GitHub-Konto angezeigt wird, das Sie verwenden möchten, wurde es bereits autorisiert. Sie können mit Create a private repository fortfahren.

1. Atoms öffnet ein GitHub-Autorisierungsfenster. Melden Sie sich bei dem GitHub-Konto an, das Sie verbinden möchten, oder erstellen Sie bei Bedarf ein neues Konto.
2. Prüfen Sie, ob Sie mit dem richtigen GitHub-Konto angemeldet sind.
3. Überprüfen Sie die von Atoms angeforderten Berechtigungen. Wenn Sie zustimmen, wählen Sie Authorize Atoms-Agents aus.
4. Kehren Sie zu Atoms zurück und warten Sie auf die Meldung Connect success.
5. Öffnen Sie in Atoms Connectors und bestätigen Sie, dass Ihr 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 Zugriff hat, 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 keinen Zugriff hat, und Organisationsrichtlinien können zusätzliche Einschränkungen auferlegen.

Überprüfen Sie die GitHub-Berechtigungen und wählen Sie Authorize Atoms-Agents aus.

Erstellen Sie ein privates Repository

Nachdem Sie Ihr GitHub-Konto autorisiert haben, erstellen Sie das private Repository, in dem der Code Ihres Projekts gespeichert wird.

1. Prüfen Sie unter Connected Account, ob der angezeigte Benutzername mit dem GitHub-Konto übereinstimmt, das Sie verwenden möchten.
2. Geben Sie 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ählen Sie Create aus.
4. Warten Sie 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 zu GitHub hochzuladen.

Geben Sie einen Namen ein und erstellen Sie ein neues privates Repository.

Prüfen Sie, ob die Verbindung funktioniert hat

Prüfen Sie die Verbindung sowohl in Atoms als auch in GitHub, bevor Sie sich auf das Repository verlassen.

1. Bestätigen Sie in Atoms, dass unter Repository Status Connected angezeigt wird.
2. Prüfen Sie unter Branches, dass ein Branch mit einem Häkchen markiert ist. Dies ist der Branch, der derzeit mit Ihrem Atoms-Projekt verbunden ist. Wenn Sie GitHub noch nicht kennen, lassen Sie diesen Branch ausgewählt.
3. Wählen Sie View on GitHub aus.
4. Bestätigen Sie 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ählen Sie es aus und warten Sie, bis der Vorgang abgeschlossen ist. Aktualisieren Sie dann die Repository-Seite in GitHub und prüfen Sie, ob die Projektdateien jetzt angezeigt werden.

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

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

Halten Sie Atoms und GitHub synchron

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

Aktion	Verwenden Sie es, wenn	Was passiert
Push Changes	Sie haben Änderungen in Atoms vorgenommen und möchten 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 Sie möchten sie in Atoms übernehmen.	Atoms aktualisiert das Projekt mit den neuesten Änderungen aus GitHub.

Bevor Sie Änderungen pushen oder pullen, warten Sie, bis der Agent fertig ist, und stellen Sie sicher, dass Sie im Chat die neueste Version des Projekts anzeigen. Wenn Sie eine ältere Version aus History geöffnet haben, kehren Sie zur neuesten Versionskarte unten im Chat zurück und öffnen Sie dann GitHub erneut.

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

Prüfen Sie vor der Synchronisierung außerdem, dass der ausgewählte Branch derjenige ist, den Sie aktualisieren möchten.

Wenn sowohl Atoms als auch GitHub Änderungen enthalten, die Sie behalten müssen, synchronisieren Sie sie noch nicht. Speichern Sie zuerst eine Kopie der wichtigen Arbeit oder bitten Sie 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üfen Sie das Repository, bevor Sie eine Aktion auswählen.

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

Änderungen von Atoms zu GitHub pushen

1. Schließen Sie Ihre Änderungen in Atoms ab und warten Sie, bis der Agent nicht mehr arbeitet.
2. Stellen Sie sicher, dass Sie die neueste Version des Projekts anzeigen.
3. Öffnen Sie Settings → Connectors → GitHub und prüfen Sie, dass der richtige Branch ausgewählt ist.
4. Wählen Sie Push Changes aus.
5. Lassen Sie die Seite geöffnet, während die Änderungen gepusht werden.
6. Wenn Changes pushed successfully angezeigt wird, wählen Sie View on GitHub aus und prüfen Sie, 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 Sie eine ältere Version des Projekts anzeigen.

Sobald Sie Push Changes auswählen, 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. Öffnen Sie Settings → Connectors → GitHub.
2. Prüfen Sie, dass unter Repository Status neue Änderungen aus GitHub angezeigt werden und dass der richtige Branch ausgewählt ist.
3. Wählen Sie Pull Updates aus.
4. Lesen Sie die Warnung Pull May Affect Project. Wenn Sie die GitHub-Änderungen in Ihr aktuelles Atoms-Projekt übernehmen möchten, wählen Sie Confirm aus.
5. Lassen Sie die Seite geöffnet, während die Änderungen gepullt werden.
6. Wenn Changes pulled successfully angezeigt wird, öffnen Sie den App-Viewer und testen Sie die von den Änderungen betroffenen Teile Ihres 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

Trennen Sie GitHub, wenn Atoms nicht mehr auf das verbundene Konto zugreifen soll. 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. Prüfen Sie daher Ihre anderen Projekte, bevor Sie fortfahren.

1. Öffnen Sie Settings → Connectors → GitHub.
2. Wählen Sie Disconnect aus.
3. Wählen Sie in der Bestätigung Disconnect GitHub erneut Disconnect aus.
4. GitHub sollte die entsprechende Autorisierungsseite automatisch öffnen. Falls nicht, gehen Sie in GitHub zu Settings → Applications → Authorized OAuth Apps.
5. Suchen Sie Atoms, wählen Sie rechts in der Zeile ... und dann Revoke aus. Wählen Sie nicht Revoke all; diese Aktion entfernt den Zugriff für jede autorisierte OAuth-App, die auf der Seite aufgeführt ist.
6. Führen Sie alle erforderlichen Bestätigungsschritte in Github aus.
7. Kehren Sie zu Atoms zurück und öffnen Sie den GitHub-Connector erneut, um zu bestätigen, dass das Konto nicht mehr verbunden ist.

Wählen Sie Disconnect im GitHub-Connector aus.

Widerrufen Sie in GitHub nur die Atoms-OAuth-Anwendung.