Contrôle de version - La manière paresseuse

La vie d'un programmeur est assez dure telle quelle. Pourquoi ne pas vous simplifier la vie et confier le contrôle de version de vos projets à des services dédiés ? La plupart des programmeurs du monde informatique connaissent Git, mais pour certains programmeurs OT de cette communauté, il s'agit d'un tout nouveau concept. Lorsque travailler avec différents collègues sur le même projet, partager du code devient encore plus compliqué, un service comme GitHub facilite le partage et la collaboration sur le même code. Ce blog vous guide à travers vos premiers pas dans l'utilisation de Git et GitHub pour garder votre code et vos projets en ordre.

---

Dans ce blog, j'utiliserai GitHub et le client GitHub pour Windows, mais veuillez noter qu'il existe d'autres options, notamment GitLab. J'aime tout simplement la facilité d'utilisation du client GitHub !

---

Configuration d'un référentiel sur GitHub

Étape 1 :Téléchargez et installez le client GitHub pour Windows

En fait, la première étape serait de créer un compte GitHub, mais cela sort un peu du cadre de ce blog.

1. Le client peut être téléchargé à partir d'ici.
2. Suivre le guide d'installation
3. Connectez-vous à votre compte GitHub

 Étape 2 :Créez un dossier ou un référentiel pour votre projet

Un dépôt est un endroit où votre projet vit. Créez un dossier pour chaque projet ! Chaque fois que quelque chose change dans ce dossier, le client GitHub le détectera et vous pourrez enregistrer ou envoyer vos modifications au référentiel en ligne sur GitHub.

1. Cliquez sur « Créer un nouveau référentiel sur votre disque dur… »
2. Donnez un nom et une description à votre nouveau référentiel.
3. Vous pouvez modifier le chemin du référentiel si vous le souhaitez, ou le laisser tel quel (la manière paresseuse)
4. Cliquez sur Initialiser ce référentiel avec un fichier README (paresseux ne signifie pas suivre les meilleures pratiques et documenter votre code !)
5. Créer le référentiel

Étape 3 - Créer un projet PLCnext

Git fonctionne très bien avec les fichiers texte. Heureusement, dans PLCnext Engineer, il existe une option pour enregistrer votre projet sous la forme d'un grand nombre de fichiers texte, parfait pour Git et donc pour notre client GitHub !

1. Ouvrez PLCnext Engineer et commencez à créer un projet comme vous en aviez l'habitude.
2. Lorsque vous êtes prêt à enregistrer votre projet, choisissez Enregistrer le projet sous (F12)
3. Naviguez jusqu'à votre référentiel GitHub (par défaut :This PC/documents/GitHub )
4. Enregistrez votre projet en tant que "Projet non compressé"

 Étape 4 :Validez vos modifications

Pour "enregistrer" les modifications dans votre référentiel, vous devez les valider dans une branche. Qu'est-ce qu'une branche exactement, je l'expliquerai plus tard, pour l'instant, vous devez juste vous rappeler que vous devez valider vos modifications dans une branche afin de les enregistrer.

Donnez à votre commit un nouveau et une courte description afin que vous puissiez vous souvenir exactement de ce qui a changé !

Étape 5 – Publier ou envoyer votre dépôt

La dernière étape pour créer un référentiel en ligne consiste à pousser notre référentiel local vers GitHub. C'est aussi simple que d'appuyer sur un bouton ou d'appuyer sur (ctrl + p). Choisissez si votre code doit être privé et s'il vous appartient ou appartient à une organisation.

Étape 6 :Documentez !

appuyez sur ( Ctrl + Maj + G) pour afficher le référentiel en ligne sur GitHub dans votre navigateur. Voila ! Il y a votre projet PLCnext sur GitHub. Vous souvenez-vous du "Initialize README" ? C'est le texte que vous voyez maintenant devant vous. Dans le README.md, vous devez expliquer la structure du projet, le but et peut-être quelques informations de contact pour référence future.

Pour l'instant, apportez quelques modifications au fichier README.md en cliquant sur le crayon. Le fichier est "écrit" dans MarkDown plus d'informations sur MarkDown peuvent être trouvées ici.

Si vous avez apporté des modifications, validez à nouveau la branche master !

Étape 7 – Importer les modifications dans votre dépôt local

Le client Windows détectera que certaines modifications ont été apportées au référentiel sur GitHub. N'oubliez pas d'extraire les modifications pour recommencer à travailler sur la dernière version !

---

Conseils et astuces

Suivi des problèmes

GitHub dispose d'un outil de suivi des problèmes formidable, utilisez-le pour suivre les problèmes connus de votre logiciel et discuter des solutions avec les autres parties prenantes

Projets

Utilisez le Project Bord intégré pour suivre votre tâche avec un bord kanban. Si vous en avez envie, vous pouvez automatiser votre kanban avec des déclencheurs intégrés pour vous simplifier la vie.

Succursales

Ah, nous y sommes. Vous voyez, j'ai dit que j'allais vous expliquer ce que sont les branches ! Eh bien, je vais laisser GitHub vous expliquer ce que sont les branches…

Vous allez faire beaucoup de changements ou implémenter une nouvelle fonctionnalité ? Créez une branche pour garder vos modifications isolées et fusionnez votre "branche de fonctionnalité" dans votre branche principale avec une demande d'extraction.

Libérer

Prêt à déployer un projet ? Créez une release à ajouter à votre AS Build !