Enterprise Server 3.15 ist derzeit als Release Candidate verfügbar.

Hello World

Mit dieser Hello-World-Übung lernen Sie den Pull-Request-Workflow von GitHub Enterprise Server kennen.

In diesem Artikel

Einführung

In diesem Tutorial werden GitHub Enterprise Server-Grundlagen wie Repositorys, Commits und Pull Requests behandelt. Du erstellst ein eigenes Hallo-Welt-Repository und lernst den Pull-Request-Workflow von GitHub Enterprise Server kennen, der häufig beim Programmieren und für Code Reviews eingesetzt wird.

Inhalt dieses Schnellstarts:

  • Erstellen und Verwenden eines Repositorys.
  • Beginnen und Verwalten eines neuen Branches.
  • Bearbeiten von Dateien und Pushen der Dateien an GitHub Enterprise Server als Commits.
  • Öffnen und Mergen von Pull Requests.

Voraussetzungen

  • Sie müssen ein GitHub-Konto haben.

  • du benötigst keine Kenntnisse im Programmieren oder im Umgang mit der Befehlszeile. Auch eine Installation von Git (Versionskontrollsoftware, auf der GitHub Enterprise Server basiert) ist nicht erforderlich.

Schritt 1: Erstellen eines Repositorys

Als Erstes erstellen wir ein Repository. Sie können sich ein Repository als Ordner vorstellen, der verwandte Elemente enthält, z. B. Dateien, Bilder, Videos oder sogar andere Ordner. Ein Repository gruppiert in der Regel Elemente, die zum gleichen „Projekt“ gehören oder an dem Sie gerade arbeiten.

Häufig enthalten Repositorys eine README-Datei. Dabei handelt es sich um eine Datei mit Informationen zu deinem Projekt. Infodateien sind in Markdown geschrieben, einer leicht lesbaren und einfach zu schreibenden Sprache zur Formatierung von einfachem Text. Im nächsten Tutorial „Einrichten deines Profils“ erfahren Sie mehr über Markdown.

Auf GitHub Enterprise Server kannst du beim Erstellen eines neuen Repositorys eine README-Datei hinzuzufügen. Auf GitHub Enterprise Server gibt es auch andere gängige Optionen, zum Beispiel für Lizenzdateien, doch diese musst du jetzt nicht ausprobieren.

In deinem hello-world-Repository kannst du Ideen und Ressourcen speichern, für andere freigeben und sich mit anderen austauschen.

  1. Wähle in der rechten oberen Ecke einer beliebigen Seite , und klicke dann auf Neues Repository.

    Screenshot eines GitHub-Dropdownmenüs mit Optionen zum Erstellen neuer Elemente. Das Menüelement „Neues Repository“ ist in dunklem Orange eingerahmt.

  2. Gib hello-world in das Feld „Repositoryname“ ein.

  3. Gib im Feld „Beschreibung“ eine kurze Beschreibung ein. Geben Sie zum Beispiel Folgendes ein: „Dieses Repository dient zum Üben des GitHub-Flows.“

  4. Wähle die Option Öffentlich oder Privat für dein Repository aus.

  5. Wähle README-Datei hinzufügen aus.

  6. Klicke auf Repository erstellen.

Schritt 2: Erstellen eines Branch

Mithilfe von Branching kannst du verschiedene Versionen eines Repositorys gleichzeitig verwalten.

Standardmäßig verfügt dein Repository über einen Branch mit dem Namen main, der als maßgeblicher Branch betrachtet wird. Basierend auf main kannst du zusätzliche Branches in deinem Repository erstellen.

Verzweigungen sind hilfreich, wenn Sie einem Projekt neue Funktionen hinzufügen möchten, ohne den Hauptcode zu ändern. Die an den anderen Branches vorgenommenen Änderungen werden erst in den Mainbranch aufgenommen, wenn du diese mergst. Dieses Thema wird später in diesem Leitfaden behandelt. Du kannst Branches verwendest, um Experimente und Änderungen vorzunehmen, bevor du diese an main committest.

Wenn du einen Branch aus main erstellst, handelt es sich um eine Kopie bzw. Momentaufnahme von main zum jeweiligen Zeitpunkt. Wenn eine andere Person Änderungen an main vornimmt, während du an deinem Branch arbeitest, könntest du diese Updates pullen.

Dieses Diagramm zeigt:

  • Der Branch main
  • Ein neuer Branch namens feature
  • Der Weg von feature bis zum Merge mit main

Abbildung der beiden Branches. Der Branch „feature“ wird basierend auf dem Branch „main“ erstellt, durchläuft die Stages „Commitänderungen“, „Pull Request übermitteln“ sowie „Vorgeschlagene Änderungen diskutieren“ und wird anschließend wieder mit dem main-Branch gemergt.

Branch erstellen

  1. Klicke auf die Registerkarte Code deines hello-world-Repositorys.

  2. Klicke oberhalb der Dateiliste auf das Dropdownmenü main.

    Screenshot der Repositoryseite. Ein Dropdownmenü mit einem Branchsymbol und der Bezeichnung „main“ ist mit einem orangefarbenen Rahmen hervorgehoben.

  3. Gib den Branchnamen readme-edits in das Textfeld ein.

  4. Klicke auf Branch erstellen: readme-edits aus main.

    Screenshot des Dropdownmenüs „Branch“ für ein Repository. „Branch erstellen: readme-edits aus 'Standard'“ ist dunkelorange umrandet.

Jetzt besitzt du die beiden Branches main und readme-edits. Derzeit sind diese identisch. Nehmen Sie nun Änderungen am neuen Branch readme-edits vor.

Schritt 3: Änderungen vornehmen und bestätigen

Als du im vorherigen Schritt einen neuen Branch erstellt hast, hat GitHub Enterprise Server dich zur Codepage für den neuen Branch readme-edits gebracht, der eine Kopie von main ist.

Du kannst Änderungen an den Dateien im Repository vornehmen und speichern. Gespeicherte Änderungen heißen auf GitHub Enterprise Server Commits. Jeder Commit hat eine zugehörige Commitnachricht, die als Erklärung dient, warum eine bestimmte Änderung vorgenommen wurde. Commitnachrichten erfassen den Verlauf deiner Änderungen, damit andere Mitwirkende nachvollziehen können, was du getan hast und warum.

  1. Klicken Sie unter dem erstellten readme-edits-Branch auf die Datei README.md.
  2. Wähle aus, um die Datei zu bearbeiten.
  3. Gib im Editor eine kurze Information zu deiner Person an.
  4. Klicken Sie auf Änderungen committen.
  5. Gib im Feld „Änderungen committen“ eine Nachricht ein, die deine Änderungen beschreibt.
  6. Klicke auf Änderungen committen.

Diese Änderungen werden nur an der README-Datei in deinem readme-edits-Branch vorgenommen, sodass dieser nun einen anderen Inhalt als main hat.

Schritt 4: Öffnen eines Pull Requests

Nachdem du nun Änderungen in einem aus main erstellten Branch vorgenommen hast, kannst du einen Pull Request öffnen.

Pull Requests sind das Herzstück der Zusammenarbeit auf GitHub Enterprise Server. Wenn du einen Pull Request öffnest, schlage deine Änderungen vor und beantrage ein Review. Der oder die Reviewer*in pullt deinen Beitrag und mergt diesen mit seinem oder ihrem Branch. Pull Requests heben die Unterschiede zwischen dem Inhalt beider Branches hervor. Die geänderten, ergänzten und entfernten Inhalte werden in verschiedenen Farben angezeigt.

Sobald du einen Commit vornimmst, kannst du einen Pull Request öffnen und eine Diskussion anstoßen, auch wenn der Code noch nicht fertig ist.

