Versionnement de code avec tortoise et sourcesup
Sommaire
GIT et sourcesup, qu’est-ce que c’est ?
GIT est un système de contrôle de version du code qui permet de partager des scripts ainsi que les modifications apportées dessus.
Tortoise est une interface sous windows permettant d'utiliser Git.
Sourcesup est une plateforme web d’hébergement de projets informatiques développée par Renater permettant de stocker le code source est la plateforme de l'Enseignement Supérieur et de la Recherche.
Mise en place de GIT et de dossiers de partages
Installation de Git, tortoise et identification sur sourcesup
Les étapes sont les suivantes :
1. Se rendre sur la page suivante : https://github.com/git-for-windows/git/releases/tag/v2.11.1.windows.1
2. En bas de la page, attention choisir 32 bits ou 64 bits suivant votre version de windows
3. Puis choisir TortoiseGIT (https://tortoisegit.org/download/, prendre la dernière version soit la 2.4.02).
4. Lors de l'installation, choisir les paramètres par défaut.
5. Une fois arrivés à la fenêtre "Authentification and credential store", dans la partie SSH cliquer sur "Generate PuTTY key pair"
6. Fenêtre suivante, cliquez sur Generate et bougez la souris dans la partie vide pour générer de l'aléatoire (comme indiqué en anglais). Une fois la clé générée, sauvegardez la clé publique et la clé privée (classiquement dans le dossier C:\Users\nom\.ssh). Définir un mot de passe ("passphrase") qui vous sera utile lors de la première connexion. Copiez les lignes sous "Public key for pasting into OpenSSH autorized_keys file".
7. La clé SSH créée via Tortoise sert d’identifiant pour le poste local utilisé. Elle doit donc être connue par sourcesup. Voici la procédure pour transmettre la clé SSH à sourcesup : sur https://sourcesup.renater.fr/ -> Cliquer sur « Mon compte » -> cliquer sur « Éditer les clefs » -> cliquer sur « parcourir » -> Collez les lignes copiées au point 6. Attention, il y a un temps d'acceptation de quelques dizaines de minutes de la clé publique par sourcesup
8. Pour recréer une clé SSH, faites clic droit dans n'importe quel dossier de l'explorateur windows -> TortoiseGit -> Settings -> "Re-run First Start Wizard"
Création d'un dossier versionné
à partir d'un dépôt existant sur sourcesup
Cliquer sur « Mon compte » SUR https://sourcesup.renater.fr/ -> Cliquer sur « Ma page personnelle » -> cliquer sur le nom du projet -> cliquer sur « Dépôt de sources » -> copier l’URL de la partie du projet à incorporer dans Rstudio (à partir de « git+ssh »).
puis là où on souhaite importer les requêtes dans l'explorateur windows : Faire un clic droit -> git clone --> coller l'URL commençant par git+ssh -> rentrer le mot de passe "passphrase" définie à l'étape 6.
à partir d'un dépôt non existant sur sourcesup
Pour créer un nouveau dépôt associé à un projet existant sur sourcesup (p.ex. ici projet efese_script) :
Cliquer sur « Mon compte » de la page https://sourcesup.renater.fr/ -> Cliquer sur « Ma page personnelle » -> cliquer sur le nom du projet -> Cliquer sur « Dépôt de sources » -> Cliquer sur l'onglet « Administration » en haut à droite » -> remplir les informations du nouveau dépôt sous « Create new Git repository for project efese_script »
répétez les étapes de la partie "à partir d'un dépôt existant sur sourcesup"
Partage des scripts
Les étapes pour utiliser le dossier partagé créé sont :
1. Avant de toucher au contenu du dossier partagé , faire clic droit sur « agrosyst-doc » et Tortoise Git > Pull > OK > Close. Cette étape permet de récupérer le code modifié par les autres utilisateurs
2. Il est maintenant possible de modifier une requête dans le dossier partagé. Enregistrer un script à partager sur le dossier .
3. Il faut maintenant partager ces modifications faites sur votre ordinateur, c’est-à-dire les mettre sur le serveur. Pour cela :
a. faire clic droit surle dossier partagé et cliquer sur « Git commit > develop » b. une fenêtre s’ouvre, inscrire un message d’explication de la modification c. cocher le ou les scripts à partager d. cliquer sur commit e. cliquer sur push f. OK
4. Les modifications sont visibles par tout le monde.
