Hyppää sisältöön

Versionhallinnan etäkäyttö

Tähän asti olemme käyttäneet versiohallintaa vain omalla koneella. Jotta koodi on turvassa kiintolevyn rikkoutumiselta ja jotta sen voi jakaa muille, koodi pitää yleensä viedä etävarastoon (engl. remote repository). Etävarasto voi olla vaikkapa toinen verkossa oleva tietokone, mutta nykyään on yleisempää käyttää jotakin julkista etävarastopalvelua, kuten GitHub- tai GitLab-palveluita. Nämä, kuten monet muut vastaavat Git-etävarastopalvelut tarjoavat myös muita projektihallinnassa hyödyllisiä lisäominaisuuksia, kuten tehtävähallintaa, keskustelupalstoja ja muita yhteistyötä helpottavia työkaluja. Nämä lisätyökalut eivät sinänsä ole Git-työkaluja, mutta ne tekevät etävarastopalveluista monipuolisia yhteistyöalustoja.

Tässä osassa siirrämme paikallisen projektin GitLab- tai GitHub-palveluun. Jyväskylän yliopiston opiskelijoilla on käytössään JY:n oma GitLab-palvelin. Muut opiskelijat voivat ladata koodin esimerkiksi GitHub-palveluun.

Etävaraston luominen

Jotta Git-varasto voidaan ladata etävarastopalveluun, palvelussa tulee ensin alustaa etävarasto. Etävarastopalvelut kutsuvat etävarastoja usein myös projekteiksi tarjottujen lisäpalvelujen takia.

Valitse käytettävä etävarastopalvelu:

  • Jyväskylän yliopiston opiskelijat: valitse GitLab (JY). Halutessaan voi vaihtoehtoisesti käyttää GitHubia.
  • Muussa tapauksessa valitse GitHub.
  1. Kirjaudu sisään Jyväskylän yliopiston GitLab-palveluun yliopiston tunnuksilla. Kirjoita tunnus muodossa tunnus ilman @jyu.fi-päätettä.

  2. Paina oikeassa yläpalkissa olevaa +-painiketta ja valitse New project/repository:

  3. Valitse annetuista vaihtoehdoista Create blank project.

  4. Täytä projektin tiedot seuraavasti:

  5. Project name: Anna projektille nimi, esimerkiksi TodoFX.

  6. Project URL: Varmista, että https://gitlab.jyu.fi/-kentän perässä olevassa alasvetovalikossa lukee oma käyttäjätunnus. Jos ei, klikkaa alasvetovalikkoa ja kirjoita tunnus.
  7. Project slug: Sen pitäisi olla automaattisesti projektin nimi ilman erikoiskirjaimia, esimerkiksi todofx.
  8. Visibility level: Valitse tässä projektissa Internal tai Public, jotta muut ihmiset pääsevät näkemään projektin koodin. Omissa projekteissa voi valita mielestään sopivan.
  9. Project configuration: Ota kaikki ruksit pois päältä. Poista valinta erityisesti kohdasta Initialize repository with a README, sillä meillä on jo lokaalisti olemassa oleva projekti.

Lomakkeen pitäisi lopuksi näyttää täältä:

<img src="../images/gitlab-project-form.png">
  1. Paina lopuksi Create project.

  1. Kirjaudu sisään GitHubiin. Jos tunnusta ei ole, luo sellainen.

  2. Paina oikeassa yläpalkissa olevaa +-painiketta ja valitse New repository.

  3. Täytä etävaraston tiedot seuraavasti:

  4. Repository name: Anna projektille nimi, esimerkiksi TodoFX.

  5. Description: Voit jättää tyhjäksi tai keksiä lyhyen kuvauksen.
  6. Choose visibility: Valitse tässä tapauksessa Public. Omissa projekteissa voi valita mielestään sopivan.
  7. Start with template: No template
  8. Add README: Pois päältä (Off)
  9. Add .gitignore: No .gitignore
  10. Add license: No license

Lopuksi lomakkeen pitäisi näyttää täältä:

  1. Paina lopuksi Create repository.

Etävaraston yhdistäminen lokaaliin projektiin

Avaa komentorivi ja siirry projektin juurikansioon. Juurikansio on se kansio, jossa on src-kansio ja pom.xml-tiedosto. Oikean kansion voi varmistaa suorittamalla git status -komennon, jolloin pitäisi näkyä git-varaston tila samalla tavalla kuin osassa 7.3.

