Ziel

In diesem Tutorial vermitteln wir dir anhand eines Weltraumszenarios die Grundlagen von Git. 

Übersicht zur Aufgabe

Im Rahmen dieses Tutorials verschaffst du dir einen Überblick über sämtliche Raumstationen deines Teams und lernst so die Arbeit mit Git kennen. Es werden folgende Befehle behandelt:

  • "git clone", "git config", "git add", "git status", "git commit", "git push", "git pull", "git branch", "git checkout" und "git merge"
Zeit Zielpublikum Voraussetzungen
30 Minuten Du hast noch nie mit Git oder Bitbucket Cloud gearbeitet. Du hast Git installiert.
    Du hast einen Bitbucket-Account.

Git-Repositorys erstellen

Glückwunsch: Du wurdest zum Bitbucket-Raumstationadministrator ernannt. In dieser Rolle musst du perfekt organisiert sein. Alle Dateien, die du für deine Raumstationen erstellst, müssen an einem zentralen Ort gespeichert und für alle deine Teamkollegen zugänglich sein, und zwar ganz gleich, wo im Universum sie sich gerade befinden. In Bitbucket bedeutet das, sämtliche Dateien zu einem Repository hinzuzufügen. Im ersten Schritt erstellen wir also zunächst ein Repository.

  • Interessante Fakten über Repositorys

    • Du hast Zugriff auf alle Dateien in deinem lokalen Repository, unabhängig davon, ob du an einer oder mehreren Dateien arbeitest.
    • Du kannst auf öffentliche Repositorys auch ohne Bitbucket-Account zugreifen, wenn du die URL des entsprechenden Repositorys kennst.
    • Jedes Repository gehört zu einem Benutzer-Account oder einem Team. Gehört es zu einem Benutzer-Account, ist der Benutzer der Verantwortliche für das Repository. Gehört es zu einem Team, ist die verantwortliche Instanz das Team.
    • Nur der Verantwortliche für ein Repository kann das Repository löschen. Gehört das Repository zu einem Team, kann es von einem Administrator gelöscht werden.
    • Ein Codeprojekt kann aus einem einzigen Repository in einem einzigen Account bestehen oder auch aus mehreren Repositorys, die auf verschiedene Accounts verteilt sind.
    • Ein Repository darf maximal 2 GB groß sein. Wir empfehlen eine Größe von höchstens 1 GB.

Schritt 1: Erstelle das Repository.

Ein neu in Bitbucket erstelltes Repository ist zunächst leer und enthält keinerlei Code. Das wird sich allerdings schnell ändern, da du ihm schon bald verschiedene Dateien hinzufügen wirst. Zukünftig wird das Bitbucket-Repository das zentrale Repository für deine Dateien sein. Andere Benutzer können auf dieses Repository zugreifen, wenn du ihnen das entsprechende Zugriffsrecht erteilst. Sobald du dein Repository erstellt hast, kopierst du eine Version des Repositorys auf dein lokales System. So kannst du deine Dateien in einem deiner Repositorys aktualisieren und die Änderungen in das jeweils andere Repository übertragen.

Zentrales Repository auf lokales Repository

Gehe wie folgt vor, um dein Repository zu erstellen:

  1. From Bitbucket, click the + icon in the global sidebar and select Repository.

    Erstelle ein Repository-Menü

    Bitbucket displays the Create a new repository page. Take some time to review the dialog's contents. With the exception of the Repository type, everything you enter on this page you can later change.

    Erstelle das Repository.

  2. Trage in das Feld Name die Zeichenfolge BitbucketStationLocations ein. Bitbucket verwendet den Wert im Feld Name in der URL des Repositorys. 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. For Access level, leave the This is a private repository box checked. A private repository is only visible to you and those you give access to. If this box is unchecked, everyone can see your repository.

  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.

Schritt 2: Untersuche dein neues Repository.

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

Übersicht über das Repository

Click + from the global sidebar for common actions for a repository. Click items in the navigation sidebar to see what's behind each one, including Settings to update repository details and other settings. To view the shortcuts available to navigate these items, press the ? key on your keyboard.

When you click the Commits option in the sidebar, you find that you have no commits because you have not created any content for your repository. Your repository is private and you have not invited anyone to the repository, so the only person who can create or edit the repository's content right now is you, the repository owner.

Git-Repositorys kopieren und Dateien hinzufügen

