Versionskontrolle meistern: Praktischer Leitfaden zu Git und GitHub für Entwickler

Das Leben eines Programmierers ist schon hart genug. Warum nicht das Leben erleichtern und die Versionskontrolle Ihrer Projekte an dedizierte Services auslagern? Die meisten Programmierer in der IT-Welt sind mit Git vertraut, aber für einige OT-Programmierer in dieser Community ist dies ein völlig neues Konzept. Wenn man mit verschiedenen Kollegen am selben Projekt arbeitet, wird das Teilen von Code noch mehr zur Qual – ein Service wie GitHub macht es einfach, Code zu teilen und gemeinsam daran zu arbeiten. Dieser Blog führt Sie durch Ihre ersten Schritte bei der Verwendung von Git und GitHub, um Ihren Code und Ihre Projekte in Ordnung zu halten.

---

In diesem Blog verwende ich GitHub und den GitHub-Client für Windows, aber beachten Sie, dass es weitere Optionen einschließlich GitLab gibt. Ich mag einfach die Benutzerfreundlichkeit des GitHub-Clients!

---

Repository auf GitHub einrichten

Schritt 1 – GitHub Client für Windows herunterladen und installieren

Eigentlich wäre der erste Schritt, ein GitHub-Konto zu erstellen, aber das liegt etwas außerhalb des Rahmens dieses Blogs.

1. Der Client kann hier heruntergeladen werden.
2. Installationsanleitung befolgen
3. Bei Ihrem GitHub-Konto anmelden

Schritt 2 – Ordner oder Repository für Ihr Projekt erstellen

Ein Repository ist ein Ort für Ihr Projekt. Erstellen Sie einen Ordner für jedes Projekt! Jedes Mal, wenn sich etwas in diesem Ordner ändert, erkennt der GitHub-Client dies und Sie können Ihre Änderungen im Online-Repository auf GitHub speichern oder pushen.

1. Auf „Neues Repository auf Ihrer Festplatte erstellen…“ klicken
2. Dem neuen Repository einen Namen und eine Beschreibung geben.
3. Sie können den Pfad für das Repository ändern, wenn Sie möchten, oder ihn belassen (der faule Weg)
4. „Repository mit README initialisieren“ anklicken (Faul heißt nicht, dass man Best Practices nicht befolgt und seinen Code dokumentiert!)
5. Repository erstellen

Schritt 3 – Ein PLCnext-Projekt erstellen

Git funktioniert hervorragend mit textbasierten Dateien. Glücklicherweise gibt es in PLCnext Engineer die Option, Ihr Projekt als eine Menge Textdateien zu speichern – perfekt für Git und damit für unseren GitHub-Client!

1. PLCnext Engineer öffnen und wie gewohnt ein Projekt erstellen.
2. Wenn Sie bereit sind, Ihr Projekt zu speichern, „Projekt speichern unter“ wählen (F12)
3. Zu Ihrem GitHub-Repository navigieren (Standard: Dieser PC/Dokumente/GitHub)
4. Projekt als „Unkomprimiertes Projekt“ speichern

Schritt 4 – Änderungen committen

Um Änderungen in Ihrem Repository zu „speichern“, müssen Sie sie in einen Branch committen. Was genau ein Branch ist, erkläre ich später – fürs Erste müssen Sie sich nur merken, dass Sie Ihre Änderungen in einen Branch committen müssen, um sie zu speichern.

Geben Sie Ihrem Commit einen prägnanten Titel und eine kurze Beschreibung, damit Sie sich erinnern, was sich genau geändert hat!

Schritt 5 – Repository veröffentlichen oder pushen

Der letzte Schritt, um ein Repository online zu erstellen, ist, unser lokales Repository zu GitHub zu pushen. Das ist so einfach wie einen Button zu drücken oder Strg+P zu drücken. Wählen Sie, ob Ihr Code privat sein soll und ob er Ihnen oder einer Organisation gehört.

Schritt 6 – Dokumentieren!

Drücken Sie Strg+Umschalt+G, um das Repository online auf GitHub in Ihrem Browser anzuzeigen. Voilà! Da ist Ihr PLCnext-Projekt auf GitHub. Erinnern Sie sich an „README initialisieren“? Das ist der Text, den Sie jetzt vor sich sehen. In der README.md sollten Sie die Struktur des Projekts, den Zweck und vielleicht einige Kontaktinformationen für zukünftige Referenzen erklären.

Machen Sie jetzt einige Änderungen an der README.md-Datei, indem Sie auf den Stift klicken. Die Datei ist in „MarkDown“ geschrieben, mehr Informationen zu MarkDown finden Sie hier.

Wenn Sie Änderungen vorgenommen haben, wieder in den Master-Branch committen!

Schritt 7 – Änderungen in Ihr lokales Repository pullen

Der Windows-Client erkennt, dass Änderungen am Repository auf GitHub vorgenommen wurden. Vergessen Sie nicht, die Änderungen zu pullen, um wieder an der neuesten Version zu arbeiten!

---

Tipps & Tricks

Issue Tracker

GitHub hat einen großartigen Issue Tracker – nutzen Sie ihn, um bekannte Probleme in Ihrer Software zu verfolgen und Lösungen mit anderen Beteiligten zu diskutieren.

Projects

Nutzen Sie das integrierte Project Board, um Ihre Aufgaben mit einem Kanban-Board im Blick zu behalten. Wenn Sie möchten, können Sie Ihr Kanban mit eingebauten Triggern automatisieren, um das Leben noch einfacher zu machen.

Branches

Ah, hier sind wir. Sieh an, ich sagte, ich würde erklären, was Branches sind! Nun, ich lasse GitHub erklären, was Branches sind…

Viele Änderungen vornehmen oder ein neues Feature implementieren? Erstellen Sie einen Branch, um Ihre Änderungen isoliert zu halten, und mergen Sie Ihren „Feature Branch“ per Pull Request in Ihren Master-Branch.

Releases

Bereit zum Deployen eines Projekts? Erstellen Sie ein Release, um es zu Ihrem AS Build hinzuzufügen!