Gitin asennus ja ensimmäinen konfigurointi

01Mikä on Git ja miksi se kannattaa asentaa?

Git on versionhallintajärjestelmä, joka tallentaa jokaisen tiedostojesi muutoksen. Näet, kuka muutti minkä rivin, milloin ja miksi; kun teet virheen, palaat edelliseen toimivaan versioon minuuteissa.

Git ei ole vain ohjelmoijille. Verkkosivun tiedostoja, asetustiedostoja ja jopa teknisiä dokumentteja voi hallita Gitillä turvallisesti. Tiimityössä se on välttämätön: jokainen työskentelee omalla haarallaan ja muutokset yhdistetään hallitusti.

Älä sekoita Gitiä ja GitHubia. Git on tietokoneellasi toimiva työkalu; GitHub, GitLab ja Bitbucket taas ovat palveluita, jotka isännöivät repositorioitasi internetissä. Tässä artikkelissa asennamme ja konfiguroimme Gitin; repositorion lähettämisen etäpalvelimelle olemme kuvanneet oppaassa projektin vieminen GitHubiin.

Jos komentorivi tuntuu vieraalta, älä huoli: VS Coden versionhallintapaneeli ja graafiset käyttöliittymät kuten GitHub Desktop käyttävät taustalla samaa Gitiä. Peruskomentojen tunteminen auttaa kuitenkin ymmärtämään, mitä tapahtuu, kun käyttöliittymä näyttää odottamattoman virheen. Siksi oppaassa jokainen vaihe näytetään komennolla ja käyttöliittymän vastineet mainitaan tarpeen mukaan.

02Gitin asennus Windowsissa

Windowsin virallinen asennusohjelma löytyy osoitteesta git-scm.com. Asennusohjelma asentaa Gitin mukana Git Bash -nimisen päätteen ja Git Credential Managerin. Jos pidät komentorivistä, voit asentaa wingetillä yhdellä rivillä.

winget install --id Git.Git -e --source winget

Asennusohjelman tärkeät valinnat

Asennusohjelma näyttää paljon ruutuja, ja useimmissa oletusarvo on oikea. Kiinnitä silti huomiota seuraaviin kolmeen valintaan:

• Oletuseditori: Valitse Vimin sijaan tuttu editori, kuten VS Code tai Notepad++.
• Oletushaaran nimi: Valitse “Override the default branch name” ja kirjoita main.
• PATH-asetus: Valinta “Git from the command line and also from 3rd-party software” mahdollistaa Gitin käytön PowerShellistä ja VS Codesta.

03Gitin asennus macOS:ssä ja Linuxissa

macOS:ssä Git tulee Applen komentorivin kehittäjätyökalujen mukana. Jos työkaluja ei ole asennettu, kun kirjoitat päätteeseen git, järjestelmä ehdottaa asennusta; saman voi käynnistää myös alla olevalla komennolla. Jos haluat uudemman version, käytä Homebrewta.

Linuxissa Git löytyy jakelun virallisesta pakettivarastosta. Riittää, että ajat pakettienhallintaasi sopivan komennon.

# Applen komentorivityökalut
xcode-select --install

# ya da Homebrew ile
brew install git

# Ubuntu / Debian
sudo apt update
sudo apt install git

# Fedora
sudo dnf install git

# Arch
sudo pacman -S git

git --version

04Ensimmäiset asetukset git configilla

Git lisää jokaiseen committiin tekijän nimen ja sähköpostin. Jos yrität tehdä commitin ilman näitä tietoja, saat virheen “Author identity unknown”. --global-lippu tekee asetuksesta voimassa olevan kaikille tietokoneesi repositorioille.

Käytä sähköpostina GitHub-tilillesi rekisteröityä osoitetta; näin commitisi yhdistyvät profiiliisi. Jos haluat pitää osoitteesi salassa, voit kirjoittaa myös GitHubin antaman noreply-osoitteen.

git config --global user.name "Ad Soyad"
git config --global user.email "ad@ornek.com"
git config --global init.defaultBranch main

# VS Code editorina
git config --global core.editor "code --wait"

# git pull -toiminta (yhdistäminen)
git config --global pull.rebase false

# Näytä kaikki asetukset ja tiedosto, josta ne tulevat
git config --list --show-origin

Rivinvaihtoasetus

Windows kirjoittaa rivinvaihdon CRLF:nä, macOS ja Linux LF:nä. Määritä sekatiimeissä core.autocrlf-asetus käyttöjärjestelmäsi mukaan, jotta turhia muutoksia ei näy. Varmempi ratkaisu on lisätä repositorioon .gitattributes-tiedosto.

# Windows
git config --global core.autocrlf true

# macOS / Linux
git config --global core.autocrlf input

Pikakomennot ja globaali .gitignore

Voit säästää aikaa määrittämällä usein kirjoittamillesi komennoille aliaksia; esimerkiksi kun kirjoitat git st, suoritetaan git status. Käyttöjärjestelmän tuottamat tiedostot kuten .DS_Store ja Thumbs.db taas kannattaa jättää pois yhdellä globaalilla .gitignore-tiedostolla sen sijaan, että kirjoittaisit ne erikseen jokaiseen repositorioon.

