Git-und-Gitea-Lab: clone, commit und push auf einem eigenen Git-Server lernen

Dieses Lab gibt jeder lernenden Person ein eigenes Gitea, einen kleinen selbst gehosteten Git-Server mit einer Weboberfläche wie der von GitHub, der ein Repository mit zwei Commits enthält. Vom Terminal daneben klonen sie das Repository, legen eine Datei an, stagen sie, committen sie und pushen sie. Danach finden sie ihren Commit in der Weboberfläche.

Es muss kein GitHub-Konto angelegt und nichts installiert werden, und genau das macht das Lab geeignet für eine erste Lektion zur Versionsverwaltung.

Was die Lernenden lernen

Den Kreislauf der Versionsverwaltung: git config, git clone, git status, git add, git commit, git log und git push, und was jeder Befehl zeigt. Sie finden ihren Commit oben im Verlauf in einer Weboberfläche, bearbeiten eine Datei im Browser und holen sie wieder herunter. Naheliegende nächste Lektionen sind ein Branch und ein Pull-Request, ein Konflikt, der entsteht, wenn dieselbe Zeile im Browser und im Terminal bearbeitet wird, und das Rückgängigmachen mit git revert.

Im Browser ausführen

Das Gitea-Konto ist student mit dem Passwort student, und das Repository ist student/hello-git.

  1. Die Container-Seite öffnen. Öffnen Sie in der Leiste „Entwickeln“ und wählen Sie „Einen Container ausführen“. Die Seite steht jedem offen, und das Git-Lab und das SQL-Lab starten ohne Konto. Alle anderen Labs brauchen ein kostenloses Konto: Erstellen Sie eines, melden Sie sich an und klicken Sie dann auf „Starten“.
  2. Das Lab finden. Die Karte „Beispiel-Labs“ listet alle Beispiele auf. Suchen Sie Git mit Gitea.
  3. Auf „Starten“ klicken. „Starten“ führt das Lab unverändert mit einem Klick aus. „Zuerst die Datei bearbeiten“ öffnet die Compose-Datei, damit Sie sie vor dem Start ändern können.
  4. Öffnen. Klicken Sie auf der Seite des Labs unter „In Ihrem Browser“ auf „Gitea“ und sehen Sie sich hello-git an. Führen Sie im Terminal git clone http://gitea:3000/student/hello-git.git aus: Das Terminal erreicht Gitea über seinen Dienstnamen. Die README führt durch jeden Schritt.

Der Code auf GitHub

Eine Compose-Datei. Gitea läuft als gewöhnliches Konto und braucht keine zusätzlichen Berechtigungen. Es läuft auch auf Ihrem eigenen Rechner. Erstellen Sie einen Fork, um das Start-Repository zu ändern.

Eine Grundlagenlektion zu diesem Lab

Git Basics und Git Basics 2 sind Lektionen, die in dieses Lab eingearbeitet sind. Jeder Schritt ist erklärt und hat eine Schaltfläche „Ausführen“, die einen Befehl in das Terminal der lernenden Person tippt. In Git Basics legen sie ein Repository, einen Ordner, eine Datei und einen ersten Commit an und pushen ihn. In Git Basics 2 arbeiten sie auf einem Branch, pushen ihn, mergen ihn mit einem Pull-Request in Gitea und holen den Merge zurück.

Ein kostenloses persönliches Konto erhält sie im Modul „Basics“, das auf der Startseite liegt. Jede Einrichtung kann sie aus dem Ordner „Basics“ der Bibliothek kopieren, und eine neue Einrichtung startet mit ihnen in einem Modul namens Basics (Sample). Sie sind bewusst klein: Sie zeigen Lehrkräften, was eine in ein Lab eingearbeitete Lektion ist, und das Lab erledigt den Rest. Kopieren Sie eine in ein eigenes Modul, um sie zu ändern.

Als Aufgabe stellen

Bitten Sie die Lernenden, einen Commit zu pushen, der etwas Bestimmtes tut, und den Verlauf abzugeben.

  1. Das Lab anlegen. Fügen Sie in Ihrem Modul eine Aufgabe hinzu, wählen Sie die Karte „Container-Lab“ und dann „In einem GitHub-Repository“. Geben Sie https://github.com/mitsurutech/lab-git-gitea mit dem Branch main an. Die Compose-Datei ist standardmäßig compose.yaml. Erstellen Sie zuerst einen Fork des Repositorys, wenn Sie es ändern möchten.
  2. Veröffentlichen und ausprobieren. „Veröffentlichen“ legt den Commit fest, den Ihnen die Seite angezeigt hat. Eine spätere Änderung im Repository verändert also kein Lab, das Sie bereits zugewiesen haben. Starten Sie zuerst Ihre eigene Kopie.
  3. Zuweisen. Weisen Sie es wie jede Aufgabe zu, auf Wunsch mit Fälligkeitsdatum, und schreiben Sie in die Aufgabe, was zu tun ist und was abgegeben werden soll.
  4. Abgaben bewerten. Öffnen Sie die Kopie einer lernenden Person und die abgegebene Arbeit, bewerten Sie sie und geben Sie sie mit einer Begründung zur Überarbeitung zurück, wenn mehr nötig ist.

Häufige Fragen

Brauchen die Lernenden ein GitHub-Konto?
Nein. Das Lab jeder lernenden Person startet ein eigenes Gitea, sie pushen also auf einen Git-Server, der zu ihrer Kopie des Labs gehört und sonst nirgends existiert.
Bleibt die Arbeit zwischen den Sitzungen erhalten?
Ja. Gitea hält seine Repositorys und seine Datenbank in einem benannten Volume, das die Plattform speichert, sodass das, was eine lernende Person gepusht hat, beim nächsten Mal noch da ist.
Welche Git-Befehle üben die Lernenden im Gitea-Lab?
Den alltäglichen Kreislauf: git config, git clone, git status, git add, git commit, git log und git push, und was jeder Befehl zeigt. Danach finden sie ihren Commit oben im Verlauf in der Weboberfläche von Gitea, angemeldet als student mit dem Passwort student.