GitLab-versionhallintajärjestelmä

TUNI tietohallinto ylläpitää kahta GitLab-palvelua:

• Tutkimuksen tarpeisiin ja versionhallinnan käytön opetteluun (henkilökohtaisiin projekteihin) TUNI GitLab https://gitlab.tuni.fi/
• Kurssien harjoitusten ja harjoitustöiden tarpeisiin TUNI Kurssi-GitLab https://course-gitlab.tuni.fi/

Kirjautuminen ja käyttöoikeudet

Molempiin GitLab-palveluihin kirjaudutaan TUNI-tunnuksella ja -salasanalla tai www-kertakirjautumista käyttäen Sign in with TUNI account -painikkeella.

TUNI GitLab -kirjautuminen vaatii käyttövaltuuden, joka on haettavissa https://id.tuni.fi/idm/ → Omat käyttövaltuudet → + Hae uutta käyttövaltuutta → Versionhallinta (GitLab) gitlab.tuni.fi. Käyttövaltuus myönnetään automaattisesti noin 15min kuluessa, jonka jälkeen kirjautuminen https://gitlab.tuni.fi/ onnistuu. GitLabin sisäiset käyttäjätunnukset eivät ole käytettävissä, mutta esimerkiksi tutkimusprojekteissa yliopistoyhteisön ulkopuoliset yhteistyökumppanit voivat käyttää palvelua vierailijatunnuksilla. Kaikki GitLabin käyttö vaatii kirjautumisen.

Kurssien harjoituksia ja harjoitustöitä palvelevaan kurssi-GitLab -palveluun luodaan käyttöoikeudet, ryhmät ja projektit Tietotekniikan yksikön Repolainen-työkalulla ja kirjautuminen on sallittu vain ko. käyttöoikeuksia omaaville opiskelijoille ja kurssien henkilökunnalle.

https://gitlab.tuni.fi/ -palveluun luodaan tiedekunta- tai yksikkökohtaisia ryhmiä ja näiden ryhmien alle aliryhmiä ja GitLab-projekteja tarpeen mukaan. IT-helpdesk luo ryhmiä pyynnöstä. GitLab-ryhmän ja -projektin omistaja voi muokata ryhmän/projektin käyttäoikeuksia tarpeen mukaan. Käyttäjän täytyy olla kerran kirjautunut GitLabiin ennenkuin ennen kuin hänelle voidaan antaa oikeuksia.

Kukin käyttäjä pystyy luomaan TUNI GitLab -palveluun myös viisi henkilökohtaista projektia. Henkilökohtaiset projektit on tarkoitettu esimerkiksi versionhallinnan käytön opetteluun. Henkilökohtaisia projekteja EI saa käyttää työkäytössä, koska projektit poistetaan automaattisesti projektin omistajan käyttäjätunnuksen sulkeutuessa.

Otettaessa palvelimeen ensimmäistä kertaa yhteyttä ssh:lla, varmista sen identiteetti tarkistamalla että sen tarjoaman ssh-avaimen fingerprint on oikeellinen.

• gitlab.tuni.fi
  • RSA (MD5): 58:8a:68:9e:14:94:9a:8c:b1:d6:7d:c5:95:42:a8:c7
  • RSA (SHA256): c7lrMIEQSr4Ax8HpO+2BTBxrfkm/Y0ChkxjZXVxLei0
  • ECDSA (MD5): 23:78:4b:12:2d:db:18:f8:79:12:45:73:cd:91:b2:6f
  • ECDSA (SHA256): 2Y/KLKvrdWokEE/V4UTqUlsN6/x9rKtmonpmGBCjuz8
  • ED25519 (MD5): e5:e0:4b:de:ae:e9:1a:34:25:3d:6f:87:43:f4:c4:0d
  • ED25519 (SHA256): WlU+X0lkprysPu/GPdzWZM03hXLpxppCLZHcfkRE3Uk
• course-gitlab.tuni.fi
  • RSA (MD5): 9e:4c:00:8c:95:39:79:c3:d4:5e:4c:2d:6f:2e:1d:82
  • RSA (SHA256): 94s+z486ltYCNEJ6ozAL9FTD3EmB0qoZkYQV+oGIsbo
  • ECDSA (MD5): 51:ce:c2:ab:dc:c9:ba:89:07:73:10:49:08:07:f2:5e
  • ECDSA (SHA256): qQ4046roJYtSU/3V37pCrPr9b0E079QT/EcJl3/VNjY
  • ED25519 (MD5): 89:f9:5b:69:d2:6a:53:ec:e9:82:46:09:6f:ac:80:36
  • ED25519 (SHA256): bLPTnN72Lv3lhIcB/rIEBZXJtnRZU5d8xJVXqyBBDT4

Projektien poistaminen

Kurssien opiskelijoille Repolaisella kurssi-GitLab -palveluun luodut projektit poistetaan automaattisesti, aikaisintaan kuusi kuukautta kurssin päättymisen jälkeen.

Tutkimuksen tarpeisiin tarkoitettuun TUNI GitLab -palveluun tiedekuntien/yksiköiden ryhmien alle luotuja projekteja ei poisteta automaattisesti. Näiden poistamisesta vastaa GitLab-projektin omistaja.

Henkilökohtaiset projektit TUNI GitLab -palvelussa poistetaan automaattisesti välittömästi projektin omistajan TUNI-tunnuksen sulkeutumisen jälkeen. Tämän takia henkilökohtaisia projekteja EI saa käyttää työkäytössä.

GitLab-palvelun tuki ja ylläpito

TUNI tietohallinta vastaa GitLab-palvelun teknisestä ylläpidosta. GitLabin ja versionhallinnan käytön opastus ja käyttäjätuki ovat yksiköiden ja kurssien henkilökunnan vastuulla.

Kurssien opiskelijoiden kurssi-GitLab -palvelun käytössä neuvoo kurssin henkilökunta. IT-helpdesk ei käsittele opiskelijoiden kurssi-GitLabiin liittyviä tukipyyntöjä, vaan pyynnöt tulee tehdä kurssin vastuuhenkilön kautta.

Ohjeita

Tarkempia vinkkejä ja ohjeita GitLabin käyttöön kootaan TUNI GitLabiin tuni-gitlab-instructions -projektin alle. Ohjeita ei välttämättä ole testattu kattavasti eli ohjeita niitä pitää aina soveltaa omaan käyttötarkoitukseen.

Päivitykset

GitLab-palvelut päivitetään tietohallinnon kuukausittaisessa huoltoikkunassa. Major-versiopäivitykset (esimerkiksi version 10.x.y → 11.z.u) pyritään tekemään kesäaikana. Tästä aikataulusta voidaan poiketa esimerkiksi tietoturvaongelmien korjaamiseksi.

Varmuuskopiointi

GitLab-palvelun palvelimista otetaan säännöllisesti varmuuskopiot, mutta tietohallinnolla ei ole mahdollisuutta palauttaa yksittäisiä projekteja varmuuskopioista. Git-versionhallinta toimii hajautetusti ja repositoryn käyttäjien koneille tallentuva klooni sisältää sen kaiken historian, minkä vuoksi yksittäisten projektien palautukseen ei pitäisi olla tarvetta.

IT Helpdesk
0294 520 500
it-helpdesk [at] tuni.fi (it-helpdesk[at]tuni[dot]fi)
helpdesk.tuni.fi