Concept¶
Le générateur de lien vous permet de créer des environnements de travail personnalisables basés sur certains environnements prédéfinis. Dans les environnements que vous créerez, vous pourrez par exemple choisir les ressources pédagogiques que vous voulez télécharger dans votre environnement ou bien encore choisir différents paquets/librairies que vous voudrez placer dans un environnement de développement.
Description des champs du générateur¶
Lien d’invitation¶
L’option Créer un lien d’invitation doit être cochée si vous voulez créer un lien d’invitation à utiliser directement dans votre navigateur. Si elle est cochée vous devrez coller dans le champ Lien d’invitation vers l’environnement de base le lien d’invitation vers ledit environnement de base.
Environnement¶
Dans le champ URL vers le repo Git contenant l’environnement il faut donner le lien vers un repo dans lequel on trouve un fichier décrivant un environnement de développement. Par exemple si on veut donner une liste de paquets conda à télécharger dans notre environnement, on devra trouver dans le repo un environment.yml. Pour des paquets Pypi il faudra qu’on y trouve un requirements.txt.
Ressources¶
Dans le champ URL vers le repo Git contenant les ressources à télécharger il faut donner le lien vers un repo dans lequel se trouvent les ressources que l’on veut télécharger dans l’environnement que vous êtes en train de créer.
Fichier à ouvrir¶
Dans ce champ il faut donner le chemin vers le fichier qui sera ouvert lors du lancement de l’environnement. Le chemin vers ce fichier doit partir depuis la racine du repo spécifié dans Ressources
Application à ouvrir¶
Dans le champ Commande il faut donner la commande qui sera utilisée pour lancer l’environnement que vous êtes en train de créer. La valeur par défaut de ce champ n’a pas besoin d’être modifiée pour pouvoir utiliser votre environnement directement.
Exemple d’utilisation¶
Un exemple sera sûrement plus parlant que cette description.
Imaginons que je veuille créer un environnement de telle sorte que ses utilisateurs puissent effectuer un TD visant à leur apprendre l’usage de pandas, la librairie Python. Ce TD se trouve sous la forme d’un jupyter notebook.
J’ai à ma disposition un environnement de base ne contenant que Python.
Pour créer cet environnement je vais donc suivre ces étapes :
Copier le lien d’invitation vers l’environnement de base.
Cocher la case Créer un lien d’invitation du générateur de lien et coller le lien en question dans le champ prévu à cet effet.
Dans la section Environnement, saisir le lien du repo contenant la description de l’environnement de développement que vous voulez ajouter à votre environnement. Ici puisque vous voulez rendre pandas disponible aux utilisateurs, le repo devrait contenir une description d’environnement où pandas figure.
Dans la section Ressources, saisir le lien du repo contenant les ressources pédagogiques que vous souhaitez rendre disponibles dans votre environnement.
Si vous en avez un, spécifiez le fichier qui sera ouvert lors de l’accès à l’environnement dans le champ Fichier à ouvrir.
Sélectionner l’application que je voudrais ouvrir dans mon environnement. Ici je vais donc sélectionner Jupyter Lab
Les champs qui apparaissent sont remplis par défaut avec des valeurs suffisantes pour lancer l’environnement directement.
Appuyer sur Submit.
Copier et coller le lien dans votre navigateur.
Utiliser l’environnement que vous venez de créer.