{"id":327899,"date":"2023-03-01T11:34:50","date_gmt":"2023-03-01T10:34:50","guid":{"rendered":"https:\/\/blog.jetbrains.com\/?post_type=datalore&p=327899"},"modified":"2024-10-15T19:57:45","modified_gmt":"2024-10-15T18:57:45","slug":"comment-travailler-avec-git-dans-datalore","status":"publish","type":"datalore","link":"https:\/\/blog.jetbrains.com\/fr\/datalore\/2023\/03\/01\/comment-travailler-avec-git-dans-datalore\/","title":{"rendered":"Comment travailler avec Git dans Datalore"},"content":{"rendered":"

Git est un outil tr\u00e8s utilis\u00e9 par les \u00e9quipes travaillant dans le domaine de la science des donn\u00e9es. Ce tutoriel explique comment travailler avec Git dans Datalore, notre plateforme collaborative pour la science des donn\u00e9es.\u00a0<\/p>\n

Poursuivez votre lecture pour d\u00e9couvrir comment installer des r\u00e9f\u00e9rentiels Git, modifier leur contenu et g\u00e9rer les versions avec Datalore.\u00a0<\/p>\n

Comment installer un r\u00e9f\u00e9rentiel Git dans votre environnement de notebooks Datalore<\/h2>\n

Si vous ou votre \u00e9quipe d\u00e9veloppez une collection de scripts Python ou un package compatible avec pip stock\u00e9 dans Git, vous pouvez facilement acc\u00e9der \u00e0 ce r\u00e9f\u00e9rentiel depuis les notebooks Jupyter dans Datalore.\u00a0<\/p>\n

Il y a trois fa\u00e7ons de proc\u00e9der. Nous recommandons de choisir la m\u00e9thode en fonction du niveau d’acc\u00e8s et du type de votre r\u00e9f\u00e9rentiel.<\/p>\n

<\/p>\n

\n\n\n\n\n\n\n\n\n
\u00a0<\/td>\nUtilisation de <\/strong>Environment | Repositories<\/em><\/strong><\/td>\nUtilisation de <\/strong>Tools | Terminal <\/em><\/strong>ou de commandes magiques IPython<\/strong><\/td>\nUtilisation de l’environnement de base d’\u00e9quipe<\/strong> (fonctionnalit\u00e9 disponible avec le forfait Enterprise uniquement)<\/strong><\/td>\n<\/tr>\n
Niveau d’acc\u00e8s du r\u00e9f\u00e9rentiel<\/td>\n\u00c0 partir d’un notebook donn\u00e9<\/td>\n\u00c0 partir d’un notebook donn\u00e9 ou de chaque notebook dans un espace de travail choisi<\/td>\nTout notebook de tout collaborateur dans tout espace de travail<\/td>\n<\/tr>\n
Type de r\u00e9f\u00e9rentiel<\/td>\nR\u00e9f\u00e9rentiels Git publics et r\u00e9f\u00e9rentiels Git priv\u00e9s via SSH<\/td>\nTout r\u00e9f\u00e9rentiel, public ou priv\u00e9, Git ou non (Artifactory, Space Packages, r\u00e9f\u00e9rentiels PyPI h\u00e9berg\u00e9s de fa\u00e7on priv\u00e9e)<\/td>\nTout r\u00e9f\u00e9rentiel, public ou priv\u00e9, Git ou non (Artifactory, Space Packages, r\u00e9f\u00e9rentiels PyPI h\u00e9berg\u00e9s de fa\u00e7on priv\u00e9e)<\/td>\n<\/tr>\n
Sp\u00e9cificit\u00e9s de l’installation<\/td>\nInstallation \u00e0 la demande, pouvant \u00eatre actualis\u00e9e \u00e0 tout moment depuis l’interface utilisateur<\/td>\nLors de l’installation \u00e0 la demande avec la ligne de commande de Git, certaines options peuvent \u00eatre automatis\u00e9es avec init.sh et install\u00e9es au d\u00e9marrage du calcul du notebook<\/td>\nInstallation dans le cadre de l’image personnalis\u00e9e de Docker\u00a0<\/td>\n<\/tr>\n
Type d’actualisation<\/td>\nBouton d’actualisation et red\u00e9marrage du noyau<\/td>\nUtilisation de la ligne de commande Git via Terminal<\/td>\nReconstruire l’image Docker<\/td>\n<\/tr>\n
Actions disponibles<\/td>\nClone, pull<\/td>\nClone, pull, push<\/td>\nCloner lors de la cr\u00e9ation de l’image<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n

Le principal int\u00e9r\u00eat du clonage de r\u00e9f\u00e9rentiels Git ave Datalore est de pouvoir acc\u00e9der \u00e0 des modules, scripts ou fonctions Python personnalis\u00e9s et de les modifier de fa\u00e7on collaborative dans Datalore. Cependant, les notebooks Jupyter clon\u00e9s dans le cadre du r\u00e9f\u00e9rentiel Git actuel ne peuvent pas \u00eatre modifi\u00e9s.\u00a0<\/p>\n

Utilisation de Environment | Repositories<\/em><\/h3>\n

Le moyen le plus simple d’installer un r\u00e9f\u00e9rentiel Git public d’une interface utilisateur dans un seul notebook Datalore est d’utiliser Environment | Repositories<\/em>. Vous pouvez choisir la branche du r\u00e9f\u00e9rentiel et actualiser la connexion depuis l’interface utilisateur.\u00a0<\/p>\n

Pour acc\u00e9der \u00e0 un r\u00e9f\u00e9rentiel Git priv\u00e9, il vous suffit de fournir les cl\u00e9s SSH dans Environment | Repositories | Keys<\/em>.\u00a0<\/p>\n

Pour acc\u00e9der \u00e0 un r\u00e9f\u00e9rentiel Git priv\u00e9 avec un jeton personnel ou au moyen d’un nom d’utilisateur et mot de passe, utilisez un script init.sh ou Terminal<\/em>.\u00a0<\/p>\n

\"\"<\/p>\n
Installation d’un r\u00e9f\u00e9rentiel Git public dans Datalore<\/em><\/figcaption><\/figure>\n

Utilisation de Terminal et de scripts init.sh<\/p>\n

Si vous voulez cloner un r\u00e9f\u00e9rentiel Git depuis Terminal, ouvrez un notebook, allez dans Tools | Terminal<\/em>, et utilisez la ligne de commandes Git pour cloner. Si vous souhaitez utiliser un r\u00e9f\u00e9rentiel dans un seul notebook, clonez-le en utilisant Notebook files<\/em>. Si vous voulez utiliser un r\u00e9f\u00e9rentiel dans tous les notebooks de l’espace de travail, clonez-le dans Workspace files<\/em>.\u00a0<\/p>\n

Pour acc\u00e9der aux contenus du r\u00e9f\u00e9rentiel depuis le notebook, importez les fonctions n\u00e9cessaires. Datalore fournit la saisie semi-automatique du code et des fen\u00eatres contextuelles de documentation pour les modules Python import\u00e9s.\u00a0<\/p>\n

Pour automatiser l’ex\u00e9cution d’un ensemble de commandes de Terminal \u00e0 chaque d\u00e9marrage du notebook, vous pouvez utiliser le script shell init.sh.\u00a0<\/p>\n

Vous pouvez notamment configurer l’acc\u00e8s \u00e0 vos r\u00e9f\u00e9rentiels priv\u00e9s, configurer l’utilisation de vos jetons personnels, installer des d\u00e9pendances autres que Python et monter des r\u00e9pertoires de fichiers. Vous pouvez faire cela automatiquement avant que le gestionnaire d’environnement pip ou conda n’ex\u00e9cute les param\u00e8tres de l’environnement de base.\u00a0<\/p>\n

\"\"<\/p>\n
Utilisation de la ligne de commande Git pour cloner un r\u00e9f\u00e9rentiel dans Datalore<\/em><\/figcaption>\n<\/figure>\n

Si vous devez sp\u00e9cifier un nom d’utilisateur ou un mot de passe pour acc\u00e9der aux fichiers dans un r\u00e9f\u00e9rentiel ou faire un push des fichiers, ajoutez les configurations suivantes dans votre script init.sh :\u00a0<\/p>\n

git config --global user.email \"email@example.com\"\ngit config --global user.name \"your name\"<\/pre>\n
\"\"<\/p>\n
Automatisation de l’ex\u00e9cution d’un ensemble de commandes de Terminal avec un script init.sh<\/em><\/figcaption>\n<\/figure>\n
Pour rendre le script init.sh disponible pour l’ensemble des notebooks de l’espace de travail, assurez-vous que les fichiers de l’espace de travail sont joints et d\u00e9placez le fichier init.sh de Notebook files<\/em> vers Workspace files<\/em>.<\/p>\n
Utilisation de l’environnement de base d’une \u00e9quipe<\/h3>\n
Si vous voulez fournir un acc\u00e8s centralis\u00e9 \u00e0 un r\u00e9pertoire donn\u00e9 \u00e0 votre \u00e9quipe, vous pouvez faire de ce r\u00e9f\u00e9rentiel un \u00e9l\u00e9ment de l’environnement de base personnalis\u00e9.\u00a0<\/p>\n
Les environnements de base sont des images Docker personnalis\u00e9es qui peuvent \u00eatre facilement utilis\u00e9es comme configurations pr\u00e9d\u00e9finies lors de la cr\u00e9ation d’un notebook dans Datalore.<\/p>\n
\"\"<\/p>\n
Fournir un acc\u00e8s centralis\u00e9 \u00e0 un r\u00e9f\u00e9rentiel Git via un environnement de base personnalis\u00e9<\/em><\/figcaption>\n<\/figure>\n
Les environnements de base personnalis\u00e9s ne sont disponibles que pour les utilisateurs de la version Enterprise<\/a>. Pour configurer un environnement de base personnalis\u00e9 pour Datalore Enterprise, utilisez ce guide<\/a>.\u00a0<\/p>\n
Comment modifier le contenu du r\u00e9f\u00e9rentiel Git dans Datalore<\/h2>\n
Si vous voulez modifier des scripts ou des fichiers Python disponibles dans votre r\u00e9f\u00e9rentiel Git, vous pouvez cloner le r\u00e9f\u00e9rentiel dans Attached data<\/em> en utilisant\u00a0:<\/p>\n