Intégration de Git à Logix Designer :contrôle de version gratuit et fiable pour les projets Rockwell

Rockwell Automation vient de publier un ensemble d'outils de ligne de commande gratuits, appelés VCS Custom Tools, qui vous permettent d'utiliser Git avec Studio 5000 Logix Designer pour le contrôle de version. Dans cet article, je vais vous montrer comment utiliser ces outils pour implémenter gratuitement un système de contrôle de version fiable pour vos projets Logix Designer.

Outils personnalisés VCS de Rockwell Automation

Un projet Studio 5000 Logix Designer est stocké sur un ordinateur sous la forme d'un seul fichier binaire avec l'extension .acd. Étant donné que les projets sont stockés sous la forme d'un seul fichier binaire, ils sont autonomes, difficiles à corrompre et faciles à partager.

Malheureusement, les fichiers binaires sont incompatibles avec les systèmes de contrôle de version basés sur du texte comme Git.

Les outils personnalisés VCS de Rockwell Automation résolvent ce problème en convertissant ces fichiers ACD en fichiers texte compatibles avec Git. En un coup d'œil, les outils personnalisés VCS de Rockwell Automation :

• Convertir un fichier ACD binaire en un fichier L5X lisible par l'homme
• Décomposez le fichier L5X en fichiers texte plus petits organisés en dossiers
• Envoyer les fichiers éclatés dans un dépôt Git

En utilisant ces outils, vous pouvez implémenter gratuitement un système de contrôle de version très fiable et robuste pour vos projets Studio 5000 Logix Designer.

Avant de vous montrer comment utiliser ces outils, je souhaite expliquer ce processus un peu plus en détail.

Fichiers L5X

Les outils personnalisés VCS fonctionnent en convertissant un fichier binaire ACD en fichier L5X. Si vous ne les connaissez pas, les fichiers L5X sont des représentations XML d'un projet Logix Designer ou d'un composant d'un projet. Contrairement aux fichiers binaires, les fichiers XML contiennent un contenu lisible par l'homme.

Les fichiers L5X fonctionnent mieux avec Git car ce sont des fichiers texte. Puisqu'il s'agit de fichiers texte, Git peut vous montrer exactement ce qui a changé dans le fichier et fusionner automatiquement les modifications de différents développeurs dans le même fichier.

Explosion

Le problème avec l'utilisation de fichiers L5X est qu'il peut s'agir de fichiers très volumineux et que le contenu du fichier peut se déplacer.

Pour contourner ce problème, les outils personnalisés VCS décomposent un fichier L5X en composants. Cette explosion vous permet de travailler avec des fichiers plus petits et bien organisés au lieu d'un fichier volumineux, ce qui permet de voir plus facilement en un coup d'œil ce qui a été modifié.

Git

Enfin, les outils personnalisés VCS utilisent Git pour suivre les modifications et sauvegarder le projet.

Git est un système de contrôle de version distribué largement utilisé dans le développement de logiciels traditionnels. En utilisant Git, vous pouvez créer un historique complet de chaque modification apportée à un projet, effectuer facilement des sauvegardes d'un projet sur un référentiel distant et restaurer rapidement un projet à son état précédent.

Lorsque vous travaillez avec Git, vous devez connaître quelques termes clés :

Un référentiel, ou dépôt, est un dossier intelligent qui suit les modifications apportées à un projet.

Lorsque vous apportez des modifications à un projet, vous validez ces modifications dans votre référentiel local. Un commit est un instantané de votre projet à un moment précis qui peut être restauré ultérieurement.

Pour sauvegarder votre projet, vous pouvez transférer vos modifications vers un référentiel distant, généralement hébergé sur GitHub.

Si un autre développeur apporte des modifications à un projet, vous pouvez transférer ces modifications dans votre référentiel local.

Maintenant que nous comprenons le fonctionnement des outils personnalisés VCS, voyons comment les utiliser.

Configurer votre environnement

Pour utiliser les outils personnalisés VCS, vous devez avoir Studio 5000 Logix Designer, le SDK Studio 5000 Logix Designer et Git installés sur votre ordinateur.

Vous devrez également cloner le référentiel VCS Custom Tools sur votre ordinateur et créer les outils dans un fichier exécutable. Vous pouvez le faire en utilisant la commande git clone dans une fenêtre d'invite de commande, comme indiqué ici.

Une fois que vous avez cloné le référentiel, vous pouvez créer les outils en utilisant la commande cd pour basculer vers le dossier VCS, puis en exécutant la commande build.

Une fois les outils construits, nous pouvons les utiliser avec nos projets.

Utiliser les outils personnalisés VCS

La première chose que nous devons faire est de configurer un référentiel Git pour le projet Logix Designer.

Je peux le faire en créant un nouveau dossier à l'aide de la commande make dir, en basculant vers le nouveau dossier à l'aide de la commande cd, puis en initialisant un référentiel Git à l'aide de la commande git init.

Une fois le référentiel configuré, vous pouvez valider les modifications apportées à un projet Logix Designer à l'aide de la commande l5xgit commit.

La première fois que vous exécuterez cette commande, vous devrez spécifier l'emplacement du référentiel Git et si un message de validation est obligatoire pour chaque validation.

L'exécution de cette commande peut prendre beaucoup de temps. La bonne nouvelle est qu'il a créé une copie du projet afin que vous puissiez continuer à travailler sur votre projet pendant que les outils personnalisés VCS s'exécutent en arrière-plan.

Une fois le processus de validation terminé, vous pouvez voir votre fichier L5X éclaté dans votre référentiel Git. Si vous le souhaitez, vous pouvez transférer ces modifications vers un référentiel distant pour créer une sauvegarde hors site du projet.

Restaurer un commit

Si nécessaire, vous pouvez restaurer un projet jusqu'au dernier commit en utilisant la commande de restauration l5xgit.

Cette commande implose votre référentiel Git dans un fichier L5X, puis reconvertit ce fichier L5X en fichier ACD.

Vous devrez fermer le projet dans Studio 5000 Logix Designer pour que la commande de restauration fonctionne.

Intégration de Studio 5000 Logix Designer

Enfin, les outils personnalisés VCS peuvent être intégrés à l'interface utilisateur de Studio 5000 Logix Designer à l'aide du menu Outils personnalisés.

Pour ajouter les outils personnalisés VCS à l'interface utilisateur de Logix Designer, copiez le fichier CustomMenu.xml du dossier VCS Custom Tools vers le dossier Common de l'installation de RSLogix 5000, comme indiqué ici.

Lorsque vous redémarrez Logix Designer, vous verrez que toutes les commandes des outils personnalisés VCS sont désormais disponibles dans le menu Outils de Logix Designer.

Récapitulatif

Dans cet article, vous avez appris à utiliser les outils VCS personnalisés de Rockwell Automation pour implémenter un système de contrôle de version basé sur Git pour vos projets.

En utilisant Git, les équipes d'ingénierie peuvent obtenir un historique complet des modifications apportées à un projet, ainsi qu'une solution de sauvegarde et de restauration du logiciel API à l'aide d'outils gratuits.

Faites-nous savoir dans les commentaires quels outils vous utilisez pour le contrôle de version sur vos projets.

‍