Verbind je Atoms-project met GitHub om de code in een privérepository te bewaren en wijzigingen tussen Atoms en GitHub te verplaatsen zonder Git-opdrachten te gebruiken.

Deze handleiding legt het volledige installatieproces uit: je GitHub-account verbinden met Atoms, de repository aanmaken, bevestigen dat de verbinding werkt en de Atoms- en GitHub-versies van je project gesynchroniseerd houden.

Hoe de verbinding werkt

Er zijn 2 fasen om GitHub te verbinden:

1. Verbind je GitHub-account. Hiermee krijgt Atoms toestemming om namens jou met GitHub te werken.
2. Maak een repository voor je project aan. Een repository is de privéruimte in GitHub waar de code en wijzigingsgeschiedenis van je project worden opgeslagen.

Atoms maakt momenteel een nieuwe privérepository aan in het persoonlijke GitHub-account van de verbonden gebruiker. Je kunt geen verbinding maken met een bestaande repository, de repository onder een organisatie aanmaken of deze via de connector openbaar maken.

Voordat je begint

Voordat je je project met GitHub verbindt, controleer of:

• Je Atoms-plan GitHub-verbinding bevat. Als je het Free-plan gebruikt, brengt het selecteren van GitHub je naar de pagina Plans.
• Alleen de eigenaar van de werkruimte GitHub kan verbinden of loskoppelen. Als je een editor bent, vraag dan de eigenaar van de werkruimte om deze stap uit te voeren.
• Je een GitHub-account hebt of er klaar voor bent er tijdens de installatie een aan te maken.
• Je browser pop-upvensters van Atoms toestaat.
• Er momenteel geen Agents aan je project werken.

Je hebt geen GitHub personal access token nodig om je account te verbinden. Plak GitHub-tokens, wachtwoorden of andere inloggegevens nooit in Chat.

Verbind je GitHub-account

Open de GitHub-connector

1. Open het project dat je wilt verbinden.
2. Klik op de projectnaam rechtsboven in het chatpaneel.
3. Selecteer Connectors in het vervolgkeuzemenu dat verschijnt.
4. Zoek Github in de lijst met beschikbare connectors en klik op connect.

Je kunt ook Settings → Connectors → GitHub openen en Connect selecteren.

Open Settings → Connectors en selecteer Connect voor GitHub.

Autoriseer Atoms in GitHub

Als Connected Account al het GitHub-account toont dat je wilt gebruiken, is het al geautoriseerd. Je kunt doorgaan naar Create a private repository.

1. Atoms opent een GitHub-autorisatievenster. Meld je aan bij het GitHub-account waarmee je verbinding wilt maken, of maak indien nodig een nieuw account aan.
2. Controleer of je bent aangemeld bij het juiste GitHub-account.
3. Controleer de machtigingen die door Atoms worden gevraagd. Als je akkoord gaat, selecteer dan Authorize Atoms-Agents.
4. Ga terug naar Atoms en wacht op het bericht Connect success.
5. Open in Atoms Connectors en bevestig dat je GitHub-account als verbonden wordt weergegeven.

Atoms vraagt de OAuth-machtigingen repo, read:user en workflow aan. Hiermee kan Atoms openbare en privérepositories lezen en schrijven waartoe het verbonden account toegang heeft, basisprofielinformatie lezen en workflowbestanden van GitHub Actions toevoegen of bijwerken.

Deze autorisatie geldt voor het verbonden GitHub-account en is niet beperkt tot de repository die voor het huidige Atoms-project is aangemaakt. Atoms heeft geen toegang tot repositories waartoe het verbonden account zelf geen toegang heeft, en organisatiebeleid kan aanvullende beperkingen opleggen.

Controleer GitHub-machtigingen en selecteer Authorize Atoms-Agents.

Maak een privérepository aan

Na het autoriseren van je GitHub-account maak je de privérepository aan waarin de code van je project wordt opgeslagen.

1. Controleer onder Connected Account of de weergegeven gebruikersnaam overeenkomt met het GitHub-account dat je wilt gebruiken.
2. Voer onder Create New Repository een naam in voor de repository. De naam moet:
   • 1–100 tekens bevatten;
   • alleen letters, cijfers, koppeltekens (-), underscores (_) of punten (.) gebruiken.
3. Selecteer Create.
4. Wacht op het bericht GitHub repository connected successfully!.

Atoms maakt een nieuwe privérepository aan in het persoonlijke GitHub-account van de verbonden gebruiker, koppelt deze aan het huidige Atoms-project en probeert vervolgens de huidige bestanden van het project naar GitHub te uploaden.

Voer een naam in en maak een nieuwe privérepository aan.

Controleer of de verbinding werkt

Controleer de verbinding in zowel Atoms als GitHub voordat je op de repository vertrouwt.

1. Bevestig in Atoms dat Repository Status Connected toont.
2. Controleer onder Branches of één branch een vinkje heeft. Dit is de branch die momenteel met je Atoms-project is verbonden. Als je nieuw bent met GitHub, laat deze branch dan geselecteerd.
3. Selecteer View on GitHub.
4. Bevestig in GitHub dat de repository:
   • bij het juiste GitHub-account hoort;
   • is gemarkeerd als Private;
   • de verwachte projectbestanden bevat; en
   • minstens één commit heeft.

Als de repository leeg is en Push Changes beschikbaar is in Atoms, selecteer dit dan en wacht tot de bewerking is voltooid. Vernieuw daarna de repositorypagina in GitHub en controleer of de projectbestanden nu worden weergegeven.

