zDevOps Extension for VS Code

Introduction

zDevOps is a Visual Studio Code extension designed to streamline the development process by integrating Git operations and GitLab API functionalities directly within the editor.

Installation

Ouvrez Visual Studio Code.
Allez dans la section Extensions (Ctrl+Shift+X).
Recherchez zDevOps.
Cliquez sur Installer.

Prerequisites

Node.js (>=12.x)
Un compte GitLab avec un token d'accès personnel pour les API
Visual Studio Code (v1.70.0 ou plus)

Manual Installation

Download the .vsix file and install it in VS Code via Extensions > Install from VSIX....

Configuration

Avant d'utiliser l'extension, configurez les paramètres suivants dans VS Code :

Ouvrez les Paramètres (Ctrl+,).
Recherchez zdevops dans la barre de recherche des paramètres.
Configurez les propriétés suivantes :
- zdevops.user.gitToken : Votre token GitLab personnel.
- zdevops.user.gitUrl : L'URL de l'API GitLab (par défaut : http://gitlab.groupe.generali.fr/gitlab/api/v4/).
- zdevops.user.workspace : Chemin local du workspace où les projets seront clonés.

Fonctionnalités de l'extension

L'extension zDevOps propose plusieurs commandes accessibles depuis la palette de commandes (Ctrl+Shift+P).

zOpen : Ouvre un projet GitLab dans votre espace de travail local.
- Utilisation : Tapez zOpen dans la palette de commandes et suivez les étapes pour sélectionner un projet et une branche.
zSave : Effectue un commit et un push des modifications locales vers GitLab.
- Utilisation : Tapez zSave, entrez un message de commit, puis l'extension sauvegarde vos modifications sur le dépôt distant.
zDeploy to V/F/M : Déploie une branche spécifique sur l'environnement sélectionné.
- Utilisation : Tapez zDeploy to V pour déployer la branche sur l'environnement V.
zStatus : Affiche le statut actuel du fichier actif par rapport à GitLab.
- Utilisation : Tapez zStatus pour obtenir l'état des modifications dans le fichier actif.

Etapes d'utilisation

Cloner un projet GitLab et commencer à travailler

Ouvrez la palette de commandes (Ctrl+Shift+P) et tapez zOpen.
Sélectionnez le client GitLab.
Choisissez le projet que vous souhaitez cloner.
Sélectionnez la branche de travail.
Le projet sera cloné dans votre workspace local. Vous pouvez maintenant ouvrir les fichiers, effectuer des modifications et les sauvegarder.

Sauvegarder et envoyer vos modifications à GitLab

Une fois vos modifications terminées, ouvrez la palette de commandes (Ctrl+Shift+P).
Tapez zSave.
Entrez un message de commit et appuyez sur Entrée.
L'extension va ajouter les fichiers, effectuer un commit, puis pousser les modifications sur GitLab.

Gestion des erreurs

Erreur : "Le chemin du workspace n'existe pas"

Solution :

Assurez-vous que le chemin de workspace défini dans les paramètres zdevops.user.workspace est valide.
Si le dossier n'existe pas, créez-le manuellement.

Erreur : "Token GitLab invalide"