Versionskontrolle – Der faule Weg

Das Leben eines Programmierers ist so schon hart genug. Warum machen Sie sich nicht das Leben leichter und lagern die Versionskontrolle Ihrer Projekte an einige dedizierte Dienste aus? Die meisten Programmierer in der IT-Welt sind mit Git vertraut, aber für einige der OT-Programmierer in dieser Community ist dies ein brandneues Konzept. Wenn die Arbeit mit verschiedenen Kollegen am selben Projekt, die Code teilen, noch mühsamer wird, macht es ein Dienst wie GitHub einfach, denselben Code zu teilen und zusammenzuarbeiten. 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 werde ich GitHub und den GitHub-Client für Windows verwenden, aber bitte beachten Sie, dass es weitere Optionen gibt, einschließlich GitLab. Ich mag einfach die Benutzerfreundlichkeit des GitHub-Clients!

---

Ein Repository auf GitHub einrichten

Schritt 1 – Laden Sie den GitHub-Client für Windows herunter und installieren Sie ihn

Eigentlich wäre der erste Schritt, ein GitHub-Konto zu erstellen, aber das würde den Rahmen dieses Blogs etwas sprengen.

1. Der Client kann hier heruntergeladen werden.
2. Befolgen Sie die Installationsanleitung
3. Melden Sie sich bei Ihrem GitHub-Konto an

Schritt 2 – Erstellen Sie einen Ordner oder ein Repository für Ihr Projekt

Ein Repository ist ein Ort, an dem Ihr Projekt leben kann. Erstellen Sie einen Ordner für jedes Projekt! Jedes Mal, wenn sich etwas in diesem Ordner ändert, wird der GitHub-Client dies erkennen und Sie können Ihre Änderungen speichern oder in das Online-Repository auf GitHub übertragen.

1. Klicken Sie auf „Neues Repository auf Ihrer Festplatte erstellen …“
2. Geben Sie Ihrem neuen Repository einen Namen und eine Beschreibung.
3. Sie können den Pfad für das Repository ändern, wenn Sie möchten, oder es so lassen (auf die faule Art)
4. Klicken Sie auf Dieses Repository mit einer README-Datei initialisieren (Faul bedeutet nicht, Best Practices zu befolgen und Ihren Code zu dokumentieren!)
5. Erstellen Sie das Repository

Schritt 3 – Erstellen Sie ein PLCnext-Projekt

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

1. Öffnen Sie PLCnext Engineer und erstellen Sie wie gewohnt ein Projekt.
2. Wenn Sie bereit sind, Ihr Projekt zu speichern, wählen Sie Projekt speichern unter (F12)
3. Navigieren Sie zu Ihrem GitHub-Repository (Standard:This PC/documents/GitHub )
4. Speichern Sie Ihr Projekt als „unkomprimiertes Projekt“

Schritt 4 – Übernehmen Sie Ihre Änderungen

Um Änderungen in Ihrem Repository zu „speichern“, müssen Sie sie an einen Zweig übergeben. Was genau ein Branch ist, erkläre ich später, im Moment müssen Sie sich nur daran erinnern, dass Sie Ihre Änderungen in einen Branch committen müssen, um sie zu speichern.

Geben Sie Ihrem Commit eine neue und eine kurze Beschreibung, damit Sie sich daran erinnern können, was sich genau geändert hat!

Schritt 5 – Veröffentlichen oder pushen Sie Ihr Repository

Der letzte Schritt zum Erstellen eines Repositorys online besteht darin, unser lokales Repository auf GitHub zu übertragen. Dies ist so einfach wie das Drücken einer Taste oder das Drücken von (ctrl + p ). 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. Voila! 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 erläutern.

Nehmen Sie zunächst einige Änderungen an der Datei README.md vor, indem Sie auf den Bleistift klicken. Die Datei wird in MarkDown „geschrieben“ weitere Informationen zu MarkDown finden Sie hier.

Wenn Sie einige Änderungen vorgenommen haben, verpflichten Sie sich erneut zum Master-Zweig!

Schritt 7 – Änderungen in Ihr lokales Repository ziehen

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

---

Tipps &Tricks

Problemverfolgung

GitHub hat einen wunderbaren Issue-Tracker, verwenden Sie ihn, um bekannte Probleme in Ihrer Software zu verfolgen und Lösungen mit den anderen Beteiligten zu diskutieren

Projekte

Verwenden Sie das integrierte Projektbord, um Ihre Aufgabe mit einem Kanban-Bord zu verfolgen. Wenn Sie Lust haben, können Sie Ihr Kanban mit integrierten Auslösern automatisieren, um das Leben noch einfacher zu machen.

Zweige

Aah, hier sind wir. Sehen Sie, ich sagte, ich würde erklären, was Äste sind! Nun, ich lasse GitHub erklären, was Branches sind …

Werden Sie viele Änderungen vornehmen oder eine neue Funktion implementieren? Erstellen Sie einen Branch, um Ihre Änderungen isoliert zu halten, und führen Sie Ihren „Feature-Branch“ mit einem Pull-Request in Ihren Master-Branch ein.

Freigeben

Bereit, ein Projekt bereitzustellen? Erstellen Sie eine Version, die Sie Ihrem AS-Build hinzufügen können!