Git kennenlernen mit Bitbucket Cloud | Atlassian Git Tutorial (2024)

Gehe wie folgt vor, um dein Repository zu erstellen:

1. Klicke in Bitbucket in der globalen Seitenleiste auf das Symbol + und wähle Repository.

2. Gib im Feld Name den Wert BitbucketStationLocations ein. Bitbucket verwendet diesen Namen in der URL des Repository. Beispiel: Der Benutzer the_best hat ein Repository namens awesome_repo. Die URL dieses Repositorys würde dann https://bitbucket.org/the_best/awesome_repo lauten.

3. Lasse unter Access level (Zugriffsstufe) das Kontrollkästchen This is a private repository (Dieses Repository ist privat) aktiviert. Ein privates Repository ist nur für dich selbst sichtbar sowie für alle Benutzer, denen du ein entsprechendes Zugriffsrecht erteilst. Wenn du das Kontrollkästchen nicht aktivierst, kann jeder dein Repository sehen.

4. Wähle als Repository type (Repository-Typ) die Option Git aus. Denke daran: Der Repository-Typ lässt sich nicht mehr ändern, sobald du auf Create repository (Repository erstellen) geklickt hast.

5. Klicke auf Create repository (Repository erstellen). Bitbucket erstellt nun dein Repository und führt es auf der Seite Overview (Übersicht) auf.

Schritt2: Untersuche dein neues Repository.

Schaue dir nun dein neues Repository genauer an. Aktuell solltest du dich auf der Repository-Seite Overview (Übersicht) befinden:

Klicke in der globalen Seitenleiste auf +, um häufige Aktionen für ein Repository anzuzeigen. Klicke auf die Punkte in der Navigationsseitenleiste, um zu sehen, was sich hinter jedem dieser Links verbirgt, einschließlich der Einstellungen, in denen du die Repository-Details und weitere Einstellungen aktualisieren kannst. Um die zur Navigation dieser Punkte verfügbaren Tastaturkürzel anzuzeigen, drücke die ?-Taste auf deiner Tastatur.

Wenn du auf die Option Commits in der Seitenleiste klickst, wirst du feststellen, dass keine Commits angezeigt werden. Das war zu erwarten, weil du noch keine Inhalte für dein Repository erstellt hast. Aktuell ist dein Repository privat und du hast noch niemanden dazu eingeladen. Daher bis du als Repository-Besitzer aktuell der einzige, der Inhalte erstellen und bearbeiten kann.

Schritt1: Klone dein Repository auf deinem lokalen System.

Öffne auf deinem Desktop ein Browserfenster und ein Terminalfenster. Gehe dann im Terminalfenster wie folgt vor:

1. Wechsle in dein Stammverzeichnis (~).

$cd~

Sobald du Bitbucket häufiger verwendest, wirst du wahrscheinlich mit mehreren Repositorys arbeiten. Dann empfiehlt es sich, ein Verzeichnis zu erstellen, in dem du alle diese Repositorys zusammenfassen kannst.

2. Erstelle ein Verzeichnis für deine Repositorys.

$mkdirrepos

$cd~/repos

4. Öffne in Bitbucket dein Repository BitbucketStationLocations.

5. Klicke in der globalen Seitenleiste auf das + -Symbol und wähle Clone this repository (Dieses Repository klonen) aus.

Bitbucket zeigt ein Pop-up-Dialogfeld zum Klonen an. In diesem Dialogfeld ist, je nach deinen Einstellungen, als Protokoll standardmäßig HTTPS oder SSH festgelegt. Für dieses Tutorial übernimmst du das festgelegte Standardprotokoll.

6. Kopiere den hervorgehobenen Klonbefehl.

7. Füge den aus Bitbucket kopierten Befehl in dein Terminalfenster ein und drücke die Eingabetaste.

8. Gib dein Bitbucket-Passwort ein, wenn das Terminal danach fragt. Wenn du ein Konto erstellt hast, indem du auf Google verlinkt hast, verwende dein Passwort für dieses Konto.

• Falls dir ein Windows-Passwortfehler angezeigt wird:
  • Bei einigen Versionen von Microsoft Windows und Git wird an dieser Stelle möglicherweise eine Fehlermeldung ähnlich der folgenden angezeigt:

    Beispiel für einen Passwortfehler beim Klonen unter Windows