Lisäämme seuraavaksi etävaraston osoitteen paikalliseen varastoon. Tätä varten meidän ensin pitäisi tietää git-etävaraston osoite.

  1. Mene tekemäsi projektin sivulle. Sivun osoitteen pitäisi olla muotoa https://gitlab.jyu.fi/tunnus/projektin-nimi. Kaikki projektit löytyvät helposti myös osoitteesta https://gitlab.jyu.fi/dashboard/projects/personal.

  2. Kopioi git-etävaraston osoite. Klikkaa sinisestä Code-painikkeesta ja kopioi Clone with HTTPS -kentässä oleva osoite:

  1. Mene tekemäsi etävaraston sivulle. Sivun osoitteen pitäisi olla muotoa https://github.com/tunnus/varaston-nimi. Kaikki etävarastot löytyvät helposti myös osoitteesta https://github.com/repos.

  2. Kopioi git-etävaraston osoite.

    Jos etävarasto on tyhjä, osoite näkyy suoraan etävarastosivulla:

    Jos taas etävarastossa on jo koodia, osoitteen näkee klikkaamalla vihreästä Code-painikkeesta ja valitsemalla HTTPS-osoitteen:

Kopioi etävaraston osoite ja lisää se paikalliseen varastoon git remote add -komennolla:

git remote add -komento ottaa kaksi parametria: etävaraston nimen ja etävaraston osoitteen.

Sana origin on Git-maailmassa vakiintunut nimitys projektin pääasialliselle etävarastolle.

Koodin lähettäminen etävarastoon ensimmäistä kertaa

Voimme nyt lähettää koodin etävarastoon. Ennen koodin lähettämistä meidän tulee vielä selvittää etävaraston käyttäjätunnus ja salasana. Nämä riippuvat palvelusta.

Etävarastoon lähettämisen yhteydessä käyttäjätunnus on aina yliopiston tunnus ilman @jyu.fi-päätettä. Salasanana toimii yliopiston salasana.

Etävarastoon lähettämisen yhteydessä käyttäjätunnus on oma GitHub-käyttäjätunnus. Salasanaksi ei kelpaa GitHub-salasana, vaan sen sijaan on luotava erillinen pääsyavain (engl. Personal Access Token, PAT):

  1. Mene osoitteeseen https://github.com/settings/tokens
  2. Klikkaa Generate new token ja valitse Generate new token (classic).

  3. Täytä lomake seuraavasti:

    • Note: Anna jokin kuvaava nimi, vaikkapa git-komentorivi.
    • Expiration: Valitse jokin pitkä aika tai No expiration. Huomaa, että aikarajan asettaminen tarkoittaa, että pääsyavain lakkaa toimimasta aikarajan jälkeen, jolloin on luotava uusi avain.
    • Select scopes: Valitse repo ja varmista, että kaikki sen kohdalla olevat alavalinnat on valittu.

  4. Paina lopuksi Generate token sivun alapuolella.

  5. Pääsyavain näkyy vihreässä kentässä. Tämä avain toimii jatkossa salasanana aina, kun koodia lähetetään GitHubiin. Laita tämä koodi talteen.

Kun tunnus ja salasana on tiedossa, projektin voi lähettää ensimmäistä kertaa etävarastoon käyttäen git push -komentoa:

Tämä komento tekee kaksi asiaa:

  1. push lähettää paikalliset commitit etävarastoon.
  2. -u origin master linkittää paikallisen master-haaran varaston master-haaraan. Tämän avulla Git-työkalu jatkossa tietää, että git push -komento ilman parametreja lähettää koodia aina origin-etävarastoon.

Huomaa, että ensimmäisen koodin lähettämisen, eli ns. push-komennon yhteydessä, Git-työkalu voi kysyä tunnusta ja salasanaa. Tunnus- ja salasanadialogi eroaa käyttöjärjestelmästä toiseen, mutta periaate on sama: anna yllä olevien ohjeiden mukainen tunnus ja salasana.

Jatkossa

Kun etävarasto on kerran määritelty ja ensimmäinen push on tehty, jatkossa työnkulku on yksinkertainen:

  1. Tee muutoksia koodiin.
  2. git add ., joka lisää muutokset Git-työkalun "käsittelyjonoon".
  3. git commit -m "Lisätty muokkausikkuna", joka tekee jonossa olevista muutoksista commitin.
  4. git push, joka lähettää kaikki tähän mennessä tehdyt commitit etävarastoon talteen.

Tehtävät

8.8Git-etävarasto.1 p.

Tee työllesi julkinen Git-etävarasto ja tallenna koodisi sinne.

Tee tehtävä TIMissä