Harkkojen palautusohjeet

Kurssilla palautetaan yhteiset harjoitustyöt, henkilökohtainen harjoitustyö ja sen raportti. Kurssityöt sekä raportti tehdään omaan Gitlab repositorioon (JAMK Gitlab). Opettajalle palautukseen käytämme kuitenkin vielä Optimaa, koska parempaa vaihtoehtoa palautuslaatikoille ei tällä hetkellä ole.

Optimaan palautetaan teksitiedosto (.txt) joka sisältää kaksi linkkiä: toinen johtaa suoraan hostattuun webbisivuun, sekä toinen joka johtaa lähdekoodiin. Sivut hostataan Gitlabin Pages toimintoa käyttäen, ja lähdekoodi tulee löytyä myös Gitlab-repositoriosta.

Mikäli sinulle ei ole GIT ja Gitlab vielä tuttu, niin nämä olisi tarkoitus ottaa itse haltuun heti alkuvaiheessa. Alempana löytyy vähän apua.

Jos tulee aivan ylitsepääsemättömiä ongelmia Gitlabin tai Gitlab pagesin kanssa, voidaan käyttää myös studentin S-palvelinta. Tämä voi vaikuttaa arvostelussa pyöristystilanteissa.

Mitä kaikkea kuuluu palauttaa?

• Viikkoharkat
• Henkilökohtainen lopputyö
• Lopputyön raportti

GIT + Gitlab + Gitlab Pages

Että opettaja pystyy tarkistamaan kurssityöt, pitää ne saada verkkoon näkyviin. Gitlabin avulla saamme sekä lähdekoodin versiohallintaan (GIT) sekä hostattua harkat ihan verkkosivuina. Näiden työkalujen opiskelu ja käyttöönotto on opiskelijan vastuulla.

GIT

GIT on ohjelmistotaloissa standardityökalu versionhallinnalle. Versionhallinta on ehdoton kun työskennellään kollektiivisesti muiden kehittäjien kanssa, ja yksinkin työskennellessä erittäin hyödyllinen.

JAMK:illa on yhden opintopisteen non-stop toteutuksessa GIT-kurssi jonka voi suorittaa milloin vain ja laittaa vapaasti valittaviin opintoihin. Kurssi olisi erittäin hyödyllinen ottaa, sillä se opastaa suoraan GIT:in sekä Gitlabin käyttöön.

Kurssi löytyy täältä: https://gitlab.labranet.jamk.fi/sahka/gitlab-opintojakso

Muita apuja GIT:in opiskeluun:

• https://youtu.be/HVsySz-h9r4
• https://youtu.be/7p0hrpNaJ14
• https://rogerdudler.github.io/git-guide/
• https://ohshitgit.com/

Gitlab

Gitlab on GIT-versionhallinnan päälle rakennettu ohjelmistotuotannon projektinhallinta-palvelu. Se sisältää GIT-repositorion lisäksi paljon muitakin ominaisuuksia mitä ohjelmistotuotannossa käytetään. Meille tällä kurssilla riittää että voimme tehdä sinne oman koodirepositorion ja hostata webbisivuja sen avulla.

• https://docs.gitlab.com/ee/gitlab-basics/
• https://youtu.be/enMumwvLAug

Gitlab Pages

Kun meillä on hallussa GIT:in peruskäyttö sekä koodirepositorio Gitlabista, meidän tarvitsee vielä saada sivut hostatuksi. Tähän auttaa Gitlabin Pages toiminto.

Gitlab-pages vaatii .gitlab-ci.yml tiedoston projektin juureen:

pages:
  stage: deploy
  script:
  - mkdir .public
  - cp -r * .public
  - mv .public public
  artifacts:
    paths:
    - public
  only:
  - pages
  tags:
  - general

https://about.gitlab.com/product/pages/

Alla opettajan ohjeistus viime vuoden toteutuksesta, kuinka Gitlab Pages aktivoidaan: