Git-Repository klonen

Bisher haben wir ein Repository auf GitHub erstellt und Teammitglieder hinzugefügt. Nun geht es darum, die Dateien auf den eigenen Rechner zu holen, Änderungen durchzuführen und diese wieder auf GitHub zu speichern. Dazu verwenden wir das Tool git im Terminal und VS Code.

Folgende Schritte führen wir gemeinsam durch:

  • git auf dem eigenen Rechner installieren
  • GitHub-Repository auf dem eigenen Rechner einrichten

git auf dem eigenen Rechner installieren

Wer mit macOS arbeitet, hat git bereits auf dem Rechner installiert. Meistens ist dies auch bei Linux der Fall. Für Windows müssen wir git herunterladen und installieren: https://git-scm.com

⚠️

In die Runde fragen, wer git bereits installiert hat und was unter Windows zu beachten ist.

Im Installationsvorgang folgendes wählen:

  • VS Code als Editor
  • ansonsten die Vorschläge übernehmen
  • Wichtig ist die Auswahl des Git Credential Manager für die Speicherung der Zugangsdaten.

Um zu prüfen, ob git bereits installiert ist, öffnen wir das Terminal z.B. in VS Code (View > Terminal) und geben folgenden Befehl ein:

git --version

Dies sollte eine Versionsnummer ausgeben (git version …). Sollte eine Fehlermeldung erscheinen, dann ist git noch nicht installiert.

→ Zeit geben für die Installation von git.

Git lokal konfigurieren

Zu Beginn nehmen wir ein paar Einstellungen in git vor. Wir teilen Git unseren Namen und unsere E-Mail-Adresse mit, damit in Git und GitHub nachvollzogen werden kann, wer eine bestimmte Änderung vorgenommen hat. Für die E-Mail-Adresse stellt uns GitHub eine noreply-Adresse zur Verfügung, die wir verwenden können.

Dazu geben wir im Terminal folgenden Befehl ein (→ USERNAME durch den eigenenGitHub-Namen ersetzen):

git config --global user.email "USERNAME@users.noreply.github.com"

Außerdem sollten wir unseren Namen angeben, damit die Änderungen leichter zuzuordnen sind.

💡

Wenn die Angabe des Namens aufgrund von Datenschutz nicht erfolgen soll, dann kann dieser z.B. durch ein Pseudonym ersetzt werden.

git config --global user.name "Max Mustermann"

GitHub-Repository auf dem eigenen Rechner einrichten

Wir wollen nun das Repository von GitHub auf den eigenen Rechner holen bzw. klonen. Dazu verwenden wir das Terminal in VS Code.

💡

Dies sollte auch direkt aus VS Code möglich sein mit Authentifizierung via Browser — wichtig ist, dass die Zugangsdaten im Credential Manager gespeichert werden, damit wir nicht jedes Mal die Zugangsdaten eingeben müssen.

In VS Code wählen wir zunächst mit File > Open Folder... den Ordner aus, in dem wir das Repository bzw. den Projektordner speichern möchten. Anschließend können wir das Terminal öffnen (View > Terminal) und folgenden Befehl eingeben:

git clone REPOSITORY-URL

Hierbei muss REPOSITORY-URL durch die URL des GitHub-Repositories ersetzt werden. Diese finden wir auf der GitHub-Seite des Projekts, indem wir den Button Code klicken und dann den Bereich HTTPS wählen. Die URL beginnt mit https://github.com/… und endet mit .git, z.B.:

https://github.com/USERNAME/REPOSITORY.git

USERNAME ist mit dem GitHub-Nutzernamen des Repository-Owners und REPOSITORY ist der Name des Repositories für das Team, in dem die Dateien und der Code des Programmierprojekts gespeichert werden.

⚠️

Wir werden nun nach dem GitHub-Nutzernamen und dem Passwort gefragt. Wenn wir diese nicht jedes Mal eingeben möchten, können wir unsere Zugangsdaten im Credential Manager speichern. Dazu sollten wir in Windows und Mac automatisch gefragt werden.

In Linux kann das in jeder Distribution etwas anders sein…

In der Dokumentation von GitHub wird die Speicherung der Zugangsdaten beschrieben: https://docs.github.com/en/get-started/getting-started-with-git/caching-your-github-credentials-in-git

(Alternativ kann auch das Tool GitHub CLI oder SSH verwendet werden, siehe dazu den vorigen Link zur Dokumentation von GitHub.)

💡

Es gib viele Tools für die Arbeit mit Git und GitHub, z.B. bietet GitHub auch einen Desktop-Client an. Wir verwenden hier allerdings die Kommandozeile, um die grundlegenden Befehle zu erlernen und zeigen zusätzlich den Umgang mit Git in VS Code.

→ Zeit geben für das Klonen des Projekts.

Projekt in VS Code öffnen

Nachdem das Projekt geklont wurde, können wir es in VS Code öffnen. Dazu wählen wir mit File > Open Folder... den Projektordner aus (der eben geklonte Ordner) und öffnen diesen.

💡

Wenn VS Code folgendes fragt:

Would you like VS Code to periodically run "git fetch"?

dann können wir dies mit zunächst mit No beantworten. Wir werden uns selbst um das Aktualisieren der Dateien kümmern.


Nun ist alles für die Arbeit mit Git und GitHub in VS Code vorbereitet.