$gitclone
https://emmap1@bitbucket.org/emmap1/bitbucketstationlocations.git
Cloninginto'bitbucketspacestation'...
fatal:couldnotread
Passwordfor'https://emmap1@bitbucket.org':Nosuchfileordirectory

• Wenn du diese Fehlermeldung erhältst, gib Folgendes in die Befehlszeile ein:

$gitconfig--globalcore.askpass

• Gehe dann zurück zu Schritt 4 und wiederhole das Klonen. Jetzt solltest du im Bash-Agent zur Eingabe deines Passworts aufgefordert werden. Die Passworteingabe sollte nur einmal erforderlich sein.

Die Ausgabe in deinem Terminalfenster sollte nun in etwa wie folgt aussehen:

$cd~/repos
$gitclonehttps://emmap1@bitbucket.org/emmap1/bitbucketstationlocations.git
Cloninginto'bitbucketstationlocations'...
Password
warning:Youappeartohaveclonedanemptyrepository.

• Natürlich wusstest du schon zuvor, dass dein Repository leer ist, denn du hast ja noch keine Quelldateien hinzugefügt.

9. Rufe eine Liste der Inhalte in deinem Repository-Verzeichnis ab. In der zurückgegebenen Liste sollte dein Verzeichnis bitbucketstationlocations aufgeführt sein.

$ls

Schritt2: Dateien zum lokalen Repository hinzufügen und in Bitbucket laden

Jetzt da das Repository auf deinem lokalen System verfügbar ist, kann die richtige Arbeit beginnen. Du willst in Zukunft jederzeit einen Überblick über alle deine Raumstationstandorte haben. Zu diesem Zweck erstellst du nun eine Datei mit allen deinen Standorten.

1. Wechsle in dein Terminalfenster und navigiere zur obersten Ebene deines lokalen Repositorys.

$cd~/repos/bitbucketstationlocations/

$echo"Earth'sMoon">>locations.txt

Wenn die Befehlszeile keine Antwort zurückgibt, hast du die Datei korrekt erstellt.

3. Rufe den Status deines lokalen Repositorys ab. Der Befehl git status gleicht dein Projekt mit deinem Bitbucket-Repository ab.

Git meldet, dass du eine neue Datei erstellt hast. Die entsprechende Ausgabe sieht in etwa wie folgt aus:

$gitstatus
Onbranchmain
Initialcommit
Untrackedfiles:
(use"gitadd<file>..."toincludeinwhatwillbecommitted)
locations.txt
nothingaddedtocommitbutuntrackedfilespresent(use"gitadd"totrack)

Die Datei wird nicht verfolgt. Das bedeutet: Git interpretiert die Datei nicht als Teil eines früheren Commits. In der Statusausgabe wirst du auch auf den nächsten Schritt hingewiesen: Du musst die Datei hinzufügen.

4. Weise Git an, deine neue Datei locations.txt nachzuverfolgen. Verwende hierzu den Befehl git add. Genau wie bei der Dateierstellung gilt: Bei korrekter Eingabe gibt der Befehl git add keine Ausgabe zurück.

$gitaddlocations.txt

$gitstatus
Onbranchmain
Initialcommit
Changestobecommitted:
(use"gitrm--cached<file>..."tounstage)
newfile:locations.txt

Wie du siehst, wurde die neue Datei hinzugefügt. Sie befindet sich also in der Staging-Umgebung und du kannst sie committen, sobald du dazu bereit bist. Der Befehl git status gibt den Status des Arbeitsverzeichnisses und den Status des Snapshots in der Staging-Umgebung zurück.

6. Gib den Befehl git commit mit einer Commit-Nachricht aus, wie in der nächsten Zeile gezeigt. Das "-m" bedeutet, dass eine Commit-Nachricht folgt.

$gitcommit-m'Initialcommit'
[main(root-commit)fedc3d3]Initialcommit
1filechanged,1insertion(+)
createmode100644locations.txt

Alle Änderungen, die du bis jetzt vorgenommen hast, sind auf deinem lokalen System gespeichert. Sie werden erst in deinem Bitbucket-Repository sichtbar, wenn du sie dorthin pushst.

