Wichtige Meilensteine markieren

Einführung

Willkommen, Git-Entdecker! Heute werden wir uns einer der nützlichsten Funktionen von Git widmen, die es Ihnen ermöglicht, wichtige Punkte in der Geschichte Ihres Projekts zu markieren: Tags. Wenn Sie jemals gewünscht haben, wichtige Meilensteine in Ihrem Projekt, wie z. B. Release-Versionen, einfach markieren und später wieder aufrufen zu können, dann sind Git-Tags genau das, wonach Sie gesucht haben.

Tags in Git sind wie Wegweiser in der Zeitlinie Ihres Projekts. Sie ermöglichen es Ihnen, bestimmte Punkte in der Geschichte Ihres Repositorys als wichtig zu markieren. Dies ist besonders nützlich für die Markierung von Release-Punkten (z. B. v1.0, v2.0 usw.) oder anderer wichtiger Meilensteine in Ihrem Projekt.

In diesem Lab werden wir folgende Themen behandeln:

1. Erstellen von Lightweight Tags: Schnelle und einfache Tags
2. Erstellen von Annotated Tags: Detailliertere, vollständige Objekte in der Git-Datenbank
3. Auflisten von Tags: Wie Sie alle Tags in Ihrem Repository anzeigen können
4. Auschecken von Tags: Wie Sie Ihr Projekt an einem bestimmten getaggten Punkt anzeigen können
5. Löschen von Tags: Wie Sie Tags entfernen können, wenn sie nicht mehr benötigt werden

Am Ende dieses Labs werden Sie es beherrschen, Tags in Ihren Git-Projekten zu erstellen, zu verwalten und zu nutzen. Dies wird Ihnen ein leistungsstarkes Werkzeug für die Organisation der Projektgeschichte und die einfache Referenzierung wichtiger Punkte in Ihrem Entwicklungsprozess geben.

Lassen Sie uns beginnen und unsere Reise in die Welt der Git-Tags antreten!

Skills Graph

Einrichten Ihres Arbeitsbereichs

Bevor wir mit dem Taggen beginnen, richten wir einen Arbeitsbereich mit einigen Commits ein, die wir taggen können. Wir werden ein neues Verzeichnis erstellen, ein Git-Repository initialisieren und einige Dateien mit mehreren Commits hinzufügen, um die Entwicklung eines Projekts zu simulieren.

Öffnen Sie Ihr Terminal und geben Sie die folgenden Befehle ein:

cd ~/project
mkdir git-tags-lab
cd git-tags-lab
git init

Jetzt erstellen wir einige Dateien und machen eine Reihe von Commits. Sie können die folgenden Befehle kopieren und einfügen:

echo "## My Awesome Project" > README.md
git add README.md
git commit -m "Initial commit"

echo "function greet(name) { console.log('Hello, ' + name + '!'); }" > app.js
git add app.js
git commit -m "Add greeting function"

echo "const PI = 3.14159;" >> app.js
git add app.js
git commit -m "Add PI constant"

echo "function calculateArea(radius) { return PI * radius * radius; }" >> app.js
git add app.js
git commit -m "Add area calculation function"

Lassen Sie uns analysieren, was wir gerade getan haben:

1. Wir haben eine README-Datei erstellt und unseren ersten Commit gemacht.
2. Wir haben eine JavaScript-Datei mit einer Begrüßungsfunktion erstellt und sie committet.
3. Wir haben eine PI-Konstante zur gleichen Datei hinzugefügt und sie committet.
4. Schließlich haben wir eine Flächenberechnungsfunktion hinzugefügt und sie committet.

Jetzt haben wir ein Repository mit einer gewissen Historie, die wir taggen können!

Erstellen von Lightweight Tags

Beginnen wir mit der Erstellung eines Lightweight Tags. Lightweight Tags sind im Grunde nur ein Zeiger auf einen bestimmten Commit – stellen Sie sich sie als einen Branch vor, der sich nicht ändert. Sie sind einfach zu erstellen und zu verwenden, was sie perfekt für temporären oder persönlichen Gebrauch macht.

Um einen Lightweight Tag zu erstellen, verwenden Sie den Befehl git tag gefolgt vom Namen des Tags:

git tag v0.1

Dies erstellt einen Tag namens v0.1, der auf den aktuellen Commit (HEAD) zeigt.

Sie können auch einen Lightweight Tag für einen vergangenen Commit erstellen, indem Sie den Commit-Hash angeben:

git log --oneline

8197680 (HEAD -> master, tag: v0.1) Add area calculation function
d93ae1c Add PI constant
7411f09 Add greeting function
35d7df5 Initial commit

Dies zeigt Ihnen eine Liste Ihrer Commits an. Kopieren Sie den Hash des Commits "Add greeting function", der in diesem Fall 7411f09 ist (verwenden Sie den tatsächlichen Hash).

Drücken Sie q, um die Log-Ansicht zu verlassen, und erstellen Sie dann einen Tag für diesen Commit:

git tag v0.0.1 <commit-hash>

Ersetzen Sie <commit-hash> durch den tatsächlichen Hash, den Sie gefunden haben.

git tag

v0.0.1
v0.1

Lightweight Tags sind ideal für temporäre Marker oder für persönlichen Gebrauch. Allerdings speichern sie keine zusätzlichen Informationen. Für eine robusteres Tagging, insbesondere für öffentliche Releases, möchten Sie möglicherweise Annotated Tags verwenden, die wir als Nächstes behandeln werden.

Erstellen von Annotated Tags

Annotated Tags werden als vollständige Objekte in der Git-Datenbank gespeichert. Sie enthalten den Namen des Taggers, die E-Mail-Adresse, das Datum und eine Tagging-Nachricht. Sie können auch mit GNU Privacy Guard (GPG) signiert und verifiziert werden. Dies macht sie ideal für öffentliche Releases und alle Tags, für die Sie zusätzliche Informationen hinzufügen möchten.

Um einen Annotated Tag zu erstellen, verwenden Sie die -a-Option mit git tag:

git tag -a v1.0 -m "First major release"

Dies erstellt einen Annotated Tag namens v1.0 mit der Nachricht "First major release".

Sie können die Details eines Annotated Tags mit dem Befehl git show anzeigen:

git show v1.0

Dies zeigt die Informationen über den Tagger, das Datum, an dem der Commit getaggt wurde, die Anmerkungsnachricht und die Commit-Informationen an.

Annotated Tags werden für öffentliche Releases empfohlen, da sie viel mehr Informationen enthalten und verifiziert werden können. Sie sind eine Art zu sagen: "Dieser Punkt in der Geschichte ist wichtig, und hier ist der Grund dafür."

Auflisten von Tags

Mit der Entwicklung Ihres Projekts können Sie möglicherweise eine Vielzahl von Tags sammeln. Git bietet einfache Möglichkeiten, Ihre Tags aufzulisten und zu durchsuchen.

Um alle Tags in Ihrem Repository aufzulisten:

git tag

Dies zeigt alle Ihre Tags in alphabetischer Reihenfolge an.

Wenn Sie nach Tags suchen möchten, die einem bestimmten Muster entsprechen, können Sie die -l-Option (oder --list) mit einem Platzhalter verwenden:

git tag -l "v1.*"

Dies listet alle Tags auf, die mit "v1." beginnen.

Für detailliertere Informationen zu Ihren Tags, einschließlich der Anmerkungsnachrichten für Annotated Tags, können Sie Folgendes verwenden:

git tag -n

Dies listet Ihre Tags zusammen mit der ersten Zeile ihrer Anmerkungsnachricht (oder der Commit-Nachricht für Lightweight Tags) auf.

Denken Sie daran, dass Tags nicht automatisch an remote-Repositories übertragen werden. Wenn Sie Ihre Tags teilen möchten, müssen Sie sie explizit übertragen, was wir in einem zukünftigen Lab behandeln werden.

Auschecken von Tags

Eine der nützlichsten Funktionen von Tags ist die Möglichkeit, Ihr Projekt im Zustand eines bestimmten Tags einfach anzuzeigen. Dies ist ideal für Aufgaben wie das Reproduzieren von Bugs aus einer bestimmten Version oder das Überprüfen des genauen Codes, der in eine Veröffentlichung eingeflossen ist.

Um einen Tag auszuchecken, können Sie den Befehl git checkout verwenden:

git checkout v1.0