Controleer de verbonden repository en geselecteerde branch in Atoms.

Controleer de privérepository en projectbestanden in GitHub.

Houd Atoms en GitHub gesynchroniseerd

Atoms en GitHub blijven niet automatisch gesynchroniseerd. Wanneer aan één kant wijzigingen zijn aangebracht, gebruik je de synchronisatieopties om die wijzigingen naar de andere kant te verplaatsen.

Actie	Gebruik dit wanneer	Wat er gebeurt
Push Changes	Je hebt wijzigingen aangebracht in Atoms en wilt deze naar GitHub sturen.	Atoms stuurt de huidige projectbestanden naar de geselecteerde GitHub-branch.
Pull Updates	Er zijn wijzigingen aangebracht in de geselecteerde branch in GitHub en je wilt deze naar Atoms halen.	Atoms werkt het project bij met de nieuwste wijzigingen uit GitHub.

Voordat je wijzigingen pusht of pullt, wacht je tot de Agent klaar is en controleer je of je de nieuwste versie van het project in Chat bekijkt. Als je een oudere versie hebt geopend vanuit History, ga dan terug naar de kaart met de nieuwste versie onderaan de Chat en open daarna GitHub opnieuw.

Als je niet op de nieuwste versie zit, toont Atoms You must be on the latest version to pull updates or push changes.

Controleer vóór het synchroniseren ook of de geselecteerde branch degene is die je wilt bijwerken.

Als zowel Atoms als GitHub wijzigingen bevatten die je wilt behouden, synchroniseer ze dan nog niet. Sla eerst een kopie van het belangrijke werk op, of vraag iemand die bekend is met GitHub om de wijzigingen op een aparte branch te bewaren.

Als Repository Status Upstream Changes Available toont, bevat GitHub wijzigingen die Atoms nog niet heeft. Controleer de repository voordat je een actie kiest.

Gebruik Pull Updates en Push Changes voor de geselecteerde branch.

Push wijzigingen van Atoms naar GitHub

1. Rond je wijzigingen in Atoms af en wacht tot de Agent stopt met werken.
2. Zorg ervoor dat je de nieuwste versie van het project bekijkt.
3. Open Settings → Connectors → GitHub en controleer of de juiste branch is geselecteerd.
4. Selecteer Push Changes.
5. Houd de pagina open terwijl de wijzigingen worden gepusht.
6. Wanneer Changes pushed successfully verschijnt, selecteer je View on GitHub en controleer je of de nieuwste projectbestanden daar staan.

Push Changes is alleen beschikbaar wanneer Atoms wijzigingen heeft die nog niet naar GitHub zijn verzonden. Het is niet beschikbaar terwijl de Agent werkt of wanneer je een oudere versie van het project bekijkt.

Zodra je Push Changes selecteert, worden de wijzigingen onmiddellijk naar GitHub verzonden zonder om bevestiging te vragen. Als hetzelfde bestand zowel in Atoms als in GitHub is gewijzigd, krijgt de versie in Atoms voorrang en overschrijft deze de versie die momenteel in GitHub is opgeslagen.

Pull updates van GitHub naar Atoms

In tegenstelling tot pushen vereist het pullen van wijzigingen eerst bevestiging. Als hetzelfde bestand zowel in GitHub als in Atoms is gewijzigd, krijgt de GitHub-versie voorrang en overschrijft deze de huidige versie in Atoms.

1. Open Settings → Connectors → GitHub.
2. Controleer of Repository Status nieuwe wijzigingen uit GitHub toont en of de juiste branch is geselecteerd.
3. Selecteer Pull Updates.
4. Lees de waarschuwing Pull May Affect Project. Als je de GitHub-wijzigingen naar je huidige Atoms-project wilt halen, selecteer dan Confirm.
5. Houd de pagina open terwijl de wijzigingen worden gepulld.
6. Wanneer Changes pulled successfully verschijnt, open je de App Viewer en test je de delen van je project die door de wijzigingen zijn beïnvloed om te controleren of alles nog werkt zoals verwacht.

Pull Updates is alleen beschikbaar wanneer de geselecteerde GitHub-branch wijzigingen bevat die nog niet naar Atoms zijn gehaald.

GitHub loskoppelen

Koppel GitHub los wanneer je niet langer wilt dat Atoms toegang heeft tot het verbonden account. De GitHub-repository en de bestanden daarin blijven in GitHub, maar Atoms kan geen wijzigingen meer pushen of pullen.

GitHub-autorisatie geldt voor het verbonden account. Het intrekken van toegang koppelt elk Atoms-project los dat dat GitHub-account gebruikt, dus controleer je andere projecten voordat je doorgaat.

1. Open Settings → Connectors → GitHub.
2. Selecteer Disconnect.
3. Selecteer in de bevestiging Disconnect GitHub opnieuw Disconnect.
4. GitHub zou automatisch de relevante autorisatiepagina moeten openen. Als dat niet gebeurt, ga dan in GitHub naar Settings → Applications → Authorized OAuth Apps.
5. Zoek Atoms, selecteer ... rechts van de rij en selecteer vervolgens Revoke. Selecteer niet Revoke all; die actie verwijdert toegang voor elke geautoriseerde OAuth-app die op de pagina staat vermeld.
6. Volg eventuele bevestigingsstappen die nodig zijn in Github.
7. Ga terug naar Atoms en open de GitHub-connector opnieuw om te bevestigen dat het account niet langer verbonden is.

Selecteer Disconnect in de GitHub-connector.

Trek alleen de Atoms OAuth-applicatie in GitHub in.