• Interessante Fakten über Git und Remote-Repositorys
  • Git unterstützt die Kommunikation mit Remote-Repositorys (in deinem Fall Bitbucket). Diese Kommunikation bildet die Grundlage für jeden Git-basierten Zusammenarbeits-Workflow.
  • Im Zusammenarbeitsmodell von Git hat jeder Entwickler eine eigene Kopie des Repositorys zur Verfügung, inklusive eines eigenen lokalen Verlaufs und einer eigenen lokalen Branch-Struktur. In der Regel müssen Benutzer eine Reihe aufeinanderfolgender Commits veröffentlichen, kein einzelnes Changeset. Mit Git committest du keine Changesets von einer Arbeitskopie zum zentralen Repository, sondern kannst ganze Branches zwischen Repositorys teilen.

• Du kannst Verbindungen mit anderen Repositorys verwalten und deinen lokalen Verlauf veröffentlichen, indem du deinen Branch in andere Repositorys pushst. Wenn du die Arbeit von Teamkollegen sehen möchtest, pullst du deren Branches in dein lokales Repository.

7. Wechsle wieder in dein lokales Terminalfenster und sende mit git push origin main alle committeten Änderungen an Bitbucket. Dieser Befehl pusht die Änderungen in den Haupt-Branch (Bitbucket-Branch) auf "origin" (Bitbucket-Server).

Die Antwort sollte in etwa wie folgt aussehen:

$gitpushoriginmain
Countingobjects:3,done.
Writingobjects:100%(3/3),253bytes|0bytes/s,done.
Total3(delta0),reused0(delta0)Tohttps://emmap1@bitbucket.org/emmap1/bitbucketstationlocations.git
*[newbranch]main->main
Branchmainsetuptotrackremotebranchmainfromorigin.

8. Wechsle zu deinem Repository BitbucketStationLocations in Bitbucket.

9. Wenn du in der Seitenleiste auf Commits klickst, wird dir ein einzelner Commit in deinem Repository angezeigt. Bitbucket fügt alles, was du gerade gemacht hast, in diesem Commit zusammen und zeigt ihn dir an. In der Spalte Author (Autor) wird dir der Wert angezeigt, den du zur Konfiguration der globalen Git-Datei ( ~/.gitconfig) verwendet hast.
Wenn du in der Seitenleiste auf Source (Quelle) klickst, siehst du, dass sich in deinem Repository eine einzelne Quelldatei befindet, nämlich die Datei locations.txt,die du eben hinzugefügt hast.

Deine nächste Aufgabe als Raumstationadministrator: Du musst eine Datei mit detaillierteren Informationen zu deinen Standorten anlegen. Da du aktuell noch nicht allzu viele Standorte hast, kannst du sie direkt aus Bitbucket hinzufügen.

Gehe wie folgt vor, um deine neue Standortdatei hinzuzufügen:

1. Klicke in deinem BitbucketStationLocations-Repository auf Source, um das Quellverzeichnis zu offen. In deinem Verzeichnis wird aktuell nur eine Datei angezeigt: locations.txt.

A. Seite "Source" (Quelle): Klicke auf den Link, um diese Seite zu öffnen.
B. Branch-Auswahl: Wähle den Branch aus, den du anzeigen möchtest.
C. Schaltfläche "Weitere Optionen": Klicke auf diese Schaltfläche, um ein Menü mit weiteren Optionen zu öffnen, z. B. "Datei hinzufügen".D. Bereich "Source file" (Quelldatei): Zeige das Dateiverzeichnis in Bitbucket an.

2. Klicke auf der Seite Source (Quelle) in der rechten oberen Ecke auf die Schaltfläche More options (Weitere Optionen) und wähle Add file (Datei hinzufügen) aus dem Menü aus. Die Schaltfläche More options (Weitere Optionen) wird nur angezeigt, nachdem du dem Repository mindestens eine Datei hinzugefügt hast.

Eine Seite zum Erstellen der neuen Datei wird geöffnet, wie im folgenden Bild gezeigt.

A. Branch mit neuer Datei: Ändere diese Option, wenn du eine Datei zu einem anderen Branch hinzufügen möchtest.B. New file area (Bereich für neue Datei): Füge hier Inhalte für deine neue Datei hinzu.

3. Trage in das Feld filename (Dateiname) die Zeichenfolge stationlocations ein.

4. Wähle aus der Liste Syntaxmodus die Option HTML aus.

