Show page

Differences

This shows you the differences between two versions of the page.

--- so:teme:folosire-gitlab [2017/02/26 13:15]
razvan.crainea [Creare proiect nou]
+++ so:teme:folosire-gitlab [2022/03/11 20:00] (current)
ionut.mihalache1506
@@ Line 78: / Line 78: @@
   - Adăugați URL-ul specific repo-ului de teme de SO ce va conține scheletele de cod pentru fiecare temă și testele:
     - click pe ''Import existing repository by URL''
-    - adăugați link-ul https://github.com/systems-cs-pub-ro/so-assignments.git
+    - adăugați link-ul https://github.com/systems-cs-pub-ro/so.git
+    - în directorul assignments vor fi toate fișierele de care aveți nevoie
   - Click ''Create project''.
   - După ce proiectul a fost creat, selectați tab-ul ''Members'' din cadrul acestui proiect (left side)
-    - adăugați următorii useri: Mihai Bărbulescu (3172), Adrian Șendroiu (1701), Răzvan Tudor Crainea, Costin Lupu, Elena Alexandra Săndulescu, Vladimir Diaconescu, Ioana Ciornei.
+    <hidden>- adăugați useri corespunzători: Mihai Bărbulescu (3172), Adrian Șendroiu (1701), Răzvan Tudor Crainea, George Muraru, Adrian-Mirel LUŢAN, Gabriel BERCARU (78505), Ionuț MIHALACHE (87724)</hidden>
-    - dați-le dreptul de access ''Reporter''
+    - adăugați useri corespunzători(cineva din subechipa de teme pe baza username-ului de pe Microsoft Teams)
+    - dați-le dreptul de access ''Maintainer''
     - click pe ''Add users to project''
@@ Line 97: / Line 99: @@
 Dacă aveți doar 1-multi în acest repo, pentru a adăuga 2-minishell puteți proceda astfel:
