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.