Laste opp prosjekt til GitHub: trinn for trinn
Vi viser hvordan du oppretter et nytt GitHub-repositorium og kobler det til det lokale prosjektet ditt, tar første commit og push, og bruker GitHub Desktop eller gh CLI som alternativ.
Aurora YazılımRedaksjonen
6 min lesetid
For å laste opp et prosjekt til GitHub oppretter du først et tomt repositorium på github.com. I prosjektmappen tar du første lagring med git init, git add . og git commit, kobler repoet med git remote add origin og sender det med git push -u origin main. I stedet for kommandolinjen kan du bruke GitHub Desktop eller kommandoen gh repo create.
Dette trenger du før du starter
Å laste opp et prosjekt til GitHub betyr å gjøre en mappe på maskinen din om til et Git-repositorium og koble det til et eksternt repositorium på nettet. Da må tre ting være på plass: Git installert og konfigurert, en GitHub-konto og en måte å autentisere deg på.
Har du ikke installert Git ennå, eller har du ikke satt opp navn, e-post og SSH-nøkkel, bør du først følge guiden vår om Git-installasjon. Kommandoene i denne artikkelen forutsetter at oppsettet er gjort.
- Git: git --version i terminalen skal vise et versjonsnummer.
- GitHub-konto: Du kan opprette den gratis på github.com.
- Autentisering: SSH-nøkkel, eller for HTTPS Git Credential Manager eller et personlig tilgangstoken. GitHub godtar ikke kontopassordet for Git-operasjoner.
- En ryddig prosjektmappe: En .gitignore-fil som holder unødvendige og hemmelige filer ute.
Opprette repo på GitHub
Logg inn på GitHub og klikk på New repository via plussikonet øverst til høyre. Skriv et kort repo-navn med små bokstaver (for eksempel firma-nettside), legg til en beskrivelse og velg synlighet.
Har du allerede et prosjekt på maskinen din, skal du ikke legge til README, .gitignore eller lisens. Opprett repoet helt tomt. Ellers får det eksterne repoet en commit som ikke finnes lokalt, og du får en konflikt ved første push.
| Synlighet | Hvem som ser det | Når du velger det |
|---|---|---|
| Public | Alle | Åpen kildekode, porteføljeprosjekter |
| Private | Bare du og de du inviterer | Kundeprosjekter, intern kode i bedriften |
Hold unødvendige filer unna med .gitignore
Det viktigste du gjør før første commit, er å bestemme hvilke filer som ikke skal inn i repoet. node_modules, bygg-mapper, operativsystemfiler og spesielt .env-filer med passord eller API-nøkler skal aldri lastes opp til GitHub.
Opprett en fil som heter .gitignore i prosjektets rotmappe og legg til linjer som de under. Hvorfor avhengigheter ikke tas med i repoet, og hvilken rolle package.json har, forklarer vi i artikkelen om npm-kommandoer.
- Hvis du ved en feil har gjort commit på en hemmelig fil, er det ikke nok å slette den etterpå. Filen blir værende i historikken. Bytt ut den aktuelle nøkkelen eller passordet med en gang.
- Vil du slutte å følge en mappe som allerede er sporet, bruker du git rm -r --cached mappenavn. Deretter legger du den til i .gitignore og tar en commit.
node_modules/
dist/
build/
.env
.env.*
.DS_Store
Thumbs.db
*.logFørste opplasting fra kommandolinjen
Gå til prosjektmappen i terminalen og kjør kommandoene under i rekkefølge. Adressen til det eksterne repoet finner du på siden til det tomme repoet på GitHub, under Code-knappen. Har du satt opp SSH-nøkkel, kopierer du SSH-adressen. Hvis ikke, kopierer du HTTPS-adressen.
- Gjør mappen om til et Git-repositorium med git init.
- Legg alle filene i oppsamlingsområdet med git add ..
- Opprett første lagring med git commit.
- Sett grennavnet til main.
- Koble til det eksterne repoet med git remote add origin.
- Send det med git push -u origin main. Flagget -u gjør at du bare trenger å skrive git push neste gang.
cd proje-klasoru
git init
git add .
git commit -m "Første 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 maingit remote -v
git status
git log --onelineLaste opp med GitHub Desktop og gh CLI
Kommandolinjen er ikke den eneste veien. Foretrekker du et grafisk grensesnitt, gjør GitHub Desktop jobben, og vil du jobbe raskere i terminalen, gjør gh, GitHubs offisielle kommandolinjeverktøy, det samme på noen få steg.
GitHub Desktop
Installer GitHub Desktop og logg inn med kontoen din. Velg prosjektmappen din med Add local repository i File-menyen. Hvis mappen ikke er et repo ennå, foreslår appen å opprette det. Du ser endringene i panelet til venstre, skriver en melding i feltet nederst og trykker på Commit. Til slutt oppretter og sender Publish repository-knappen repoet til GitHub.
gh CLI
Med gh går oppretting, kobling og sending av repoet sammen i én kommando. Første gang logger du inn via nettleseren med gh auth login.
gh auth login
# Så lenge det finnes minst én commit i mappen
gh repo create depo-adi --private --source=. --remote=origin --pushMed VS Code
Kildekontroll-panelet i VS Code har også en Publish to GitHub-knapp som gir samme flyt. For editor-oppsett og Git-integrasjon kan du se guiden vår om VS Code-installasjon.
Hvordan sender jeg oppdateringer?
Etter den første opplastingen består den daglige flyten av tre kommandoer: klargjør endringene, lagre dem og send dem. Hvis du jobber på en annen maskin, eller en kollega har gjort endringer, henter du siste versjon med git pull før du begynner å jobbe.
Skriv korte og meningsfulle commit-meldinger: «la til telefonfelt i kontaktskjemaet» i stedet for «oppdatering». Når du ser tilbake på historikken om seks måneder, forstår du av meldingene hvilken endring som ble gjort og hvorfor.
git pull
git add .
git commit -m "Lagt til telefonfelt i kontaktskjemaet"
git pushJobbe med grener
I stedet for å gjøre en stor endring direkte på main-grenen oppretter du en ny gren: git switch -c ny-funksjon. Send grenen med git push -u origin ny-funksjon og åpne en pull request på GitHub. Da blir endringen gjennomgått før den slås sammen, og main-grenen er alltid i fungerende stand.
Vanlige push-feil og løsninger
De fleste feilene som dukker opp ved de første push-forsøkene, handler om autentisering, grennavn eller uventede commits i det eksterne repoet.
- src refspec main does not match any: Du har ikke gjort noen commit ennå, eller grenen din heter master. Ta en git commit, eller gi grenen nytt navn med git branch -M main.
- remote origin already exists: Det eksterne repoet er allerede definert. Bruk git remote set-url origin ny-adresse for å endre adressen.
- rejected (fetch first / non-fast-forward): Det eksterne repoet har commits som ikke finnes lokalt, oftest en README som ble opprettet på GitHub. Hent dem med git pull --rebase origin main og push på nytt. Hvis historikkene er helt urelaterte, kan du trenge git pull origin main --allow-unrelated-histories.
- Permission denied (publickey): SSH-nøkkelen din er ikke lagt til kontoen. Test med ssh -T git@github.com.
- Feil med stor fil: GitHub godtar ikke enkeltfiler over 100 MB. Fjern videoer og sikkerhetskopier fra repoet, eller bruk Git LFS.
Hva gir GitHub bedriftsprosjekter?
Når koden ligger på GitHub, går ikke prosjektet tapt ved maskinfeil eller tap av utstyr. Enda viktigere er det at hver endring kan spores. Når en feil havner på det aktive nettstedet, finner du raskt hvilken commit som forårsaket problemet, og kan rulle den tilbake.
Når hastighets- og ytelsesforbedringer på en nettside, som bildekomprimering og kodeminifisering, lagres som egne commits, blir det enklere å måle hvor stor forskjell hver enkelt gjorde. Vi jobber med denne disiplinen i våre prosjekter for bedriftsnettsider og webdesign.
Husk også å legge til en godt skrevet README-fil i repoet. Noen få avsnitt om hva prosjektet gjør, hvordan det installeres og hvilken kommando som starter det, sparer et nytt teammedlem, eller deg selv når du kommer tilbake til prosjektet måneder senere, for flere timer. Skriv bare navnene på miljøvariablene, ikke verdiene.
Du finner flere steg-for-steg-guider i kategorien installasjonsguider.
Vanlige spørsmål
01Koster det penger å laste opp et prosjekt til GitHub?
Nei. I GitHubs gratisplan kan du opprette ubegrenset med public og private repoer. Betalte planer velges mest for behov som teamstyring, avansert sikkerhet og ekstra automatiseringsminutter.
02Kan jeg laste opp prosjektet med dra og slipp?
Du kan laste opp filer via Add file > Upload files i GitHubs nettgrensesnitt. Metoden har imidlertid begrensninger på antall filer og størrelse, og er lite praktisk for jevnlige oppdateringer. På sikt er det mye enklere å bruke Git eller GitHub Desktop.
03Jeg lastet opp en fil med passord ved en feil. Hva gjør jeg?
Bytt først passordet eller API-nøkkelen med en gang. Å slette filen fjerner ikke kopien i historikken. Legg deretter filen til i .gitignore, og følg om nødvendig GitHubs guide for fjerning av sensitive data for å rense historikken.
Å laste opp et prosjekt til GitHub tar bare minutter med et tomt repo, en ryddig .gitignore og noen få Git-kommandoer, og etter det er hver endring trygt lagret. Planlegger du et skreddersydd program eller et webprosjekt for virksomheten din, utviklet med versjonskontroll, kan du se skreddersydde programvareløsninger fra Aurora Yazılım eller ta kontakt med oss.
