GitLab v dátovom sklade mesta Prešov

Na správu projektov v dátovom sklade mesta Prešov sa používa GitLab. Slúži na verzionovanie kódu, správu dokumentácie, spoluprácu vývojárov a projektové riadenie.

Postup registrácie do GitLabu mesta Prešov

1. Otvorte GitLab mesta Prešov

Prejdite na adresu https://gitlab.presov.sk (opens in a new tab).

2. Kliknite na možnosť „Datahub Prešov“

Kliknutím budete presmerovaní na stránku mestského prihlasovania auth.presov.sk.

3. Vytvorte si účet v Datahube

v spodnej časti okna kliknite na Zaregistrovať sa,
vyplňte požadované údaje,
potvrďte registráciu,
zapíšte si svoje unikátne ID (6-miestny kód).

4. Kontaktujte IT oddelenie

Pošlite e-mail na adresu it@presov.sk s krátkou správou:

Dobrý deň,

prosím vás o:

- overenie mojej identity v Datahube: <vaše unikátne ID>
- úpravu môjho používateľského mena v GitLabe: <vami zvolené používateľské meno>

Ďakujem.

Príklad

Dobrý deň,

prosím vás o:

- overenie mojej identity v Datahube: JRXEA2
- úpravu môjho používateľského mena v GitLabe: jan-novak

Ďakujem.

5. Doplňte svoj profil o povinné údaje

Po potvrdení e-mailom z adresy it@presov.sk o overení vašej identity:

vráťte sa na https://gitlab.presov.sk (opens in a new tab) a prihláste sa,
GitLab vás automaticky presmeruje na úpravu profilu,
skontrolujte pole Full Name, prípadne ho upravte,
do poľa Email zadajte e-mailovú adresu, na ktorú chcete dostávať notifikácie,
po uložení zmien vám príde overovací e-mail,
kliknutím na overovací odkaz potvrdíte e-mailovú adresu.

6. Začnite GitLab používať

Po overení e-mailovej adresy môžete GitLab plnohodnotne používať.

štandardne uvidíte len verejné skupiny a projekty,
pre priradenie do skupín alebo projektov, prípadne pre vytvorenie nového projektu, kontaktujte it@presov.sk.

Ďalšie informácie k procesu registrácie

Tento proces s manuálnym overením identity a úpravou používateľského mena je dočasný a slúži ako predpríprava na digitálne overenie identity pomocou občianskeho preukazu.

Postup odovzdávania dokumentácie do GitLabu mesta Prešov

Projekty v GitLabe majú jednu hlavnú vetvu, spravidla vetvu main, do ktorej sa dostáva len schválený obsah. Všetky úpravy sa robia vo vedľajších vetvách.

Vedľajšia vetva

slúži na konkrétnu úlohu alebo pre konkrétneho používateľa a je dočasná,
po dokončení úlohy sa:
- vedľajšia vetva po revízii a schválení zlúči (merge) do vetvy main,
- vedľajšia vetva sa následne zmaže.

Vytvorenie vedľajšej vetvy

👉 Code → Branches → New branch → Branch name → Create from branch-name → Create branch

Po vytvorení:

v hornej časti pri súboroch vidíte názov aktívnej vetvy,
pracujte vždy vo vedľajšej vetve, nie v main,
súbory upravujete cez Edit → Open in Web IDE.

Postup práce vo vedľajšej vetve

1. Úprava alebo pridanie súboru

kliknite na súbor → Edit → Open in Web IDE

Pridanie nového súboru:

+ → New file
- vytvoríte nový súbor,
- ručne napíšete obsah (text, kód, odkazy, poznámky).

Príklady:

README.md – Markdown,
index.html – HTML,
notes.txt – poznámky.

Nahratie existujúceho súboru:

Upload,
nahráte súbor z počítača.

Príklady:

obrázky (.png, .jpg),
dokumenty (.pdf, .docx),
archívy (.zip).

2. Commit zmien

kliknite na Source Control (Ctrl + Shift + G),
vyplňte Commit message – stručný popis zmeny, napr. Pridanie príručky pre používateľa,
kliknite na Commit and push to branch-name,
zmena je uložená, ale hlavná vetva main ostáva nezmenená.

3. Merge Request (žiadosť o zlúčenie)

Vráťte sa do projektu a vytvorte merge request:

👉 Code → Merge requests → New merge request → Select source branch → Select target branch → Compare branches and continue

Otvorí sa editovacie okno merge requestu:

vyplňte Title, napr. Finalizácia používateľskej dokumentácie,
vyplňte Description (voliteľné),
nastavte Assignee (spravidla zamestnanec mesta Prešov zodpovedný za projekt),
nastavte Reviewer (voliteľné),
zaškrtnite:
- Delete source branch when merge request is accepted,
- Squash commits when merge request is accepted,
kliknite na Create merge request.

Po schválení sa zmeny zlúčia do hlavnej vetvy.

Streets API