Anslut ditt Atoms-projekt till GitHub för att behålla dess kod i ett privat repository och flytta ändringar mellan Atoms och GitHub utan att använda Git-kommandon.

Den här guiden förklarar hela installationsprocessen: att ansluta ditt GitHub-konto till Atoms, skapa repositoryt, bekräfta att anslutningen fungerar och hålla Atoms- och GitHub-versionerna av ditt projekt synkroniserade.

Så fungerar anslutningen

Det finns 2 steg för att ansluta GitHub:

1. Anslut ditt GitHub-konto. Detta ger Atoms behörighet att arbeta med GitHub för din räkning.
2. Skapa ett repository för ditt projekt. Ett repository är det privata utrymmet i GitHub där ditt projekts kod och ändringshistorik lagras.

Atoms skapar för närvarande ett nytt privat repository i den anslutna användarens personliga GitHub-konto. Du kan inte ansluta till ett befintligt repository, skapa repositoryt under en organisation eller göra det offentligt via anslutningen.

Innan du börjar

Innan du ansluter ditt projekt till GitHub, se till att:

• Din Atoms-plan inkluderar GitHub connection. Om du använder planen Free kommer du till sidan Plans när du väljer GitHub.
• Endast workspace owner kan ansluta eller koppla från GitHub. Om du är redigerare, be workspace owner att utföra detta steg.
• Du har ett GitHub-konto eller är redo att skapa ett under installationen.
• Din webbläsare tillåter popup-fönster från Atoms.
• Inga Agents arbetar för närvarande med ditt projekt.

Du behöver inte någon personlig GitHub-åtkomsttoken för att ansluta ditt konto. Klistra aldrig in GitHub-token, lösenord eller andra inloggningsuppgifter i Chat.

Anslut ditt GitHub-konto

Öppna GitHub-anslutningen

1. Öppna projektet som du vill ansluta.
2. Klicka på projektnamnet högst upp till höger i chattpanelen.
3. Välj Connectors i rullgardinsmenyn som visas.
4. Hitta Github i listan över tillgängliga anslutningar och klicka på connect.

Du kan också öppna Settings → Connectors → GitHub och välja Connect.

Öppna Settings → Connectors och välj Connect för GitHub.

Auktorisera Atoms i GitHub

Om Connected Account redan visar GitHub-kontot som du vill använda, har det redan auktoriserats. Du kan fortsätta till Create a private repository.

1. Atoms öppnar ett GitHub-auktoriseringsfönster. Logga in på GitHub-kontot som du vill ansluta till, eller skapa ett nytt konto om det behövs.
2. Kontrollera att du är inloggad på rätt GitHub-konto.
3. Granska behörigheterna som Atoms begär. Om du godkänner dem, välj Authorize Atoms-Agents.
4. Gå tillbaka till Atoms och vänta på meddelandet Connect success.
5. I Atoms öppnar du Connectors och bekräftar att ditt GitHub-konto visas som anslutet.

Atoms begär OAuth-behörigheterna repo, read:user och workflow. Dessa gör det möjligt för Atoms att läsa och skriva till offentliga och privata repositories som det anslutna kontot har åtkomst till, läsa grundläggande profilinformation och lägga till eller uppdatera arbetsflödesfiler för GitHub Actions.

Denna auktorisering gäller för det anslutna GitHub-kontot och är inte begränsad till repositoryt som skapats för det aktuella Atoms-projektet. Atoms kan inte komma åt repositories som det anslutna kontot självt inte kan komma åt, och organisationspolicyer kan medföra ytterligare begränsningar.

Granska GitHub-behörigheter och välj Authorize Atoms-Agents.

Skapa ett privat repository

När du har auktoriserat ditt GitHub-konto skapar du det privata repository som ska lagra ditt projekts kod.

1. Under Connected Account kontrollerar du att det visade användarnamnet matchar GitHub-kontot som du vill använda.
2. Under Create New Repository anger du ett namn för repositoryt. Namnet måste:
   • innehålla 1–100 tecken;
   • endast använda bokstäver, siffror, bindestreck (-), understreck (_) eller punkter (.).
3. Välj Create.
4. Vänta på meddelandet GitHub repository connected successfully!.

Atoms skapar ett nytt privat repository i den anslutna användarens personliga GitHub-konto, länkar det till det aktuella Atoms-projektet och försöker sedan ladda upp projektets aktuella filer till GitHub.

Ange ett namn och skapa ett nytt privat repository.

Kontrollera att anslutningen fungerade

Kontrollera anslutningen i både Atoms och GitHub innan du förlitar dig på repositoryt.

1. I Atoms bekräftar du att Repository Status visar Connected.
2. Under Branches kontrollerar du att en gren har en bockmarkering. Detta är grenen som för närvarande är ansluten till ditt Atoms-projekt. Om du är ny på GitHub, låt denna gren vara vald.
3. Välj View on GitHub.
4. I GitHub bekräftar du att repositoryt:
   • tillhör rätt GitHub-konto;
   • är markerat som Private;
   • innehåller de förväntade projektfilerna; och
   • har minst en commit.