5. Füge den folgenden HTML-Code in das Textfeld ein:

<p>Bitbuckethasthefollowingspacestations:</p>
<p>
<b>Earth'sMoon</b><br>
Headquarters
</p>

6. Klicke auf Commit (Committen). Das Feld Commit message (Commit-Nachricht) wird angezeigt, mit folgender Nachricht: stationlocations created online with Bitbucket.

7. Klicke unter dem Nachrichtenfeld auf Commit.

Damit hast du eine neue Datei in Bitbucket erstellt und wirst zur Seite mit den Details des Commits weitergeleitet. Dort kannst du die Änderung sehen, die du gerade vorgenommen hast:

Nun musst du die neue Datei in dein lokales Repository übertragen. Das funktioniert ganz unkompliziert. Im Grunde genommen kehrst du einfach nur den Push um, mit dem du die Datei locations.txt in Bitbucket geladen hast.

Um die Datei in dein lokales Repository zu pullen, gehst du wie folgt vor:

1. Öffne dein Terminalfenster und navigiere zum obersten Level deines lokalen Repository.

$cd~/repos/bitbucketstationlocations/

$gitpull--all
Fetchingorigin
remote:Countingobjects:3,done.
remote:Compressingobjects:100%(3/3),done.
remote:Total3(delta0),reused0(delta0)
Unpackingobjects:100%(3/3),done.
Fromhttps://bitbucket.org/emmap1/bitbucketstationlocations
fe5a280..fcbeeb0main->origin/main
Updatingfe5a280..fcbeeb0
Fast-forward
stationlocations|5++++++++++++++
1filechanged,5insertions(+)
createmode100644stationlocations

3. Wechsle in den Ordner deines Repositorys auf deinem lokalen System. Dort wird nun die gerade hinzugefügte Datei angezeigt.

Sehr gut! Nachdem du jetzt die beiden Dateien mit dem Standort deiner Raumstation hinzugefügt hast, hast du einmal den grundlegenden Git-Workflow zwischen Bitbucket und deinem lokalen System durchgespielt: Klonen, Hinzufügen, Committen, Pushen und Pullen.

Als Raumstationadministrator hast du eine ganze Reihe von Verantwortlichkeiten. Manchmal musst du beispielsweise dafür sorgen, dass Informationen für Unbefugte unzugänglich sind, insbesondere bei der Suche nach neuen Standorten im Sonnensystem. Wenn du mit Branches umgehen kannst, kannst du deine Dateien aktualisieren und Informationen gezielt erst dann veröffentlichen, wenn du dazu bereit bist.

Am effektivsten sind Branches bei Teamprojekten. Du kannst in einem separaten Branch an deinem eigenen Teil des Projekts arbeiten, Updates aus Bitbucket pullen und deine gesamte Arbeit mit dem Haupt-Branch zusammenführen, sobald du dazu bereit bist. In unserer Dokumentation findest du detailliertere Erläuterungen zu den Vorteilen von Branches.

Ein Branch ist eine unabhängige Entwicklungslinie innerhalb deines Repositorys. Stell ihn dir vor wie ein komplett neues Arbeitsverzeichnis inklusive neuer Staging-Umgebung und neuem Projektverlauf. Bevor du neue Branches erstellst, wird zunächst automatisch ein Haupt-Branch angelegt (Main). Das Schaubild unten zeigt diesen Haupt-Branch sowie einen weiteren Branch mit einem Bugfix-Update.

Schritt1: Branch erstellen und eine Änderung vornehmen

Nun erstellst du einen Branch, dem du alle zukünftigen Pläne für deine Raumstationen hinzufügen kannst, die du noch nicht committen möchtest. Sobald du zur Veröffentlichung dieser Pläne bereit bist, kannst du deine Änderungen mit deinem Bitbucket-Repository zusammenführen (Merge) und den nicht mehr benötigten Branch löschen.

Führe dir dabei immer vor Augen: Branches sind lediglich Pointer, die auf Commits verweisen. Wenn du einen Branch erstellst, muss Git nur einen neuen Pointer erstellen. Es wird kein komplett neuer Satz von Dateien oder Ordnern angelegt. Zu Beginn sieht dein Repository so aus:

Gehe wie folgt vor, um einen Branch zu erstellen:

