control de versions de codi

1. Que es el control de versions i per que l’usem?

Git es un sistema de control de versions distribuït que permet registrar tots els canvis que es fan al codi al
llarg del temps. Cada canvi queda guardat amb un missatge descriptiu, qui l’ha fet i quan.

2. Context del projecte

El repositori del projecte LadyUp esta allotjat a GitHub amb el compte equip22, creat amb el correu
compartit de l’equip. Aixo permet que qualsevol company pugui accedir, clonar i contribuir al repositori
sense necessitat de crear comptes individuals.

3. Procediment pas a pas

Pas 1 – Configurar Git

Configurem el nom i email que apareixera als commits:

git config --global user.name "nom" git config --global user.email "email"

Pas 2 – Crear el repositori local

Creem la carpeta del projecte i inicialitzem el repositori:

mkdir projecte-ladyup cd projecte-ladyup git init git branch -m main

Pas 3 – Primer commit (README)

Creem el fitxer README.md i fem el primer commit:

vim README.md git add README.md git commit -m "Afegit README amb descripcio del projecte
LadyUp"

Pas 5 – Branca feature/ldap

Creem una branca nova per afegir l’estructura base LDAP:

git checkout -b feature/ldap nano base.ldif git add base.ldif git commit -m "Afegida
estructura base LDAP (ou=usuaris, ou=grups)" git checkout main git merge feature/ldap

Pas 6 – Branca feature/vagrantfile

Creem una branca nova per afegir el Vagrantfile del projecte:

git checkout -b feature/vagrantfile cp ~/vagrant23/Vagrantfile
~/projecte-ladyup/Vagrantfile git add Vagrantfile git commit -m "Afegit Vagrantfile amb
configuracio de totes les VMs del projecte" git checkout main git merge
feature/vagrantfile

Pas 7 – Historial de commits

Verifiquem l’historial complet amb branques:

git log --oneline --all --graph

Pas 8 – Pujar a GitHub

Connectem el repositori local amb GitHub i pugem el codi. Per autenticar-nos usem un Personal Access
Token generat a https://github.com/settings/tokens:

git remote add origin https://github.com/equip22/projecte-ladyup.git git config --global
credential.helper store git push -u origin main

4. Acces compartit al repositori

El repositori es accessible per tot l’equip gracies al compte equip22 creat amb el correu compartit de
l’equip. Aixo permet que qualsevol company pugui clonar el repositori amb:

git clone https://github.com/equip22/projecte-ladyup.git

Aixo creara una carpeta projecte-ladyup amb tots els fitxers i l’historial complet.

URL del repositori: https://github.com/equip22/projecte-ladyup

Per obtenir els canvis mes recents un cop ja clonat:

cd projecte-ladyup git pull origin main

5. Com pujar nous canvis des de la terminal

GitHub no permet autenticacio amb usuari i contrasenya des de la terminal. Cal usar un Personal Access
Token (PAT). Com que el compte es compartit (equip22), l’equip ha de compartir el mateix token o
generar-ne un de nou.

Pas A – Generar el Personal Access Token

1. Iniciar sessio a GitHub amb el compte equip22

2. Anar a:
https://github.com/settings/tokens/new

3. Posar un nom descriptiu (ex: token-equip22)

4. Marcar el checkbox ‘repo’ (dona acces complet als repositoris)

5. Clicar ‘Generate token’
6. IMPORTANT: Copiar i guardar el token, nomes es veu una vegada!

ATENCIO: Si es perd el token cal generar-ne un de nou a la mateixa URL.

Pas B – Guardar les credencials permanentment

Per no haver de posar el token cada vegada, executar la següent comanda un cop. La primera vegada que es faci push demana usuari i token. A partir d’aqui les credencials queden guardades
automaticament.

git config --global credential.helper store

Pas C – Flux de treball per pujar canvis

Aquest es el flux que ha de seguir qualsevol company per pujar canvis:

# 1. Crear una branca nova per la funcionalitat

git checkout -b feature/nom-funcionalitat

# 2. Fer els canvis i afegir-los

add nom-fitxer

# 3. Fer el commit amb missatge descriptiu

git commit -m "Descripcio clara del que s'ha fet"

# 4. Tornar a main i fusionar

git checkout main git merge feature/nom-funcionalitat

# 5. Pujar a GitHub

git push origin main

Username: equip22 Password: (enganxar el Personal Access Token)

6. FORMACIÓ

Els conceptes apresos al curs s’han aplicat directament a la gestio del repositori del projecte LadyUp:

-Inicialitzacio de repositoris amb git init

-Gestio de commits amb missatges descriptius

-Creacio i gestio de
branques (branches)

-Fusio de branques amb git merge

-Sincronitzacio amb repositori remot a Els conceptes apresos al curs s’han aplicat directament a la gestio del repositori del projecte LadyUp: