Git integreren met Logix Designer: Gratis, betrouwbare versiebeheer voor Rockwell-projecten

Rockwell Automation heeft net een set gratis command-line tools uitgebracht, genaamd VCS Custom Tools, waarmee je Git met Studio 5000 Logix Designer kunt gebruiken voor versiebeheer. In dit artikel laat ik zien hoe je deze tools kunt gebruiken om een betrouwbaar versiebeheersysteem voor je Logix Designer-projecten gratis te implementeren.

Een Studio 5000 Logix Designer-project wordt op een computer opgeslagen als een enkel binair bestand met de extensie .acd. Omdat projecten als een enkel binair bestand worden opgeslagen, zijn ze zelfstandig, moeilijk te corrumperen en makkelijk te delen.

Helaas zijn binaire bestanden incompatibel met tekst-gebaseerde versiebeheersystemen zoals Git.

Rockwell Automation's VCS Custom Tools lost dit op door die ACD-bestanden om te zetten in tekstbestanden die compatibel zijn met Git. Globaal gezien doen Rockwell Automation's VCS Custom Tools het volgende:

• Converteren een binair ACD-bestand naar een menselijk leesbaar L5X-bestand,
• Ontploffen het L5X-bestand in kleinere tekstbestanden die in mappen georganiseerd zijn,
• Committen de ontploffte bestanden naar een Git-repository

Door deze tools te gebruiken, kun je een heel betrouwbaar en robuust versiebeheersysteem voor je Studio 5000 Logix Designer-projecten gratis implementeren.

Voordat ik laat zien hoe je deze tools gebruikt, wil ik dit proces iets gedetailleerder uitleggen.

L5X-bestanden

De VCS Custom Tools werken door een binair ACD-bestand om te zetten in een L5X-bestand. Als je er niet bekend mee bent: L5X-bestanden zijn XML-representaties van een Logix Designer-project of een onderdeel van een project. In tegenstelling tot binaire bestanden bevatten XML-bestanden menselijk leesbare inhoud.

L5X-bestanden werken beter met Git omdat ze tekstbestanden zijn. Omdat ze tekstbestanden zijn, kan Git je precies laten zien wat er in het bestand is gewijzigd en kan hij automatisch wijzigingen van verschillende ontwikkelaars in hetzelfde bestand samenvoegen.

Ontploffing (Explosion)

Het probleem met werken met L5X-bestanden is dat ze heel grote bestanden kunnen zijn, en de inhoud binnen het bestand kan verplaatsen.

Om dit probleem op te lossen, laten de VCS Custom Tools een L5X-bestand ontploffen in componenten. Deze ontploffing laat je werken met kleinere, goed georganiseerde bestanden in plaats van één gigantisch bestand, wat het makkelijker maakt om op een oogopslag te zien wat er gewijzigd is.

Git

Ten slotte gebruiken de VCS Custom Tools Git om daadwerkelijk wijzigingen te traceren en het project te back-uppen.

Git is een gedistribueerd versiebeheersysteem dat wijd wordt gebruikt in traditionele softwareontwikkeling. Door Git te gebruiken, kun je een volledige geschiedenis bouwen van elke wijziging die ooit aan een project is gemaakt, eenvoudig back-ups maken van een project naar een remote repository, en snel een project herstellen naar een eerdere staat.

Bij het werken met Git zijn er een paar belangrijke termen die je moet kennen:

Een Repository, of repo, is een slimme map die wijzigingen aan een project traceert.

Wanneer je wijzigingen aan een project maakt, commit je die wijzigingen naar je lokale repository. Een commit is een snapshot van je project op een specifiek moment in de tijd die later hersteld kan worden.

Om je project te back-uppen, kun je je wijzigingen pushen naar een remote repository, die meestal op GitHub gehost wordt.

Als een andere ontwikkelaar wijzigingen aan een project maakt, kun je die wijzigingen pullen naar je lokale repository.

Nu we begrijpen hoe de VCS Custom Tools werken, laten we zien hoe je ze gebruikt.

Je omgeving instellen

Om de VCS Custom Tools te gebruiken, heb je Studio 5000 Logix Designer, de Studio 5000 Logix Designer SDK en Git op je computer geïnstalleerd nodig.

Je moet ook de VCS Custom Tools-repository naar je computer klonen en de tools bouwen tot een uitvoerbaar bestand. Dat kun je doen met het git clone-commando in een Command Prompt-venster zoals hier getoond.

Eenmaal de repository gekloond, kun je de tools bouwen door het cd-commando te gebruiken om in de VCS-map te schakelen en vervolgens het build-commando uit te voeren.

Zodra de tools gebouwd zijn, kunnen we ze met onze projecten gebruiken.

De VCS Custom Tools gebruiken

Het eerste wat we moeten doen is een Git Repository instellen voor het Logix Designer-project.

Dat kan ik doen door een nieuwe map aan te maken met het make dir-commando, in de nieuwe map te schakelen met het cd-commando, en vervolgens een Git-repository te initialiseren met het git init-commando.

Eenmaal de repository ingesteld, kun je wijzigingen aan een Logix Designer-project committen met het l5xgit commit-commando.

De eerste keer dat je dit commando uitvoert, moet je de locatie van de Git-repository opgeven en of een commit-bericht verplicht is voor elke commit.

Dit commando kan lang duren. Het goede nieuws is dat het een kopie van het project aanmaakt, zodat je kunt blijven werken in je project terwijl de VCS Custom Tools op de achtergrond draaien.

Wanneer het commit-proces voltooid is, zie je je ontploffte L5X-bestand in je Git-repository. Als je woult, kun je deze wijzigingen pushen naar een remote repository om een off-site back-up van het project te maken.

Een commit herstellen

Indien nodig, kun je een project herstellen naar de laatste commit met het l5xgit restore-commando.

Dit commando implodeert je Git-repository naar een L5X-bestand en converteert dat L5X-bestand vervolgens terug naar een ACD-bestand.

Je moet het project in Studio 5000 Logix Designer sluiten voordat het restore-commando werkt.

Studio 5000 Logix Designer-integratie

Ten slotte kunnen de VCS Custom Tools geïntegreerd worden in de UI van Studio 5000 Logix Designer via het Custom Tools-menu.

Om de VCS Custom Tools aan de Logix Designer UI toe te voegen, kopieer je het CustomMenu.xml-bestand uit de VCS Custom Tools-map naar de Common-map van de RSLogix 5000-installatie zoals hier getoond.

Wanneer je Logix Designer herstart, zie je dat alle VCS Custom Tools-commando's nu beschikbaar zijn in het Tools-menu van Logix Designer.

Samenvatting

In dit artikel heb je geleerd hoe je Rockwell Automation's Custom VCS Tools kunt gebruiken om een Git-gebaseerd versiebeheersysteem voor je projecten te implementeren.

Door Git te gebruiken, kunnen engineering-teams een complete geschiedenis krijgen van wijzigingen die aan een project zijn gemaakt, samen met een oplossing voor het back-uppen en herstellen van PLC-software met gratis tools.

Laat ons in de reacties weten welke tools jij gebruikt voor versiebeheer op je projecten.