Da du jetzt einen Ort hast, an dem du deine Space Station-Dateien hinzufügen und teilen kannst, muss es auch eine Möglichkeit geben, von deinem lokalen System darauf zuzugreifen. Um dies einzurichten, kopierst du das Bitbucket-Repository auf dein System. Bei Git wird der Kopiervorgang als Klonen bezeichnet. Wenn du ein Repository klonst, erstellst du eine Verbindung zwischen dem Bitbucket-Server (den Git als "origin" kennt) und deinem lokalen System.

Von Origin auf lokal

In den nächsten Schritten wirst du eine ganze Reihe von Befehlen über ein Terminal ausführen, sowohl Git-Befehle als auch andere Befehle. Falls du noch nie mit der Befehlszeile gearbeitet hast: Hier findest du einen Crashkurs zur Befehlszeile ("Command Line Crash Course").

Schritt 1: 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 Startverzeichnis (~).

    $ 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.

    $ mkdir repos
  3. Wähle über das Terminal das neue Repository-Verzeichnis als Arbeitsverzeichnis aus:

    $ cd ~/repos
  4. Öffne in Bitbucket dein Repository BitbucketStationLocations.

  5. Click the + icon in the global sidebar and select Clone this repository.

    Bitbucket displays a pop-up clone dialog. By default, the clone dialog sets the protocol to HTTPS or SSH, depending on your settings. For the purposes of this tutorial, don't change your default protocol.

     

    Klondialog

     

  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 in das Terminal ein, sobald du dazu aufgefordert wirst. Falls du deinen Account über eine Verknüpfung mit Google erstellt hast, musst du dein Google-Passwort eingeben.

    • 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

         $ git clone
        https://emmap1@bitbucket.org/emmap1/bitbucketstationlocations.git
        Klonen in "bitbucketspacestation"...
        schwerwiegend: konnte Passwort für
        "https://emmap1@bitbucket.org" nicht lesen: Es gibt keine derartige Datei oder so ein Verzeichnis
      • Wenn du diese Fehlermeldung erhältst, gib Folgendes in die Befehlszeile ein:

         $ git config --global core.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
      $ git clone https://emmap1@bitbucket.org/emmap1/bitbucketstationlocations.git
      Cloning into 'bitbucketstationlocations'...
      Password
      warning: You appear to have cloned an empty repository.

      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

Perfekt. Damit hast du dein Repository erfolgreich auf dein lokales System geklont.

Schritt 2: 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/
  2. Gib die folgende Zeile in das Terminalfenster ein, um eine neue Datei mit Inhalt zu erstellen:

    $ echo "Earth's Moon" >> 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:

    $ git status
    Auf dem master-Branch
    Erster Commit
    Nicht nachverfolgte Dateien:
    (Verwende "git add <file>..." als Ergänzung für das, was committet wird.)
    locations.txt
    Es wurde nichts zum Committen hinzugefügt, es sind aber nicht nachverfolgte Dateien vorhanden (verwende "git add" zur Nachverfolgung).

    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 mit dem Befehl git add an, die neue Datei locations.txt zu verfolgen. Genau wie bei der Dateierstellung gilt: Bei korrekter Eingabe gibt der Befehl git add keine Ausgabe zurück.

    $ git add locations.txt

    Der Befehl git add verschiebt Änderungen aus dem Arbeitsverzeichnis in die Staging-Umgebung von Git. In der Staging-Umgebung erstellst du einen Snapshot eines Satzes von Änderungen, bevor du diese Änderungen per Commit in den offiziellen Verlauf überträgst.

     

    Git add-Staging

     

  5. Überprüfe den Status der Datei.

    $ git status
    Auf dem master-Branch
    Erster Commit
    Änderungen, die commitet werden sollen:
    (Verwende "git rm --cached <file>...", um das Staging aufzuheben)
    neue Datei: 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. Führe nun wie nachfolgend demonstriert den Befehl git commit mit einer Commit-Nachricht aus. Dabei gibt "-m" an, dass eine Commit-Nachricht folgt.

    $ git commit -m "erster Commit"
    [master (root-commit) fedc3d3] erster Commit
    1 Datei geändert, 1 Einfügung(+)
    Modus erstellen 100644 locations.txt

    Der Befehl git commit committet den Snapshot aus der Staging-Umgebung in den Projektverlauf. Zusammen mit git add bildet er den grundlegenden Workflow für alle Git-Benutzer.

     

    Git commit

     

    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.

         

        Git Branching

         

      • 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 master alle committeten Änderungen an Bitbucket. Dieser Befehl pusht die Änderungen in den Master-Branch (Bitbucket-Branch) auf "origin" (Bitbucket-Server).

    Die Antwort sollte in etwa wie folgt aussehen:

    $ git push origin master
    Objekte werden gezählt: 3, erledigt.
    Objekte werden geschrieben: 100 % (3/3), 253 Byte | 0 Byte/s, erledigt.
    Gesamt 3 (Delta 0), wiederverwendet 0 (Delta 0) An https://emmap1@bitbucket.org/emmap1/bitbucketstationlocations.git
    * [neuer Branch] master -> master
    master-Branch eingerichtet für Nachverfolgung Remote-master-Branch von origin.

    Deine Commits befinden sich jetzt im Remote-Repository ("origin").

     

    Git push

     

  8. Go to your BitbucketStationLocations repository on Bitbucket.

  9. If you click Commits in the sidebar, you'll see a single commit on your repository. Bitbucket combines all the things you just did into that commit and shows it to you. You can see that the Author column shows the value you used when you configured the Git global file ( ~/.gitconfig).
    If you click Source in the sidebar, you'll see that you have a single source file in your repository, the locations.txt file you just added.

    Bitbucket-Commits