Nämä asetukset ovat henkilökohtaisia eikä niitä kirjoiteta repositorioon; tiimin noudatettavat säännöt (esimerkiksi mitä kansiota ei seurata) tulee aina pitää repositorion .gitignore-tiedostossa.

git config --global alias.st status
git config --global alias.lg "log --oneline --graph --decorate"

# Määritä globaali .gitignore-tiedosto
git config --global core.excludesfile ~/.gitignore_global

Repositoriokohtainen asetus

Jos käytät työ- ja henkilökohtaisissa projekteissa eri sähköpostia, kirjoita kyseisen repositorion kansiossa git config user.email ilman --global-lippua. Repositoriotason asetus syrjäyttää globaalin asetuksen.

05Miten SSH-avain luodaan?

Turvallisin tapa yhdistää etärepositorioihin ilman salasanan tai tokenin syöttämistä joka kerta on SSH-avain. Yksityinen avain pysyy tietokoneellasi ja julkinen avain lisätään GitHub- tai GitLab-tiliisi. Nykyään suositeltu algoritmi on ed25519.

1. Luo avain; hyväksy kysyttäessä oletustiedostopolku ja aseta salasana (passphrase).
2. Lisää avain ssh-agentiin, jotta sinun ei tarvitse syöttää salasanaa jokaisessa toiminnossa.
3. Kopioi julkinen avain (.pub-päätteinen tiedosto) ja liitä se tilisi SSH-avainten osioon.
4. Testaa yhteys; tervetuloviestissä pitäisi näkyä käyttäjätunnuksesi.

ssh-keygen -t ed25519 -C "ad@ornek.com"

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# Näytä julkinen avain (macOS:ssä leikepöydälle: pbcopy < ~/.ssh/id_ed25519.pub)
cat ~/.ssh/id_ed25519.pub

# Yhteystesti
ssh -T git@github.com

ssh-keygen -t ed25519 -C "ad@ornek.com"

Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
ssh-add $env:USERPROFILE\.ssh\id_ed25519

# Kopioi julkinen avain leikepöydälle
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard

06Testaa asennus: ensimmäinen repositorio

Luo pieni kokeilurepositorio nähdäksesi, että asetukset toimivat. Alla olevat komennot luovat kansion, muuttavat sen Git-repositorioksi, lisäävät tiedoston ja tekevät ensimmäisen commitin. Jos näet git log -tulosteessa oman nimesi, konfiguraatio on oikein.

• git init luo kansioon piilotetun .git-hakemiston; koko historia säilytetään siellä.
• git add siirtää muutoksen valmistelualueelle, git commit tallentaa sen pysyvästi.
• git status näyttää, mitkä tiedostot ovat muuttuneet ja mikä odottaa commitia; se on useimmin katsomasi komento.

mkdir git-deneme
cd git-deneme
git init
echo "# Deneme" > README.md
git add README.md
git commit -m "Ensimmäinen commit"
git log --oneline
git status

07Yleiset virheet ja ratkaisut

Lähes kaikki Gitin asennuksen jälkeisinä ensimmäisinä päivinä vastaan tulevat virheet liittyvät tunnistautumiseen ja PATHiin.

• git-komentoa ei tunnisteta: Sulje ja avaa uudelleen ennen asennusta avattu pääte; jos ongelma jatkuu, aja asennusohjelma uudelleen PATH-valinnalla.
• Permission denied (publickey): Julkista avainta ei ole lisätty tiliin tai ssh-agent ei ole ladannut avainta. Tarkista ladatut avaimet komennolla ssh-add -l.
• HTTPS ei hyväksy salasanaa: GitHub ei hyväksy tilin salasanaa Git-toiminnoissa. Käytä SSH:ta tai luo henkilökohtainen käyttöoikeustoken; Windowsissa Git Credential Manager hoitaa tämän selaimen kautta.
• LF will be replaced by CRLF -varoitus: Ei virhe vaan rivinvaihtomuunnoksen ilmoitus; ratkaise pysyvästi core.autocrlf-asetuksella ja .gitattributes-tiedostolla.
• Commit väärällä nimellä: Voit korjata viimeisen commitin tekijän komennolla git commit --amend --reset-author (jos et ole vielä tehnyt pushia).

08Miten Gitiä käytetään ammattimaisissa projekteissa?

Gitin asennuksen jälkeen todellinen arvo syntyy säännöllisestä ja mielekkäistä commit-tavoista. Pienet, yhteen tarkoitukseen keskittyvät commitit sekä helpottavat paluuta että nopeuttavat koodikatselmointia tiimissä. Älä unohda jättää JavaScript-projektissa kansioita kuten node_modules pois .gitignore-tiedostolla; yksityiskohdat artikkelissamme npm-komennot.

Verkkoprojekteissa Git on myös perusta hallitulle julkaisulle live-sivustolle: jokainen muutos kokeillaan ensin testiympäristössä ja viedään sitten tuotantoon. Tämä käytäntö mahdollistaa myös nopeus- ja suorituskykyoptimoinnin parannusten mittaamisen ja tarvittaessa peruuttamisen.

Aurora Yazılımilla kehitämme verkkosivujen suunnittelu- ja verkkokauppa-alusta-projektimme versionhallinnalla. Muita Git-aiheisia sisältöjä löydät git-tunnisteen sivulta.