Git Push- en Pull-tutorial

Pushen naar GitHub

Laten we beginnen met het idee van pushen. 

De command line gebruiken om naar GitHub te pushen

De beste manier om te leren is door te oefenen, dus we lopen de stappen door.

1. Een nieuwe repository aanmaken

Je moet een nieuwe repository aanmaken en op het plusteken klikken.

Vul alle vereiste gegevens in, zoals de naam van de repository, beschrijving en maak de repository deze keer ook openbaar omdat dit gratis is.

2. Open je Git Bash

Git Bash kun je hier downloaden. Het is een shell om met het besturingssysteem te werken en volgt UNIX-commando’s.

3. Maak je lokale project aan op je desktop en ga naar je huidige werkdirectory

pwd staat voor ‘print working directory’ en toont de huidige directory.

Ga naar het specifieke pad op je computer met cd 'path_name'. De cd-commando’s staan voor ‘change directory’ en worden gebruikt om te wisselen naar de werkdirectory in je besturingssysteem. Om je bestand te lokaliseren moet 'path_name', bijvoorbeeld C:/Users/Dell/Downloads/FaceDetect-main, worden opgegeven. Met dit commando vind je het vereiste bestand waar je mee wilt werken.

4. Initialiseer de git-repository

Gebruik git init om de repository te initialiseren. Dit maakt een nieuwe lege repository aan en er wordt een verborgen map .git aangemaakt in de hoofdmap van je project, waar alle revisie-informatie op één plek wordt bewaard.

5. Voeg de bestanden toe aan de nieuwe lokale repository

Gebruik git add . om alle bestanden in de huidige directory te stagen. Gebruik git status om te zien welke bestanden zijn gestaged en klaar zijn voor je eerste commit.

6. Commit de gestagede bestanden in je lokale repository met een commitbericht

Je kunt een commitbericht maken met git commit -m 'your message', waarmee de gestagede wijzigingen in de lokale repository worden vastgelegd. git commit gebruikt -m als vlag voor een bericht om commits te voorzien van een inhoudelijke beschrijving. Schrijf het bericht als een gebiedende zin van maximaal 50 tekens en beschrijf "wat er is veranderd" en "waarom de verandering is doorgevoerd".

7. Kopieer de URL van je remote repository van GitHub

De HTTPS of URL wordt gekopieerd vanuit je GitHub-account; dat is de locatie van de remote repository.

8. Voeg de gekopieerde URL toe als remote, zodat je lokale content daarheen wordt gepusht

git remote add origin 'your_url_name'

In de bovenstaande code is origin de naam van de remote en is de remote-URL "https://github.com/Olivia-Smithcoder100/FaceDetection.git". In dit geval is de remote GitHub, en GitHub levert de URL om aan de remote repository toe te voegen.

9. Push de code in je lokale repository naar GitHub

git push -u origin main wordt gebruikt om lokale content naar GitHub te pushen.

In de code is origin de standaardnaam van je remote repository en staat de vlag -u voor upstream, wat gelijkstaat aan -set-upstream. main is de branch. name.upstream is de repository waarvan we het project hebben gekloond.

Authenticeer met je GitHub-inloggegevens. Let op dat GitHub geen wachtwoordauthenticatie meer ondersteunt voor Git-bewerkingen. Je moet in plaats daarvan een personal access token (PAT) of SSH-sleutel gebruiken.

10. Bekijk je bestanden in je repository die op GitHub wordt gehost

Je kunt het bestand nu op GitHub zien staan.

GitHub Desktop gebruiken om naar GitHub te pushen

GitHub Desktop is beschikbaar voor elk besturingssysteem en biedt een GUI (Graphical User Interface) om je lokale content vanuit je lokale repository naar een remote repository zoals GitHub te pushen.

Open je GitHub-account in je browser; het proces om een nieuwe repository aan te maken, oftewel stap 1, is hetzelfde als hierboven in "De command line gebruiken om naar GitHub te PUSHEN".

1. Klik op "Set up in a Desktop"

Klik op de knop zoals hieronder getoond; er verschijnt een pop-up en klik dan op "Open GitHub desktop".

2. Clonen in GitHub Desktop

Je kunt op de knop Clone klikken, zoals hieronder te zien is.

Na het clonen wordt er een map aangemaakt op je computer waar ook een verborgen map .git aanwezig is.

3. Kopieer alle benodigde bestanden van je computer naar de clone-map op je computer

Kopieer alle benodigde bestanden, afbeeldingen, README-bestanden, enz. naar de clone-map.

4. Ga naar GitHub Desktop en commit naar main

Je ziet dat de bestanden die je aan de clone-map hebt toegevoegd ook in GitHub Desktop zichtbaar zijn. Schrijf tot slot je bericht en klik op Commit to main.

5. Publiceer de branch in GitHub Desktop om al je bestanden naar GitHub te uploaden

Klik op Publish Branch om al je lokale content naar GitHub te publiceren.

Je kunt je repository op GitHub bekijken nadat je alle stappen hebt voltooid.

Git PULL-request

Een pull request is een GitHub-functie waarmee je projectbeheerders kunt laten weten dat je wijzigingen naar een repository hebt gepusht. Het is niet hetzelfde als het git pull-commando — een pull request is een manier om wijzigingen voor te stellen en te reviewen voordat ze in de main-branch worden gemerged.