Dadurch wird Ihr Repository in einen "detached HEAD"-Zustand versetzt, bei dem es auf den Commit zeigt, auf den v1.0 verweist. Dies bedeutet, dass Sie sich umsehen, experimentelle Änderungen vornehmen und committen können und alle Commits, die Sie in diesem Zustand machen, verwerfen können, ohne dass dies irgendeinen Branch beeinträchtigt.

Wenn Sie Änderungen vornehmen und einen neuen Branch erstellen möchten, um diese Änderungen beizubehalten, können Sie Folgendes verwenden:

git checkout -b branch-name v1.0

Dies erstellt einen neuen Branch namens branch-name basierend auf dem Zustand Ihres Projekts beim Tag v1.0.

Denken Sie daran, dass Sie, wenn Sie mit der Ansicht des Codes bei einem bestimmten Tag fertig sind, zum neuesten Zustand Ihres Hauptbranches zurückkehren können mit:

git checkout master

Seien Sie vorsichtig, wenn Sie sich im "detached HEAD"-Zustand befinden. Alle Commits, die Sie machen, werden als "verwaist" (nicht auf einem Branch) betrachtet, wenn Sie einen anderen Branch auschecken, es sei denn, Sie erstellen explizit einen neuen Branch, um sie zu behalten.

Löschen von Tags

Manchmal müssen Sie möglicherweise einen Tag löschen. Vielleicht wurde er versehentlich erstellt, oder er ist nicht mehr relevant. Git macht es einfach, Tags zu entfernen.

Um einen Tag in Ihrem lokalen Repository zu löschen, können Sie Folgendes verwenden:

git tag -d v0.0.1

Dies entfernt den Tag v0.0.1 aus Ihrem lokalen Repository.

Seien Sie vorsichtig, wenn Sie Tags löschen. Andere Benutzer können diese Tags als Referenzpunkte verwenden. Es ist im Allgemeinen eine gute Praxis, mit Ihrem Team zu kommunizieren, bevor Sie geteilte Tags löschen.

Zusammenfassung

Herzlichen Glückwunsch, Git-Tagger! Sie haben gerade die Kunst des Umgangs mit Tags in Git beherrscht. Lassen Sie uns die wichtigsten Konzepte, die wir behandelt haben, zusammenfassen:

1. Erstellen von Lightweight Tags: Schnell und einfach zu erstellende Tags für temporären oder persönlichen Gebrauch.
2. Erstellen von Annotated Tags: Detailliertere Tags mit zusätzlichen Metadaten, perfekt für das Markieren wichtiger Meilensteine wie Releases.
3. Auflisten von Tags: Wie Sie die Tags in Ihrem Repository anzeigen und durchsuchen können.
4. Auschecken von Tags: Wie Sie Ihr Projekt im Zustand eines bestimmten Tags anzeigen können.
5. Löschen von Tags: Wie Sie Tags entfernen können, wenn sie nicht mehr benötigt werden.

Tags sind eine leistungsstarke Funktion in Git, die es Ihnen ermöglicht, wichtige Punkte in der Geschichte Ihres Projekts zu markieren. Sie sind besonders nützlich für das Markieren von Release-Punkten und anderen wichtigen Meilensteinen.

Denken Sie daran:

• Verwenden Sie Lightweight Tags für temporäre oder persönliche Referenzpunkte.
• Verwenden Sie Annotated Tags für öffentliche Releases und wenn Sie zusätzliche Informationen mit dem Tag verknüpfen möchten.
• Seien Sie vorsichtig, wenn Sie sich im "detached HEAD"-Zustand befinden, nachdem Sie einen Tag ausgecheckt haben.
• Seien Sie vorsichtig, wenn Sie Tags löschen, insbesondere wenn sie an ein geteiltes Repository übertragen wurden.

Während Sie Ihre Git-Reise fortsetzen, werden Sie feststellen, dass Tags ein unschätzbares Werkzeug für die Verwaltung der Zeitlinie Ihres Projekts sind. Sie bieten klare Referenzpunkte, die Ihnen und Ihrem Team helfen können, sich mühelos durch die Geschichte Ihres Projekts zu bewegen.

Viel Spaß beim Taggen, und mögen Ihre Projekt-Meilensteine immer deutlich markiert sein!