1. Wechsle in dein Terminalfenster und navigiere mit dem folgenden Befehl zur obersten Ebene deines lokalen Repositorys:

cd~/repos/bitbucketstationlocations/

$gitbranchfuture-plans

Der Repository-Verlauf bleibt unverändert. Es wird lediglich ein neuer Pointer zum aktuellen Branch implementiert. Wenn du in dem neuen Branch arbeiten möchtest, musst du ihn zunächst auschecken.

3. Checke den gerade erstellten neuen Branch aus, um in ihm arbeiten zu können:

$gitcheckoutfuture-plans
Switchedtobranch'future-plans'

4. Navigiere auf deinem lokalen System zum Ordner bitbucketstationlocations und öffne ihn. Wie du siehst, wurden durch die Erstellung des neuen Branches keine zusätzlichen Dateien oder Ordner in dem Verzeichnis angelegt.

5. Öffne die Datei stationlocations in einem Texteditor.

6. Ändere die Datei, indem du einen weiteren Stationsstandort hinzufügst:

<p>Bitbuckethasthefollowingspacestations:</p>
<p>
<b>Earth'sMoon</b><br>
Headquarters
</p>
<p>
<b>Mars</b><br>
RecreationDepartment
</p>

7. Speichere die Datei und schließe sie.

8. Gib git status im Terminalfenster ein. Die resultierende Ausgabe wird in etwa wie folgt aussehen:

$gitstatus
Onbranchfuture-plans
Changesnotstagedforcommit:
(use"gitadd<file>..."toupdatewhatwillbecommitted)
(use"gitcheckout--<file>..."todiscardchangesinworkingdirectory)
modified:stationlocations
nochangesaddedtocommit(use"gitadd"and/or"gitcommit-a")

Entscheidend ist hier die Zeile On branch future-plans. Als du zuvor git status eingegeben hast, lautete diese Zeile noch On branch main, weil nur der Main Branch angelegt war. Wann immer du eine Änderung in die Staging-Umgebung verschieben oder committen möchtest, solltest du zuerst diese Zeile überprüfen und dich vergewissern, dass der Branch, dem du die Änderung hinzufügen möchtest, auch ausgecheckt ist.

9. Lade deine Datei in die Staging-Umgebung.

$gitaddstationlocations

$gitcommitstationlocations-m'makingachangeinabranch'
[future-planse3b7732]makingachangeinabranch
1filechanged,4insertions(+)

Du baust deinen Verbund an Raumstationen immer weiter aus und möchtest nun deinen Standort auf dem Mars mit einer feierlichen Zeremonie eröffnen. Da du deine Zukunftspläne damit jetzt in die Realität umsetzt, kannst du den Branch future-plans mit dem Haupt-Branch auf deinem lokalen System zusammenführen.

Da du nur einen einzigen Branch erstellt und nur eine einzige Änderung vorgenommen hast, kannst du zur Zusammenführung die Fast-Forward-Methode auf den Branch anwenden. Ein solcher Fast-Forward-Merge ist möglich, weil ein linearer Pfad von der Spitze des aktuellen Branches zum Ziel-Branch existiert. Statt die Branches tatsächlich zusammenzuführen, muss Git zur Integration der verschiedenen Verläufe lediglich die Spitze des aktuellen Branches an die Spitze des Ziel-Branches verschieben ("fast-forward"). Dadurch werden die Verläufe miteinander kombiniert und alle Commits aus dem Ziel-Branch sind auch über den aktuellen Branch zugänglich.

Der beschriebene Branch-Workflow wird häufig für kurzlebige Themen-Branches mit kleineren Änderungen verwendet, seltener für langlebigere Features.

Gehe wie folgt vor, um einen Fast-Forward-Merge durchzuführen:

1. Wechsle in dein Terminalfenster und navigiere zur obersten Ebene deines lokalen Repositorys.

$cd~/repos/bitbucketstationlocations/

$gitstatus
Onbranchfuture-plans
nothingtocommit,workingdirectoryclean

$gitcheckoutmain
Switchedtobranch'main'
Yourbranchisup-to-datewith'origin/main'.

$gitmergefuture-plans
Updatingfcbeeb0..e3b7732
Fast-forward
stationlocations|4++++
1filechanged,4insertions(+)