Erinnerst du dich, wie das Repository aussah, als du es erstellt hast? Wahrscheinlich sieht es jetzt etwas anders aus.

Änderungen aus Git-Repositorys in Bitbucket Cloud pullen

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.

Schritt 1: Erstelle eine Datei in Bitbucket.

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

  1. Klicke in deinem Repository BitbucketStationLocations auf Source (Quelle), um das Quellverzeichnis zu öffnen. In deinem Verzeichnis wird aktuell nur eine Datei angezeigt: locations.txt.

    Bitbucket-DatenquellenfensterA. Branch selection: Pick the branch you want to view.
    B. Source page: Click the link to open this page.
    C. New file button: Edit and create a file in Bitbucket.
    D. Source file area: View the directory of files in Bitbucket.

  2. From the Source page, click New file in the top right corner. This button only appears after you have added at least one file to the repository.

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

    Bitbucket neue DateiA. Branch with new file: Change if you want to add file to a different branch.
    B. New file area: Add content for your new file here. 

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

  4. Wähle aus der Liste Syntax mode (Syntaxmodus) die Option HTML aus.

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

    <p>Bitbucket verfügt über die folgenden Space Stations:</p>
    <p>
    <b>Earth's Moon</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 (Committen).

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:

Bitbucket Commit-Nachricht

If you want to see a list of the commits you've made so far, click Commits in the sidebar.

Schritt 2: Pulle Änderungen von einem Remote-Repository.

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/
  2. Gib den Befehl git pull --all ein, um alle Änderungen aus Bitbucket zu pullen. (In komplexeren Branch-Workflows ist es unter Umständen nicht ratsam, alle Änderungen zu pullen und zu mergen.) Gib dein Bitbucket-Passwort ein, sobald du dazu aufgefordert wirst. Die Ausgabe im Terminal sollte in etwa wie folgt aussehen:

    $ git pull --all
    origin wird abgerufen
    remote: Objekte werden gezählt: 3, erledigt.
    remote: Objekte werden komprimiert: 100 % (3/3), erledigt.
    remote: Gesamt 3 (Delta 0), wiederverwendet 0 (Delta 0)
    Objekte werden entpackt: 100 % (3/3), erledigt.
    Von https://bitbucket.org/emmap1/bitbucketstationlocations
    fe5a280..fcbeeb0 master -> origin/master
    Update von fe5a280..fcbeeb0
    Fast-forward
    stationlocations | 5 ++++++++++++++
    1 Datei geändert, 5 Einfügungen(+)
    Modus erstellen 100644 stationlocations

    Mit git pull wird die Datei aus deinem Remote-Repository (Bitbucket) über einen einzigen Befehl mit deinem lokalen Repository zusammengeführt.

    Von Origin auf lokal

  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.

Datei-Merges mit einem Git-Branch durchführen

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 (Master). Das Schaubild unten zeigt diesen Master-Branch sowie einen weiteren Branch mit einem Bugfix-Update.

Git Branching

Schritt 1: 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:

Master-Branch

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/
  2. Erstelle über das Terminalfenster einen Branch:

    $ git branch future-plans

    Mit diesem Befehl erstellst du einen Branch, wechselst aber zu diesem Zeitpunkt noch nicht in diesen Branch. Dein Repository sieht also ungefähr wie folgt aus:

    Branch erstellen

    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:

    $ git checkout future-plans
    Wechsel zu Branch "future-plans"

    Die Befehle git checkout und git branch greifen eng ineinander. Da Branches spezifisch für die Arbeit an neuem Code erstellt werden, solltest du jeden mit git branch neu erstellten Branch mit git checkout auschecken, bevor du ihn verwendest. Nach dem Auschecken des neuen Branches sieht dein Git-Workflow in etwa wie folgt aus:

    Feature Branching

  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>Bitbucket verfügt über die folgenden Space Stations:</p>
    <p>
    <b>Earth's Moon</b><br>
    Headquarters
    </p>
    <p>
    <b>Mars</b><br>
    Recreation Department
    </p>
  7. Speichere die Datei und schließe sie.

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

    $ git status
    Auf Branch future-plans
    Änderungen nicht für Commit bereitgestellt:
    (Verwende "git add <Datei>...", um zu aktualisieren, was committet wird.)
    (Verwende "git checkout -- <Datei>...", um Änderungen im Arbeitsverzeichnis zu verwerfen.)
    Geändert: stationlocations
    Commit wurden keine Änderungen hinzugefügt (Verwende "git add" und/oder "git commit -a".)

    Entscheidend ist hier die Zeile On branch future-plans. Als du zuvor git status eingegeben hast, lautete diese Zeile noch On branch master, weil nur der master-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:

    $ git add stationlocations
  10. Gib den Befehl git commit wie unten dargestellt in das Terminalfenster ein:

    $ git commit stationlocations -m "Vornehmen von Änderungen in einem Branch"
    [future-plans e3b7732] Vornehmen einer Änderung in einem Branch
    1 Datei geändert, 4 Einfügungen(+)

    Mit diesem neuesten Commit sieht dein Repository etwa wie folgt aus:

     

    Feature-Branch-Commit

     

    Jetzt musst du die gerade vorgenommene Änderung mit dem Branch master zusammenführen, d. h. einen Merge durchführen.

Schritt 2: Merge deinen Branch: Fast-Forward-Merging

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.

Fast-Forward-Merge

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/
  2. Überprüfe mit dem Befehl git status, ob du alle deine Änderungen committet hast und welchen Branch du ausgecheckt hast.

    $ git status
    Auf Branch future-plans
    nichts zu committen, Arbeitsverzeichnis ist sauber
  3. Wechsle in den Branch master.

    $ git checkout master
    Wechsel zu Branch "master"
    Dein Branch ist auf aktuellem Stand wie "origin/master".
  4. Führe die Änderungen aus dem Branch future-plans per Merge mit dem Branch master zusammen. Die Ausgabe wird in etwa wie folgt aussehen:

    $ git merge future-plans
    Update von fcbeeb0..e3b7732
    Fast-forward
    stationlocations | 4 ++++
    1 Datei geändert, 4 Einfügungen(+)

    Im Grunde genommen hast du damit den Pointer zum Branch master an die aktuelle Kopfposition verschoben. Dein Repository sieht nun in etwa 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.

    $ git branch -d future-plans
    Branch future-plans wurde gelöscht (war e3b7732).

    Nachdem du den Branch future-plans gelöscht hast, kannst du immer noch mithilfe einer Commit-ID über den Branch master 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. Die Ausgabe wird in etwa wie folgt aussehen:

    $ git status
    Auf master-Branch
    Dein Branch liegt mit einem Commit vor "origin/master".
    (Verwende "git push", um deine lokalen Commits zu veröffentlichen.)
    nichts zu committen, Arbeitsverzeichnis ist sauber

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).

Schritt 3: 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.

Vor und nach dem Pushen des Branch

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 master in das Terminalfenster ein, um die Änderungen zu pushen. Die resultierende Ausgabe wird in etwa wie folgt aussehen:

    $ git push origin master
    Objekte werden gezählt: 3, erledigt.
    Delta-Kodierung verwendet bis zu 8 Threads.
    Objekte werden komprimiert: 100 % (3/3), erledigt.
    Objekte werden geschrieben: 100 % (3/3), 401 Byte | 0 Byte/s, erledigt.
    Gesamt 3 (Delta 0), wiederverwendet 0 (Delta 0)
    Nach https://emmap1@bitbucket.org/emmap1/bitbucketstationlocations.git
    fcbeeb0..e3b7732 master -> master
  2. Öffne in deinem Bitbucket-Repository die Seite Overview (Übersicht). Der Push ist hier unter Recent Activity (Letzte 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.

    Commit-Aktivität

    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 Source (Quelle) und anschließend 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:

    Dateiverlauf

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.