-<code>
+<code bash>
-$ git clone ...
+git clone ...
-$ cd l3-so-assignments
+cd l3-so-assignments
-$ mkdir -p 2-minishell/
+mkdir -p 2-minishell/
-$ cd 2-minishell/
+cd 2-minishell/
-$ wget http://ocw.cs.pub.ro/courses/_media/so/teme/2-skel-linux.zip
+wget http://ocw.cs.pub.ro/courses/_media/so/teme/2-skel-linux.zip
-$ unzip 2-skel-linux.zip
+unzip 2-skel-linux.zip
-$ rm -fr 2-skel-linux.zip
+rm -fr 2-skel-linux.zip
-$ wget http://elf.cs.pub.ro/so/res/teme/tema2-checker-lin.zip
+wget http://elf.cs.pub.ro/so/res/teme/tema2-checker-lin.zip
-$ unzip tema2-checker-lin.zip # testele sunt dezarhivate în folderul tema2-checker-lin/
+unzip tema2-checker-lin.zip # testele sunt dezarhivate în folderul tema2-checker-lin/
-$ rm -fr tema2-checker-lin.zip
+rm -fr tema2-checker-lin.zip
-$ mkdir checker-lin
+mkdir checker-lin
-$ mv tema2-checker-lin/* checker-lin/
+mv tema2-checker-lin/* checker-lin/
-$ rmdir tema2-checker-lin
+rmdir tema2-checker-lin
-$ cd ../
+cd ../
-$ git add 2-minishell/
+git add 2-minishell/
-$ git commit -m "add Linux skeleton and tests"
+git commit -m "add Linux skeleton and tests"
-$ git push
+git push
 </code>
@@ Line 144: / Line 146: @@
 Pentru mai multe informații despre script, urmăriți [[https://github.com/systems-cs-pub-ro/so-assignments/blob/master/README.md | README-ul]] asociat repo-ului public de pe GitHub.
-===== Folosire Git =====
+ ===== Folosire Git =====
 Acum vă puteți clona local (puteți clona pe mai multe mașini, însă trebuie să aveți cheia privată corespunzătoare cheii publice de pe GitLab) acest repo folosind link-ul pentru SSH. Exemplu:
@@ Line 163: / Line 165: @@
   * https://try.github.io/levels/1/challenges/1
   * http://gitimmersion.com/
+===== Mic tutorial de folosire git =====
+Pentru a înțelege mai ușor cum și mai ales de ce e bine să folosim ''git'', e cel mai bine să urmărim un exemplu concret. Scenariul propus este de fapt flow-ul de lucru pe care îl urmați la orice temă (nu doar la SO): sunt singur, lucrez la temă, am nevoie de un singur branch și nu vreau să pierd o variantă, să zicem incompletă, dar corectă, de temă.
+<note>
+Pentru acest tutorial, vom lua exemplu o temă de la Structuri de date la care trebuie să se implementeze o listă înlănțuită în C cu toate operațiile necesare (inițializare listă, adăugare element, ștergere element, sortare listă).
+</note>
+<note tip>
+Dacă vreți să faceți și ceva practic și să învățați //"git by doing"// cea mai bună resursă este http://gitimmersion.com/
+Pentru ce vă trebuie la SO primele 26 de laboratoare sunt cele mai bune.
+</note>
+=== Config ===
+Până a ajunge la discuția despre cum să folosim git-ul corect, este bine să aducem în discuție o modalitate prin care putem configura git-ul local. Git-ul vine cu o opțiune numită ''git config'' care ne permite să setăm câteva variabile care controlează modul în care git funcționează. Aceste variabile pot stocate în diverse fișiere pe sistemul nostru, însă ce ne interesează în acest moment este fișierul ''~/.gitconfig'' deoarece aici sunt păstrate date pentru utilizatorul curent autentificat în sistem (''~'') care vor fi văzute de-a lungul tuturor repo-urilor ale acestuia. Mai multe detalii se pot afla [[https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup|aici]].
+Este important să setăm numele și email-ul nostru în git deoarece fiecare commit va conține aceste informații. Pentru a face acest lucru urmărim următorii pași:
+<code bash>
+student@vagrant:~$ git config --global user.name "Mr. Perfect"
+student@vagrant:~$ git config --global user.email mr@perfect.com
+</code>
+Aceste date pot fi modificate ulterior folosind aceleași comenzi.
+=== Simple tutorial ===
+Acum că avem numele și email-ul setate, putem trece mai departe. Primul pas în lucrul cu git este să inițializăm un repository local în directorul în care vom păstra toate fișierele din temă.
+<code bash>
+student@vagrant:~$ git init
+</code>
+Vrem să asociem repository-ul nostru local cu unul pe server. Fie că folosim Gitlab, Github, Bitbucket sau orice altă variantă, pașii de urmat sunt neschimbați. Repository-ul precizat trebuie să existe de dinainte.
+<code bash>
+student@vagrant:~$ git remote add origin link_to_online_repo
+</code>
+Pe git se vor ține **doar fișierele sursă**, niciodată cele obiect sau executabile, deoarece acestea pot fi generate de fiecare dată când avem nevoie, pe ce mașină avem nevoie foarte simplu dacă avem un fișier ''Makefile'' cu reguli corespunzătoare.
+Pentru a fi siguri că nu adăugăm din greșeală fișiere inutil în istoric, e necesar să avem în acest director un fisier ''.gitignore'' pe care îl adăugăm. În acest fișier se scriu reguli, una pe rând, sub formă de expresii regulate, în care precizăm ce fișiere **nu** vrem să fie adăugate în acest repo.
+După ce am terminat de editat fișierul, îl adăugăm în repository folosind comanda ''add''. E util ca fiecare schimbare pe care o comitem să fie asociată cu un mesaj **scurt și la obiect** pentru a ști ulterior **exact** ce schimbare a fost produsă cu acel commit.
+<code bash>
+student@vagrant:~$ touch .gitignore
+# evităm adăugarea fișierelor obiect
+student@vagrant:~$ echo "*.o" >> .gitignore
+student@vagrant:~$ git add .gitignore
+student@vagrant:~$ git commit -m "added .gitignore file to repo"
+</code>
+Pentru a publica schimbările locale și pe server, folosim comanda ''push''.
+<code bash>
+student@vagrant:~$ git push origin master
+</code>
+<note>
+De obicei, în cadrul unui proiect mai mare, e recomandat ca fiecare membru să lucreze pe un branch al lui până când e sigur că ceea ce va livra este și ceea ce se dorește să intre în producție, însă pentru scenariul descris în acest tutorial, este OK să folosiți branch-ul default numit **master** ca fiind al vostru.
+</note>
+În momentul în care ne apucăm de temă, ne vom gândi întotdeauna care sunt milestone-urile pe care le atingem pe parcursul ei. Spre exemplu, putem împărți o tema noastră în următoarele etape:
+	* definirea structurilor necesare rezolvării temei (cel puțin în faza preliminară, putem face modificări asupra lor ulterior)
+	* citirea și parsarea datelor de intrare (citirea operațiilor care trebuie efectuate asupra listei, pe rând)
+	* rezolvarea primelor 5 teste (toate acoperă diverse cazuri legate de adăugarea unui element în listă: la început, la mijloc, la final)
+	* rezolvarea următoarelor 5 teste (toate acoperă diverse cazuri în care se șterg elemente din listă: primul element, ultimul element, element după valoare)
+	* rezolvarea următoarelor 5 teste (referitoare la sortarea unei liste simplu înlănțuite)
+	* rezolvarea următoarelor 3 teste (mixte, adăugări, ștergeri, sortări, iar adăugări etc)
+	* rezolvarea următoarelor 2 teste (referitoare la eliberarea corectă a memoriei în momentul ștergerii unuia sau mai multor elemente din listă)
+	* eventuale modificări de coding-style (după nevoie)
+Este bine ca după fiecare pas enumerat să salvăm versiunea de cod din mai multe motive:
+  - Putem, din neatenție, oboseală sau grabă, să stricăm ce avem până în momentul de față și să ne vină prea greu să revenim la varianta bună de cod
+  - Organizare mai bună
+  - **În cazul lucrului în echipă**: se poate vedea cine a făcut o anumită modificare a codului
+Așadar, după fiecare pas trebuie să publicăm schimbările. Vom folosi următoarele comenzi:
+<code bash>
+# toate fișierele modificate
+student@vagrant:~$ git add changed_file1 changed_file2
+# să zicem că am trecut de primele 5 teste
+student@vagrant:~$ git commit -m "first 5 tests working"
+student@vagrant:~$ git push origin master
+</code>
+=== Am greșit, ce fac? ===
+Am continuat cu rezolvarea temei și mi-am dat seama că ceva nu e în regulă și aș vrea să revin la o versiunea în care mergeau doar primele 5 teste. Vom folosim mai întâi comanda git log
+<code bash>
+student@vagrant:~$ git log
+commit ca82a6dff817ec66f44342007202690a93763949
+Author: Mr. Perfect <mr@perfect.com>
+Date:   Tue Feb 19 16:52:11 2019 -3000
+    first 10 tests working
+commit ca82a6dff817ec66f44342007202690a93763969
+Author: Mr. Perfect <mr@perfect.com>
+Date:   Mon Feb 18 23:52:11 2019 -3000
+    first 5 tests working
+commit ca82a6dff817ec66f44342007202690a93763959
+Author: Mr. Perfect <mr@perfect.com>
+Date:   Mon Feb 18 22:52:11 2019 -3000
+    parsed input
+commit ca82a6dff817ec66f44342007202690a93763949
+Author: Mr. Perfect <mr@perfect.com>
+Date:   Mon Feb 18 21:52:11 2019 -3000
+    added .gitignore file
+</code>
+<note>
+În acest caz, commitul căutat este  ''ca82a6dff817ec66f44342007202690a93763969''
+</note>
+Pentru a ne întoarce la această variantă folosim comanda:
+<code bash>
+student@vagrant:~$ git revert ca82a6dff817ec66f44342007202690a93763969
+</code>
+=== Git tags ===
+Principalul motiv pentru care folosim git este să versionăm codul pe care îl scriem. Așa cum am precizat mai sus, atunci când lucrăm în echipă, este de preferat ca fiecare membru să lucreze pe un branch, iar ulterior codul să fie unificat prin operația de ''merge''.
+Până acum am vorbit de ''commit'' ca fiind modul prin care diferențiem o versiune de cod de alta. Acest lucru este de regulă folosit în contextul unui branch. Pentru un întreg repository folosim ''tags'' pentru a versiona codul. Pentru mai multe detalii în ceea ce privește tag-urile folosite în lumea git, tipuri de tag-uri și modul în care pot fi create și gestionate, consultați pagina de aici [[https://git-scm.com/book/en/v2/Git-Basics-Tagging|aici]].
 ===== Resurse =====
   * [[https://docs.joyent.com/jpc/getting-started-with-your-joyent-cloud-account/generating-an-ssh-key/generating-an-ssh-key-manually/manually-generating-your-ssh-key-in-windows|Generare cheie SSH Windows Putty]]

Informații generale SO

Informații SO 2021-2022

Laboratoare

Curs

Accesibile pe GitHub, în organizația Open Education Hub, cu deployment prin Docusaurus.

Cursuri vechi

Teme

so/teme/folosire-gitlab.1488107730.txt.gz · Last modified: 2017/02/26 13:15 by razvan.crainea

Show page Old revisions

Media Manager Back to top