Om repositoryt är tomt och Push Changes är tillgängligt i Atoms, välj det och vänta tills åtgärden är klar. Uppdatera sedan repositorysidan i GitHub och kontrollera att projektfilerna nu visas.

Kontrollera det anslutna repositoryt och den valda grenen i Atoms.

Verifiera det privata repositoryt och projektfilerna i GitHub.

Håll Atoms och GitHub synkroniserade

Atoms och GitHub hålls inte synkroniserade automatiskt. När ändringar har gjorts på ena sidan använder du synkroniseringskontrollerna för att flytta dessa ändringar till den andra.

Åtgärd	Använd den när	Vad som händer
Push Changes	Du gjorde ändringar i Atoms och vill skicka dem till GitHub.	Atoms skickar de aktuella projektfilerna till den valda GitHub-grenen.
Pull Updates	Ändringar gjordes i den valda grenen i GitHub och du vill hämta in dem till Atoms.	Atoms uppdaterar projektet med de senaste ändringarna från GitHub.

Innan du pushar eller hämtar ändringar, vänta tills Agent har arbetat klart och se till att du visar den senaste versionen av projektet i Chat. Om du öppnade en äldre version från History, gå tillbaka till kortet för den senaste versionen längst ned i Chat och öppna sedan GitHub igen.

Om du inte är på den senaste versionen visar Atoms You must be on the latest version to pull updates or push changes.

Innan du synkroniserar, kontrollera också att den valda grenen är den du vill uppdatera.

Om både Atoms och GitHub innehåller ändringar som du behöver behålla ska du inte synkronisera dem ännu. Spara först en kopia av det viktiga arbetet, eller be någon som är bekant med GitHub att bevara ändringarna i en separat gren.

Om Repository Status visar Upstream Changes Available innehåller GitHub ändringar som Atoms ännu inte har. Granska repositoryt innan du väljer en åtgärd.

Använd Pull Updates och Push Changes för den valda grenen.

Pusha ändringar från Atoms till GitHub

1. Slutför dina ändringar i Atoms och vänta tills Agent slutar arbeta.
2. Se till att du visar den senaste versionen av projektet.
3. Öppna Settings → Connectors → GitHub och kontrollera att rätt gren är vald.
4. Välj Push Changes.
5. Låt sidan vara öppen medan ändringarna pushas.
6. När Changes pushed successfully visas väljer du View on GitHub och kontrollerar att de senaste projektfilerna finns där.

Push Changes är endast tillgängligt när Atoms har ändringar som ännu inte har skickats till GitHub. Det är inte tillgängligt medan Agent arbetar eller när du visar en äldre version av projektet.

När du väljer Push Changes skickas ändringarna omedelbart till GitHub utan att be om bekräftelse. Om samma fil har ändrats i både Atoms och GitHub har versionen i Atoms företräde och skriver över versionen som för närvarande lagras i GitHub.

Hämta uppdateringar från GitHub till Atoms

Till skillnad från att pusha kräver hämtning av ändringar först en bekräftelse. Om samma fil har ändrats i både GitHub och Atoms har GitHub-versionen företräde och skriver över den aktuella versionen i Atoms.

1. Öppna Settings → Connectors → GitHub.
2. Kontrollera att Repository Status visar nya ändringar från GitHub och att rätt gren är vald.
3. Välj Pull Updates.
4. Läs varningen Pull May Affect Project. Om du vill hämta GitHub-ändringarna till ditt aktuella Atoms-projekt väljer du Confirm.
5. Låt sidan vara öppen medan ändringarna hämtas.
6. När Changes pulled successfully visas öppnar du App Viewer och testar de delar av projektet som påverkats av ändringarna för att säkerställa att allt fortfarande fungerar som förväntat.

Pull Updates är endast tillgängligt när den valda GitHub-grenen innehåller ändringar som ännu inte har hämtats till Atoms.

Koppla från GitHub

Koppla från GitHub när du inte längre vill att Atoms ska få åtkomst till det anslutna kontot. GitHub-repositoryt och dess filer kommer att finnas kvar i GitHub, men Atoms kommer inte längre att kunna pusha eller hämta ändringar.

GitHub-auktorisering gäller för det anslutna kontot. Att återkalla åtkomst kopplar från varje Atoms-projekt som använder det GitHub-kontot, så kontrollera dina andra projekt innan du fortsätter.

1. Öppna Settings → Connectors → GitHub.
2. Välj Disconnect.
3. I bekräftelsen Disconnect GitHub väljer du Disconnect igen.
4. GitHub bör öppna den relevanta auktoriseringssidan automatiskt. Om det inte gör det går du i GitHub till Settings → Applications → Authorized OAuth Apps.
5. Hitta Atoms, välj ... till höger på dess rad och välj sedan Revoke. Välj inte Revoke all; den åtgärden tar bort åtkomst för varje auktoriserad OAuth-app som listas på sidan.
6. Följ eventuella bekräftelsesteg som behövs från Github.
7. Gå tillbaka till Atoms och öppna GitHub-anslutningen igen för att bekräfta att kontot inte längre är anslutet.

Välj Disconnect i GitHub-anslutningen.

Återkalla endast Atoms OAuth-applikation i GitHub.