Ustvarimo GitHub račun

Razvito kodo bomo prenesli na GitHub (lahko tudi kakšen drug podoben sistem za arhiviranje, upravljanje verzij in deljenje kode, npr. bitbucket). Pri razvoju rešitev na področju interneta stvari je zaželjeno, da imamo dostop do kode v informacijskem oblaku, kar je posebej priročno pri razvoju algoritmov na več, običajno dislociranih, strojnih platformah.

Postopek za kreiranje GitHub računa, ki ga bomo uporabili na predavanjih je opisan v nadaljevanju.

1. Odpremo spletno stran na naslovu: https://github.com/join

2. Vnesemo svoje podatke (namestno kibernetika19 itd. vnesete svoje ime, npr. janeznovakumfov):

3. Izberemo brezplačen račun, koda bo v našem primeru javna:

4. Odgovorimo na naslednjo anketo, sicer lahko ta korak, t.j. izpolnjevanje ankete, tudi preskočimo:

5. V nadaljevanju moramo potrditi svoj github račun

6. Preverite svojo pošto, ki ste jo navedli ob kreiranju GitHub računa, namesto kibernetika19@gmail.com preverite svoj poštni naslov:

7. Račun potrdite s klikom na gumb ali povezavo v vašem sporočilu, ki ste ga prejeli v "Prejeto":

8. Kliknemo na "Verify email address":

9. Ustvarimo nov repozitorij (kliknemo na »+«, zgoraj, desno nato kliknemo na "New repository"):

10. Vnesemo ime repozitorija, "internet-stvari-um-fov-2019" in opis, "Internet stvari, Univerza v Mariboru, Fakulteta za organizacijske vede, 2018/2019". Na koncu kliknemo na gumb "Create repository":

11. Ogledamo si repozitorij na naslovu: https://github.com/vašeGitHubIme/internet-stvari-um-fov-2019, trenutno je prazen:

12. V cloud9 bomo delali v zavihku "bash" ("Unix shell and command language").

Z ukazom:

$ ls

se izvede izpis vsebine mape oz. direktorija. V našem primeru imamo dve datoteki, primer01.js ter primer02.js V "bash" vrstici je izpisana tudi mapa v kateri se trenutno nahajamo (~/c9sdk/ints):

13. V nadaljevanju moramo v "bash" zavihku ustrezno konfigurirati git (tu ustrezno spremenite kibernetika19 , gmail.com in "kibernetika19"):

$ sudo git config --global user.email "kibernetika19@gmail.com"

$ sudo git config --global user.name "kibernetika19"

Prikaz ukazov v zavihku "bash":

14. Mapo inicializiramo kot git mapo z ukazom:

$ sudo git init 

Prikaz zapisa ukaza v zavihku "bash":

15. Ustvarimo datoteko z opisom repozitorija README.md (README z velikimi črkami). Datoteko ustvarimo v isti mapi kot so primeri. V tej datoteki bomo zapisali kratek opis vsebine repozitorija.

a) Novo datoteko bomo ustvarili s pomočjo dialoga "File/New":

b) V datoteko zapišemo ustrezen opis (Internet stvari, Univerza v Mariboru, Fakulteta za organizacijske vede, Laboratorij za kibernetiko in sisteme za podporo odločanju, študijsko leto 2018/2019.):

c) Datoteko shranimo kot "README.md" (velike črke; md - "markdown" je uporabljen za generiranje html povzetka, ki je viden na strani repozitorija:

16. Datoteka je sedaj shranjena, kar je vidno tudi pri imenu zavihka ("README.md"). Če izvedemo ukaz:

$ ls

se izpišejo dateteke v delovni mapi ints, t.j. primer01.js, primer02.js ter README.md:

17. Vse datoteke v delovni mapi ints dodamo v git. V zavihku "bash" zapišemo naslednji ukaz:

$ sudo git add *

18. Objavimo ("commit") spremembe (uporabimo -m ~ "message"):

 $ sudo git commit -m 'Prvi in drugi primer'

19. Z naslednjim ukazom podamo mesto shranjevanja kode ("origin"); kibernetika19 spremenite v svoje ime ->

$ sudo git remote add origin https://github.com/kibernetika19/internet-stvari-um-fov-2019.git

20. Spremembe potisnemo "push" na GitHub z naslednjim ukazom:

$ sudo git push -u origin master

UN: kibernetika19 (zapišite vaše ime na GitHub)

PWD: 12345678 (zapišite vaše GitHub geslo)

Zapis ukazov (v točkah 17. - 20.) v zavihku "bash" je prikazan na naslednjih dveh slikah:

21. Uspešnost prenosa kode preverimo z ogledom strani na GitHub (v brskalnik vnesite svoj naslov in preverite, ali se je koda prenesla; v našem primeru vidimo, da so v repozitoriju kibernetika19 datoteke: primer01.js, primer02.js ter README.md -> https://github.com/vašeGitHubIme/internet-stvari-um-fov-2019):

22. Povezavo prosim pošljite na naslov: andrej.skraba@gmail.com

Koraki za prenos kode na GitHub

Pri nadaljnjih prenosih kode bomo uporabili naslednje ukaze v zavihku "bash":

a) Pregledamo ali so v mapi prave datoteke z ukazom ls:

$ ls

b) Dodamo datoteke:

$ sudo git add *

c) Zapišemo datoteke (izvedemo "commit"):

$ sudo git commit -m 'Komentar, npr. Primeri z dne tor. 9.4.2019'

e) Datoteke potisnemo na GitHub:

$ sudo git push -u origin master

UN: kibernetika19 (zapišite vaše ime na GitHub)

PWD: 12345678 (zapišite vaše GitHub geslo)

f) Preverimo, ali so datoteke prenesene na GitHub z ogledom strani: https://github.com/vašeGitHubIme/internet-stvari-um-fov-2019

V pomoč pri delu lahko uporabimo "GIT Cheat Sheet" -> https://education.github.com/git-cheat-sheet-education.pdf