In diesem Schritt öffnen Sie einen Pull Request in Ihrem eigenen Repository und führen ihn dann selbst zusammen. Dies ist eine gute Möglichkeit, den Ablauf von GitHub Enterprise Server zu üben, bevor Sie an größeren Projekten arbeiten.

  1. Klicke auf die Registerkarte Pull Requests deines hello-world-Repositorys.

  2. Klicke auf Neuer Pull Request.

  3. Wähle im Feld Beispielvergleiche den von dir erstellten Branch readme-edits aus, der mit main (dem Original) verglichen werden soll.

  4. Überprüfe deine als Unterschiede dargestellten Änderungen auf der Seite „Vergleich“, um sich zu vergewissern, dass du diese Änderungen übermitteln möchtest.

    Screenshot eines Diffs für die Datei „README.md“. 3 rote Zeilen enthalten den Text, der entfernt wird, und 3 grüne Linien enthalten den hinzugefügten Text.

  5. Klicke auf Pull Request erstellen.

  6. Gib einen Titel für deinen Pull Request und eine kurze Beschreibung deiner Änderungen ein. Du kannst auch Emojis einfügen, außerdem Bilder und GIFs per Drag & Drop.

  7. Klicken Sie auf Pull Request erstellen.

Überprüfen eines Pull Requests

Wenn Sie anfangen, mit anderen zusammenzuarbeiten, ist dies der Zeitpunkt, an dem Sie sie um eine Bewertung bitten. Dies ermöglicht es Ihren Projektmitarbeitern, Ihre Pull Request zu kommentieren oder Änderungen vorzuschlagen, bevor Sie die Änderungen in die main-Verzweigung zusammenführen.

Wir behandeln das Überprüfen von Pull Requests in diesem Tutorial nicht, aber wenn Sie mehr erfahren möchten, lesen Sie "Informationen zu Pull-Request-Reviews". Alternativ können Sie auch den Kurs GitHub Skills „Überprüfen von Pull Requests“ testen.

Schritt 5: Mergen Ihres Pull Requests

Im letzten Schritt mergst du deinen readme-edits-Branch mit dem main-Branch. Nach dem Mergen deines Pull Request werden die Änderungen am readme-edits-Branch in main integriert.

Manchmal führen die Codeänderungen durch den Pull Request zu Konflikten mit dem bestehenden Code in main. Falls Codekonflikte auftreten, zeigt GitHub Enterprise Server eine Warnung an und verhindert den Mergevorgang, bis die Konflikte behoben sind. Du kannst die Konflikte mit einem Commit beheben oder Kommentare im Pull Request erstellen, um diese mit Teammitgliedern zu besprechen.

In dieser exemplarische Vorgehensweise sollten keine Konflikte vorhanden sein. Du bist also bereit, deinen Branch mit dem Mainbranch zu mergen.

  1. Wähle unten im Pull Request Pull Request zusammenführen aus, um die Änderungen in main zusammenzuführen.
  2. Klicke auf Merge bestätigen. Es wird eine Meldung angezeigt, dass der Pull Request erfolgreich gemergt und geschlossen wurde.
  3. Klicke auf Branch löschen. Da dein Pull Request gemergt wurde und deine Änderungen in main gespeichert sind, kannst du den readme-edits-Branch bedenkenlos löschen. Wenn du weitere Änderungen an deinem Projekt vornehmen möchtest, kannst du jederzeit einen neuen Branch erstellen und diesen Vorgang wiederholen.
  4. Klicken Sie auf die Registerkarte Code in Ihrem hello-world-Repository, um Ihre veröffentlichten Änderungen an main zu sehen.

Zusammenfassung

In diesem Tutorial hast du erfahren, wie du auf GitHub Enterprise Server ein Projekt und einen Pull Request erstellst.

Als Teil davon haben wir Folgendes gelernt:

  • Erstellen eines Repositorys.
  • Beginnen und Verwalten eines neuen Branches.
  • Ändern einer Datei und Committen der Änderungen an GitHub Enterprise Server.
  • Öffnen und Mergen von Pull Requests.

Nächste Schritte

  • Besuche nun dein GitHub Enterprise Server-Profil. Dort siehst du, dass deine Aktivitäten auf dem Beitragsdiagramm reflektiert werden.
  • Wenn Sie das in diesem Tutorial Gelernte noch einmal üben möchten, versuchen Sie den GitHub Skills-Kurs „Einführung in GitHub“.
  • Im nächsten Tutorial, „Einrichten deines Profils“, lernen Sie, wie Sie Ihr Profil personalisieren können und Sie lernen auch einige grundlegende Markdown-Syntax für das Schreiben auf GitHub Enterprise Server.

Weiterführende Themen