Im Grunde genommen hast du damit den Pointer zum main-Branch an die aktuelle Kopfposition verschoben. Dein Repository sieht nun ungefähr wie der oben abgebildete Fast-Forward-Merge aus.

5. Da du den Branch future-plans nicht mehr verwenden wirst, kannst du ihn nun löschen.

$gitbranch-dfuture-plans
Deletedbranchfuture-plans(wase3b7732).

Nachdem du den future-plans-Branch gelöscht hast, kannst du immer noch mithilfe einer Commit-ID über den main-Branch auf ihn zugreifen. Möchtest du beispielsweise die aus future-plans hinzugefügten Änderungen rückgängig machen, kannst du mithilfe der gerade erhaltenen Commit-ID zu diesem Branch zurückkehren.

6. Rufe mit git status die Ergebnisse des Merge ab. Wie du siehst, ist dein lokales Repository deinem Remote-Repository jetzt um 1 Commit voraus. Dies sollte in etwa so aussehen:

$gitstatus
Onbranchmain
Yourbranchisaheadof'origin/main'by1commit.
(use"gitpush"topublishyourlocalcommits)
nothingtocommit,workingdirectoryclean

Bisher hast du folgende Schritte durchgeführt:

• Du hast einen Branch erstellt und ausgecheckt.
• Du hast eine Änderung in deinem neuen Branch vorgenommen.
• Du hast die Änderung per Commit in den neuen Branch übertragen.
• Du hast die Änderung zurück in den Haupt-Branch überführt.
• Du hast den nicht mehr verwendeten Branch gelöscht.

Im nächsten Schritt musst du deine Arbeit wieder in dein Remote-Repository pushen (Bitbucket).

Schritt3: Pushe deine Änderungen in Bitbucket.

Jeder soll den neuen Raumstationstandort sehen können. Damit das möglich ist, kannst du den aktuellen Status deines lokalen Repositorys per Push an Bitbucket übertragen.

Das Schaubild unten verdeutlicht den Prozess. Du siehst, was geschieht, wenn in deinem lokalen Repository Änderungen vorhanden sind, die im zentralen Repository fehlen, und du diese Änderungen in Bitbucket pushst.

Gehe wie folgt vor, um deine Änderung in das Remote-Repository zu pushen:

1. Wechsle in das Repository-Verzeichnis und gib dort git push origin main in das Terminalfenster ein, um die Änderungen zu pushen. Die resultierende Ausgabe sieht in etwa so aus:

$gitpushoriginmain
Countingobjects:3,done.
Deltacompressionusingupto8threads.
Compressingobjects:100%(3/3),done.
Writingobjects:100%(3/3),401bytes|0bytes/s,done.
Total3(delta0),reused0(delta0)
Tohttps://emmap1@bitbucket.org/emmap1/bitbucketstationlocations.git
fcbeeb0..e3b7732main->main

2. Öffne in deinem Bitbucket-Repository die Seite Übersicht. Der Push ist hier unter Aktuelle Aktivitäten aufgeführt.

3. Klicke auf Commits. Hier ist der Commit aufgelistet, den du auf deinem lokalen System durchgeführt hast. Wie du siehst, ist die Commit-ID identisch mit der Commit-ID auf deinem lokalen System.

Außerdem ist die Linie links neben der Commit-Liste gerade und durchgehend, ohne Branches. Warum? Es gab zu keinem Zeitpunkt Interaktionen zwischen dem Branch future-plans und dem Remote-Repository, nur zwischen dem Remote-Repository und der Änderung, die du vorgenommen und committet hast.

4. Klicke auf Branches. Auch hier wird der Branch nicht aufgeführt.

5. Klicke auf Quelle und dann auf die Datei stationlocations. Die letzte Änderung an der Datei hat dieselbe Commit-ID wie der eben durchgeführte Push.

6. Klicke auf die Dateiverlaufliste, um alle Änderungen zu sehen, die für die Datei committet wurden. Dein Bildschirm sollte etwa wie folgt aussehen:

Du bist fertig!

Du fragst dich, wie du dir alle diese neuen Git-Befehle merken sollst? Keine Sorge. Lege einfach unsere Seite mit den grundlegenden Git-Befehlen in deinen Favoriten ab. Hier kannst du jederzeit nachsehen, wenn du unsicher bist.