Ladda upp ett projekt till GitHub: steg för steg

01Vad behöver du innan du börjar?

Att ladda upp ett projekt till GitHub innebär att göra en mapp på din dator till ett Git-repo och koppla det till ett fjärrrepo på nätet. Då måste tre saker vara på plats: ett installerat och konfigurerat Git, ett GitHub-konto och en metod för autentisering.

Har du ännu inte installerat Git eller ställt in namn, e-postadress och SSH-nyckel följer du först vår guide installera Git. Kommandona i den här artikeln förutsätter att de inställningarna är gjorda.

• Git: git --version i terminalen ska returnera ett versionsnummer.
• GitHub-konto: det skapas gratis på github.com.
• Autentisering: en SSH-nyckel, eller för HTTPS Git Credential Manager eller en personlig åtkomsttoken. GitHub accepterar inte kontolösenordet för Git-åtgärder.
• En ren projektmapp: en .gitignore-fil för att sortera bort onödiga och hemliga filer.

02Skapa ett repo på GitHub

Logga in på GitHub och klicka på New repository via plusikonen uppe till höger. Skriv ett kort reponamn med gemener (till exempel foretagets-webbplats), lägg till en beskrivning och välj synlighet.

Om du redan har ett projekt på datorn ska du inte lägga till README, .gitignore eller licens. Skapa repot helt tomt. Annars får fjärrrepot en commit som inte finns lokalt, och du hamnar i en konflikt vid den första push.

03Sortera bort onödiga filer med .gitignore

Det viktigaste du gör före den första commiten är att bestämma vilka filer som inte ska in i repot. node_modules, byggmappar, operativsystemets filer och framför allt .env-filer med lösenord eller API-nycklar ska aldrig laddas upp till GitHub.

Skapa en fil som heter .gitignore i projektets rotmapp och lägg till rader som nedan. Varför beroenden inte hamnar i repot och vilken roll package.json spelar förklarar vi i artikeln om npm-kommandon.

• Om du av misstag har committat en hemlig fil räcker det inte att radera den senare, eftersom filen finns kvar i historiken. Byt omedelbart ut den berörda nyckeln eller det berörda lösenordet.
• För att sluta spåra en mapp som redan spåras använder du git rm -r --cached mappnamn. Lägg sedan till den i .gitignore och gör en commit.

node_modules/
dist/
build/
.env
.env.*
.DS_Store
Thumbs.db
*.log

04Första uppladdningen via kommandoraden

Gå till projektmappen i terminalen och kör kommandona nedan i ordning. Adressen till fjärrrepot hittar du på sidan för det tomma repot på GitHub, under knappen Code. Har du satt upp en SSH-nyckel kopierar du SSH-adressen, annars HTTPS-adressen.

1. Gör om mappen till ett Git-repo med git init.
2. Lägg alla filer i staging-området med git add ..
3. Skapa den första registreringen med git commit.
4. Lås branchens namn till main.
5. Koppla fjärrrepot med git remote add origin.
6. Skicka upp med git push -u origin main. Flaggan -u gör att du i fortsättningen bara behöver skriva git push.

cd proje-klasoru
git init
git add .
git commit -m "Första commit"
git branch -M main

# SSH adresi
git remote add origin git@github.com:kullanici-adi/depo-adi.git
# ya da HTTPS adresi
# git remote add origin https://github.com/kullanici-adi/depo-adi.git

git push -u origin main

git remote -v
git status
git log --oneline

05Ladda upp med GitHub Desktop och gh CLI

Kommandoraden är inte den enda vägen. För dig som föredrar ett grafiskt gränssnitt finns GitHub Desktop, och för dig som vill jobba snabbare i terminalen finns GitHubs officiella kommandoradsverktyg gh. Båda gör samma sak i några få steg.

GitHub Desktop

Installera GitHub Desktop och logga in med ditt konto. Välj projektmappen via Add local repository i File-menyn. Är mappen inte redan ett repo föreslår appen att skapa ett. Du ser ändringarna i vänstra panelen, skriver ett meddelande i rutan längst ner och klickar på Commit. Till sist skapar knappen Publish repository repot på GitHub och skickar upp det.

gh CLI

Med gh slås skapande, koppling och uppladdning av repot ihop i ett enda kommando. Vid första användningen loggar du in via webbläsaren med gh auth login.

gh auth login

# När det finns minst en commit i mappen
gh repo create depo-adi --private --source=. --remote=origin --push

Med VS Code

Knappen Publish to GitHub i VS Codes panel för källkontroll ger samma flöde. Hur du installerar editorn och Git-integrationen går vi igenom i guiden installera VS Code.

06Hur skickar jag uppdateringar?

Efter den första uppladdningen består det dagliga flödet av tre kommandon: förbered ändringarna, spara dem och skicka dem. Om du arbetar på en annan dator, eller om en kollega har gjort ändringar, hämtar du det aktuella läget med git pull innan du börjar arbeta.

Skriv korta och meningsfulla commit-meddelanden, till exempel “telefonfält tillagt i kontaktformuläret” i stället för “uppdatering”. När du tittar tillbaka i historiken om sex månader förstår du av meddelandena vilken ändring som gjordes och varför.

git pull
git add .
git commit -m "Lade till telefonfält i kontaktformuläret"
git push

Arbeta med branches

Gör inte större ändringar direkt i main-branchen utan skapa en ny branch: git switch -c ny-funktion. Skicka upp branchen med git push -u origin ny-funktion och öppna en pull request på GitHub. Då granskas ändringen innan den slås ihop, och main-branchen förblir alltid fungerande.

07Vanliga push-fel och lösningar

De flesta felen vid de första push-försöken har att göra med autentisering, branchnamn eller oväntade commits i fjärrrepot.

• src refspec main does not match any: det finns ännu ingen commit, eller så heter din branch master. Gör en git commit eller byt namn på branchen med git branch -M main.
• remote origin already exists: fjärrrepot är redan definierat. Ändra adressen med git remote set-url origin ny-adress.
• rejected (fetch first / non-fast-forward): fjärrrepot har en commit som inte finns lokalt, oftast en README som skapats på GitHub. Hämta den med git pull --rebase origin main och gör push igen. Om historiken är helt orelaterad kan git pull origin main --allow-unrelated-histories behövas.
• Permission denied (publickey): din SSH-nyckel har inte lagts till på kontot. Testa med ssh -T git@github.com.
• Fel för stora filer: GitHub accepterar inte enskilda filer över 100 MB. Ta bort videor och säkerhetskopior från repot eller använd Git LFS.

08Vad ger GitHub verksamheten?

När koden ligger på GitHub förloras inte projektet om datorn går sönder eller försvinner. Än viktigare är att varje ändring går att spåra, så att man snabbt hittar vilken commit som orsakade problemet när ett fel når den skarpa sajten, och kan rulla tillbaka den.

När förbättringar av hastighet och prestanda på en webbplats, som bildkomprimering och minifiering av kod, sparas som separata commits blir det lättare att mäta hur stor skillnad var och en gjorde. Vi arbetar med den disciplinen i våra projekt för företagswebbplatser och webbdesign.

Glöm inte att lägga till en välskriven README-fil i repot. Några stycken om vad projektet gör, hur det installeras och vilket kommando som startar det kan spara en ny teammedlem, eller dig själv när du återvänder om några månader, timmar av arbete. Skriv bara namnen på miljövariablerna i listan, inte deras värden.

Fler steg-för-steg-guider hittar du i kategorin installationsguider.