Het eenvoudige commando om van een branch te pullen is:

git pull 'remote_name' 'branch_name'

Het commando git pull is een combinatie van git fetch, dat de recente commits ophaalt in de lokale repository, en git merge, dat de branch van een remote samenvoegt in een lokale branch. Verder is remote_name de naam van de repository en branch_name de naam van de specifieke branch.

Je bekijkt twee verschillende manieren om hetPULL-request te gebruiken.

PULL-request via de command line

Hieronder zie je de README-bestanden met een typfout. In het README-bestand staat het woord "contain" verkeerd gespeld als "containnns". De eigenaar van deze repository is MNALO en Olivia is de collaborator. Zij lost de fout op en dient een PULL-request in. Je ziet hieronder het proces om een PULL-request te maken aan de hand van een concreet voorbeeld.

In het bovenstaande bestand zie je de typfout in het woord "containnns".

1. Fork de repository

"De "Fork" is een kopie van een repository. Door een repository te forken kun je vrij experimenteren met wijzigingen zonder het oorspronkelijke project te beïnvloeden. (Bron)

2. Open je bash op je computer

Ga met het commando cd naar het vereiste pad of de vereiste map. De inhoud kun je bekijken met het commando ls, dat alle aanwezige bestanden in de directory weergeeft. In ons geval zie je dat 'README.md' aanwezig is.

3. Maak een nieuwe branch

Je kunt een nieuwe branch aanmaken met git checkout -b 'branch_name'. In de bovenstaande code wordt de vlag -b gebruikt om een nieuwe branch te maken, en met branch_name geef je de branch een specifieke naam. Met checkout schakel je over naar de nieuw aangemaakte branch.

4. Maak een wijziging met vim vanuit bash of vervang direct in het oorspronkelijke README-bestand

Je kunt het woord "containnns" wijzigen in "contains" in het README-bestand, en de wijzigingen met de huidige status bekijken met het volgende commando.

5. Een bestand toevoegen en committen naar de repository

Je moet toevoegen en committen met de volgende commando’s.

6. Push de repository naar GitHub

Je moet de content pushen met git push origin 'branch_name'. In de bovenstaande code is origin de remote repository en is 'branch_name' de vereiste branch waar je je lokale content naartoe uploadt.

7. PULL-request voor een specifieke branch op GitHub

Ga naar je repository op GitHub en je ziet dat er een nieuwe branch is.

Je kunt nu doorgaan naar stap 8, maar er is behoefte aan een update van de lokale repository met de upstream-repository. 

Als alternatief kun je git pull-request op de command line doen en het PULL-request naar GitHub voltooien, waarbij je je huidige branch moet pushen naar een remote repository.

8. Open een pull request

Klik op de knop Create pull request om de actie te voltooien.

Een branch verwijderen nadat het PULL-request is gemerged

Ga naar de hoofdpagina van de repository en klik op Pull requests.

Klik op Closed om de lijst te zien met alle PULL-requests die je hebt gedaan. Er is er op dit moment maar één die je moet selecteren. Dat is degene die hoort bij de branch die je wilt verwijderen.

Klik nu op Delete branch om de actie te voltooien.

De eigenaar van de repository kan alle commits, pull requests, enz. bekijken die door collaborators en anderen zijn gedaan. De wijzigingen van iemand kunnen belangrijk zijn, of snelle fixes voor een bug of fouten, en worden toegevoegd aan het project.

De eigenaar klikt nu op "Merge pull request". Ook klikt hij/zij op "Confirm merge" via het volgende proces.

De laatste wijziging aan het README.md-bestand met de gecorrigeerde typfout staat hieronder.

PULL-request via GitHub Desktop

Het bestand "imp" bevat een typfout; MNALO is de eigenaar en Olivia is collaborator. Zij volgen het onderstaande proces om een PULL-request te maken vanuit GitHub Desktop.

1. Clonen en openen op desktop

Een project wordt gekloond en klik op "Open in Desktop".

2. Maak een nieuwe branch

Er wordt een nieuwe branch "fix-typo-imp" aangemaakt.

3. Maak een wijziging in het imp-bestand vanuit de teksteditor

Je kunt de inhoud van het imp-bestand wijzigen, een typfout herstellen en wat tekst toevoegen.

4. Commit de wijzigingen

Er wordt een commitbericht geschreven en er wordt geklikt op "Commit to fix-typo-imp".

5. Publiceer de branch

Je kunt nu de branch publiceren, waarmee de commit naar GitHub wordt gepusht.

6. Maak een PULL-request

Je kunt nu een PULL-request maken door op Create pull request te klikken.

Je kunt nu ook een bericht schrijven en vervolgens nogmaals op Create pull request klikken.

Het vervolg is hetzelfde als hierboven in "PULL-request via de command line".

Conclusie

Als volgende stap: probeer onzeGitHub Concepts-cursus om te blijven oefenen met alledaagse taken. Ik zou ook onze GitHub Foundations Certification halen, die is ontstaan uit onze samenwerking met GitHub. Het staat goed op je cv, en je krijgt een flinke korting op de examenkosten wanneer je de cursus afrondt. Tot slot zou ik GitHub Actions bekijken, omdat die steeds vaker worden gebruikt in CI/CD-workflows, die gerelateerd zijn aan push/pull-operaties.