Stretnutie 1

2022/02/17

GitLab

GitLab je mnohoúčelová platforma pre:

  • verzovací nástroj pre Git, kde si tím môže zdieľať zdrojové kódy projektov

  • sledovanie incidentov — issue tracking — úlohy/chyby/problémy, ktoré treba v projekte vyriešiť

  • continuous integration / continuous delivery (CI/CD) — automatizované nasadzovanie projektov na servery a ich doručovanie zákazníkovi

Note
 Každý účastník má login a heslo do prírodovedeckého Gitlabu na https://gitlab.science.upjs.sk/.

Zakladanie projektov

Každý účastník má svoju vlastnú skupinu (group), teda priestor, v ktorom si môže do vôle navytvárať vlastné projekty.

Tip
 Podrobnosti uvádza dokumentácia GitLabu.
Example 1. Osobné projekty

Používateľ novotnyr má vlastnú skupinu novotnyr a môže si vytvoriť vzorový osobný projekt (personal project) https://gitlab.science.upjs.sk/novotnyr/sandbox

Do tohto projektu nemá prístup nik, okrem zakladateľa.

Adresa projektu

Projekt má svoje sídlo v GitLabe a zároveň cestu k repozitáru.

Ukážkový osobný projekt:

Sídlo v GitLabe

https://gitlab.science.upjs.sk/novotnyr/sandbox

Cesta k repozitáru

https://gitlab.science.upjs.sk/novotnyr/sandbox.git

Správcovia balíčkov

Každý rozumný operačný systém má svojho správcu balíčkov (package manager).

Note
 Správca balíčkov automatizuje inštaláciu softvéru.

Namiesto hľadania projektového webu, sťahovania inštalačky, klikania Next v sprievodcovi sta použije jediný príkaz, ktorý nainštaluje celý projekt.

Špeciálne je to vidno pri závislostiach: ak napríklad Tomcat potrebuje Javu, pri požiadavke na inštaláciu Tomcatu sa stiahne a nainštaluje aj Java.

Operačné systémy majú svoje obľúbené inštalácie:

Linux

apt, yum, pacman

Windows

Chocolatey

MacOS

Homebrew

Chocolatey

Chocolatey umožňuje na Windowse nainštalovať obľúbené balíčky.

Nainštalujte ho podľa návodu kde sa využíva PowerShell.

Napr. git možno nainštalovať:

choco install git

IntelliJ IDEA

IntelliJ IDEA je najpopulárnejšie prostredie pre vývoj aplikácií pre Java platformu.

K dispozícii sú dve verzie:

  • bezplatná komunitná edícia (Community Edition)

  • platená edícia s pokročilými vlastnosťami (Ultimate Edition)

Tip
 Študenti majú nárok na bezplatný prístup k Ultimate Edition. Podrobnosti sú v licenčných podmienkach.

Nainštalujte:

choco install intellijidea-community

Inštalácia git

Git možno na lokálny stroj nainštalovať:

  • pomocou správcu balíčkov

  • ako lokálnu inštaláciu v IntelliJ IDEA. V nastaveniach zvoľte v strome Version Control > Git a doinštalujte Git.

Inštalácia Javy

Git možno na lokálny stroj nainštalovať:

  • pomocou správcu balíčkov

  • ako lokálnu inštaláciu v IntelliJ IDEA. Pri vytváraní projektu zvoľte z rozbaľovacieho menu Project SDK možnosť Download JDK a stiahnite príslušnú verziu.

Vytvorenie projektu a prepojenie s GitLabom

  1. Vytvorte nový projekt

  2. Z menu VCS zvoľte Enable Version Control Integration a vyberte Git

  3. Komitnite zmeny: Commit zasiela zmeny do lokálneho repozitára.

  4. Pomocou Push dostanete zmeny z lokálneho repozitára na vzdialený repozitár. Pomocou Define Remote definujte vzdialené úložisko na GitLabe. Uveďte cestu k repozitáriu (tú s príponou git)

Sledujte, ako sa zmeny objavili na serveri pomocou prehliadača na webe projektového GitLabu.

Tip
 Nacvičte si prácu s Gitom v IntelliJ IDEA podľa manuálu.

Dokumentácia projektu

Projektová dokumentácia — referenčná príručka, súbory README, kostra webu — sa vytvára v jednom z viacerých textových formátov.

Výhodou je:

  • žiadna potreba pre špeciálny editor - tvorí sa v textovom editore

  • zjednodušená syntax — netreba ovládať HTML

  • jednoduchá verzovanosť v Gite

  • možnosť generovať výstupy vo viacerých formátoch: HTML, PDF, ePub

Typické technológie:

  • Markdown — minimalistický zápis ako v e-mailoch

  • AsciiDoc — podobný štýl ako Markdown, mnoho pokročilých vlastností, slúži na písanie rozsiahlych dokumentácií

Asciidoc

AsciiDoc je formát s textovým zápisom pre rozsiahle formátované dokumenty.

Note
 Pozrite si syntax v ťaháku na projektovom webe.
Tip
 Doinštalujte si do IntelliJ IDEA plugin pre AsciiDoc. Použite Preferences > Plugins > Asciidoc. Získate podporu pre náhľad v HTML, zvýrazňovanie syntaxe a klávesové skratky.

  1. Vytvorte si v projekte súbor README.adoc

  2. Komitnite a pushnite do projektu.

  3. Sledujte, ako vám GitLab automaticky vyrenderuje README.adoc do HTML podoby.

Note
 Neskôr si ukážeme, ako je možné pomocou AsciiDoc vytvárať celý projektový web, a to automaticky po každom pushnutí.
>> Home