Anslut GitHub

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.

Hur anslutningen fungerar

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 projektets 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-anslutning. 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 ingen 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 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 det GitHub-konto 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å det GitHub-konto du vill ansluta till, eller skapa ett nytt konto vid behov.
2. Kontrollera att du är inloggad på rätt GitHub-konto.
3. Granska behörigheterna som begärs av Atoms. Om du godkänner dem, välj Authorize Atoms-Agents.
4. Gå tillbaka till Atoms och vänta på meddelandet Connect success.
5. Öppna Connectors i Atoms och bekräfta att ditt GitHub-konto visas som anslutet.

Atoms begär OAuth-behörigheterna repo, read:user och workflow. Dessa gör att Atoms kan läsa och skriva 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 projektets kod.

1. Under Connected Account, kontrollera att det visade användarnamnet matchar det GitHub-konto du vill använda.
2. Under Create New Repository, ange 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 börjar förlita dig på repositoryt.

1. Bekräfta i Atoms att Repository Status visar Connected.
2. Under Branches, kontrollera att en gren har en bockmarkering. Detta är den gren 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. Bekräfta i GitHub 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.

Action	Use it when	What happens
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 avslutat sitt arbete 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. Håll sidan öppen medan ändringarna pushas.
6. När Changes pushed successfully visas, välj View on GitHub och kontrollera 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 till GitHub omedelbart 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 kommer att skriva över den version 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 kommer att skriva ö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älj Confirm.
5. Håll sidan öppen medan ändringarna hämtas.
6. När Changes pulled successfully visas, öppna App Viewer och testa 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 ha å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älj Disconnect igen.
4. GitHub bör öppna den relevanta auktoriseringssidan automatiskt. Om det inte gör det, gå 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.