forked from DSIT/documentation-dsit
Actualiser docs/Services/pole-scientifique/docs/index.md
- Fixe intégration vidéo youtube - Fixe hypertexte vers URL qui ne fonctionnait pas correctement sur git, l'intégration était "[Texte du lien](http://www.exemple.com) " ce qui a corrigé le problème: "<a href="http://www.exemple.com" target="_blank">Texte du lien</a>"
This commit is contained in:
parent
7bc07495b3
commit
7a8bb0ff03
|
@ -15,15 +15,13 @@ L’utilisation de Git permet de synchroniser le projet local avec un serveur di
|
|||
En ce qui concerne la solution de stockage de fichiers S3, celle-ci est un système de stockage d'objets basé sur le cloud, compatible avec l'API S3 d'Amazon :
|
||||
|
||||
- Les fichiers stockés sont facilement accessibles depuis n'importe quel endroit via une simple URL, pouvant être facilement partagée.
|
||||
- De plus, l'accès aux fichiers stockés est possible directement dans les services de data science (R, Python, etc.) proposés sur le [Datalab](https://onyxia.lab.groupe-genes.fr/){:target="_blank"}, sans nécessiter de copie préalable des fichiers localement, améliorant ainsi considérablement la reproductibilité des analyses.
|
||||
- De plus, l'accès aux fichiers stockés est possible directement dans les services de data science (R, Python, etc.) proposés sur le <a href="https://onyxia.lab.groupe-genes.fr/" target="_blank">Datalab</a>, sans nécessiter de copie préalable des fichiers localement, améliorant ainsi considérablement la reproductibilité des analyses.
|
||||
L'avantage d'Onyxia réside dans la possibilité de partager chaque service avec d'autres collaborateurs en un clic.
|
||||
|
||||
test: <a href="https://onyxia.lab.groupe-genes.fr/" target="_blank">Datalab</a>
|
||||
|
||||
## Les fonctionnalités du Datalab Onyxia GENES en bref :
|
||||
- Accès à un [catalogue de services](https://onyxia.lab.groupe-genes.fr/catalog/ide){:target="_blank"} déployable en libre-service
|
||||
- Accès à un <a href="https://onyxia.lab.groupe-genes.fr/catalog/ide" target="_blank">Catalogue de services</a> déployable en libre-service
|
||||
|
||||
- Les utilisateurs peuvent définir le nombre de [RAM, CPU et GPU](https://code.groupe-genes.fr/aguyot-ensae/image-public/raw/branch/main/images-onyxia/onyxia-resources.png){:target="_blank"} qu’ils souhaitent allouer à leurs services avec une limitation par utilisateur de : 5 services, 20 CPU, 50Go RAM, et 1 GPU.
|
||||
- Les utilisateurs peuvent définir le nombre de <a href="https://code.groupe-genes.fr/aguyot-ensae/image-public/raw/branch/main/images-onyxia/onyxia-resources.png/" target="_blank">RAM, CPU et GPU</a> qu’ils souhaitent allouer à leurs services avec une limitation par utilisateur de : 5 services, 20 CPU, 50Go RAM, et 1 GPU.
|
||||
|
||||
- Possibilité de faire des demandes auprès du DSIT du GENES pour ajouter de nouveaux services au catalogue selon vos besoins <span style="color:red"> (à rajouter la méthode de formulation) </span>
|
||||
|
||||
|
@ -33,16 +31,16 @@ test: <a href="https://onyxia.lab.groupe-genes.fr/" target="_blank">Datalab</a>
|
|||
|
||||
- Enregistrer, restaurer et partager la configuration de vos services avec vos collaborateur <span style="color:red"> (à rajouter lien vers guide) </span>
|
||||
|
||||
- [Intégration de secrets](https://onyxia.lab.groupe-genes.fr/my-secrets/){:target="_blank"} sous forme de variables d'environnement dans les services du [Datalab](https://onyxia.lab.groupe-genes.fr/){:target="_blank"}, permettant de stocker les informations sensibles de type clés d'API dans Vault et de les rendre accessibles dans les services sous forme de variable. (à rajouter lien vers guide)
|
||||
- <a href="https://onyxia.lab.groupe-genes.fr/my-secrets/" target="_blank">Intégration de secrets</a> sous forme de variables d'environnement dans les services du <a href="https://onyxia.lab.groupe-genes.fr/" target="_blank">Datalab</a>, permettant de stocker les informations sensibles de type clés d'API dans Vault et de les rendre accessibles dans les services sous forme de variable. (à rajouter lien vers guide)
|
||||
|
||||
- <span style="color:red"> (à rajouter lien vers guide) (A ETE VU, CE SERA BIEN MIS EN PLACE) Possibilités d’accéder et de créé des formations techniques sur différents outils mis à disposition pour vos collaborateurs ou élèves (comme sur : <https://www.sspcloud.fr/formation>), en terme de présentation cela pourrait être pas mal démontrant avec un exemple détaillés du genre: Un professeur créé un tutoriel, ajoute une URL de configuration, sur lequel les élèves cliques pour déployer un service dans leurs propre namespace, démontrant ainsi la facilité de déployer un environnement de travail stable. </span>
|
||||
|
||||
## Présentation rapide d’Onyxia en vidéo :
|
||||
<iframe src=" https://www.youtube.com/watch?v=vpkgfgGxdMc" allowfullscreen></iframe>
|
||||
<https://www.youtube.com/watch?v=vpkgfgGxdMc>
|
||||
<iframe width="560" height="315" src="https://www.youtube.com/embed/vpkgfgGxdMc?si=6Upj2mJ-9tCOLkDr" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
|
||||
|
||||
|
||||
## FAQ
|
||||
J’ai besoin d’un service spécifique qui n’est pas disponible sur le [Datalab Onyxia GENES](https://onyxia.lab.groupe-genes.fr/){:target="_blank"}, où puis-je faire une demande pour que celui-ci soit ajouté au catalogue de services ?
|
||||
J’ai besoin d’un service spécifique qui n’est pas disponible sur le <a href="https://onyxia.lab.groupe-genes.fr/" target="_blank">Datalab Onyxia du Genes</a>, où puis-je faire une demande pour que celui-ci soit ajouté au catalogue de services ?
|
||||
|
||||
# Une plateforme de mutualisation
|
||||
Le projet Onyxia part du constat de difficultés communes rencontrées par les datascientists du secteur public :
|
||||
|
@ -58,7 +56,7 @@ Face à ce constat, le Datalab Onyxia GENES a été construit pour proposer une
|
|||
- partage de connaissances, via des formations associées au Datalab ainsi que la constitution de commaunautés d'entraide centrées sur son utilisation.
|
||||
|
||||
# Onyxia, Datalab Onyxia GENES : quelles différences ?
|
||||
[Onyxia](https://github.com/InseeFrLab/onyxia.git){:target="_blank"} est un projet open-source qui propose une plateforme de services de data science, accessible via une application Web. Le [Datalab Onyxia GENES](https://onyxia.lab.groupe-genes.fr/){:target="_blank"} est une instance du projet Onyxia, hébergée au GENES.
|
||||
<a href="Onyxia" target="_blank">https://github.com/InseeFrLab/onyxia.git</a> est un projet open-source qui propose une plateforme de services de data science, accessible via une application Web. Le <a href="https://onyxia.lab.groupe-genes.fr/" target="_blank">Datalab</a> est une instance du projet Onyxia, hébergée au GENES.
|
||||
|
||||
# Principes fondamentaux
|
||||
|
||||
|
@ -70,7 +68,7 @@ L'architecture du Datalab est basée sur un ensemble de principes fondamentaux :
|
|||
- un projet complètement open-source, à la fois du point de vue de ses briques constitutives que de sa diffusion (licence MIT).
|
||||
|
||||
# Offre de services
|
||||
Le Datalab est accessible via une [interface utilisateur](https://onyxia.lab.groupe-genes.fr/){:target="_blank"} moderne et réactive, centrée sur l'expérience utilisateur. Celle-ci constitue le liant technique entre les différentes composantes d'Onyxia :
|
||||
Le Datalab est accessible via une <a href="https://onyxia.lab.groupe-genes.fr/" target="_blank">Interface utilisateur</a> moderne et réactive, centrée sur l'expérience utilisateur. Celle-ci constitue le liant technique entre les différentes composantes d'Onyxia :
|
||||
|
||||
- des technologies open-source qui constituent l'état de l'art du déploiement et de l'orchestration de conteneurs, du stockage et de la sécurité ;
|
||||
- un catalogue de services et d'outils pour accompagner les projets de data science ;
|
||||
|
@ -95,7 +93,7 @@ Un catalogue de services complet pour les projets de data science
|
|||
# Un projet ouvert
|
||||
Le projet du Datalab Onyxia est résolument ouvert, à de multiples niveaux :
|
||||
|
||||
- le Datalab est accessible via son [interface Web](https://onyxia.lab.groupe-genes.fr/){:target="_blank"} à tous les agents du service public ainsi qu'aux élèves des écoles de statistique liées à l'Ensae (Cepe, Ensai, Ensae) ;
|
||||
- le Datalab est accessible via son <a href="https://onyxia.lab.groupe-genes.fr/" target="_blank">interface Web</a> à tous les agents du service public ainsi qu'aux élèves des écoles de statistique liées à l'Ensae (Cepe, Ensai, Ensae) ;
|
||||
- le code source ouvert et la modularité du projet rendent possible le déploiement d'une instance Onyxia personnalisée sur n'importe quelle infrastructure basée sur un cluster Kubernetes ;
|
||||
- le projet est ouvert aux contributions extérieures, qu'elles concernent le catalogue des services, l'interface graphique ou l'agencement des briques logicielles qui le constituent.
|
||||
|
||||
|
@ -109,7 +107,7 @@ Il s’agit d’une présentation sommaire, chaque page web d’onyxia, vous tro
|
|||
Les conditions d'utilisation du Datalab sont consultables à cette <span style="color:red">adresse (A DEFINIR)</span>. Nous rappelons que le Datalab est destiné exclusivement au traitement de données publiques et non-sensibles. Des projets d'expérimentation mobilisant des données non ouvertes peuvent être menés en concertation avec l'équipe du Datalab, sous réserve de se conformer aux règles de sécurité spécifiques au projet.
|
||||
|
||||
# Le catalogue de services
|
||||
Le [catalogue de services](https://onyxia.lab.groupe-genes.fr/catalog/ide){:target="_blank"} est au centre de l'utilisation du Datalab. Il propose un ensemble de services destinés aux traitements statistiques de données ainsi qu'à la gestion complète des projets de data science.
|
||||
Le <a href="https://onyxia.lab.groupe-genes.fr/" target="_blank">interface Web</a> est au centre de l'utilisation du Datalab. Il propose un ensemble de services destinés aux traitements statistiques de données ainsi qu'à la gestion complète des projets de data science.
|
||||
|
||||

|
||||
|
||||
|
@ -125,12 +123,12 @@ Une page centrée sur le service demandé s'ouvre alors, qui offre plusieurs pos
|
|||
|
||||
- dérouler un menu de configuration afin de personnaliser la configuration du service avant de le lancer ;
|
||||
|
||||
- sauvegarder une configuration personnalisée en cliquant sur le signet en haut à droite du service, ce qui vous permettra d’enregistrer l'entièreté de la configuration du service et de le relancer depuis l’onglet [Mes services](https://onyxia.lab.groupe-genes.fr/my-services){:target="_blank"}.
|
||||
- sauvegarder une configuration personnalisée en cliquant sur le signet en haut à droite du service, ce qui vous permettra d’enregistrer l'entièreté de la configuration du service et de le relancer depuis l’onglet <a href="https://onyxia.lab.groupe-genes.fr/my-services" target="_blank">Mes services</a>.
|
||||
|
||||
La configuration précise de S3, Kubernetes, Init etc... sur les services constitue un usage avancé, chaque onglet du site web seront expliqués en détails plus loin <span style="color:red">(LIENS VERS DOCUMENTATION)</span>.
|
||||
|
||||
# Utiliser un service
|
||||
L'action de lancer un service amène automatiquement sur la page [Mes Services](https://onyxia.lab.groupe-genes.fr/my-services){:target="_blank"}, où sont listées toutes les instances en activité sur le compte de l'utilisateur.
|
||||
L'action de lancer un service amène automatiquement sur la page <a href="https://onyxia.lab.groupe-genes.fr/my-services" target="_blank">Mes services</a>, où sont listées toutes les instances en activité sur le compte de l'utilisateur.
|
||||
|
||||

|
||||
|
||||
|
@ -139,7 +137,7 @@ Une fois le service lancé, un bouton Ouvrir apparaît qui permet l'accès au se
|
|||
# Supprimer une instance
|
||||
Supprimer une instance d'un service s'effectue simplement en cliquant sur l'icône en forme de poubelle en dessous de l'instance.
|
||||
|
||||
Pour certains services, la suppression d'une instance entraîne la suppression de toutes les données associées, et cette action est irrémédiable. Il est donc nécessaire de toujours bien lire le README associé à l'instance, qui précise les conséquences d'une suppression de l'instance. De manière générale, il est très important de s'assurer que les données ainsi que le code utilisés sont sauvegardés avant de supprimer l'instance. L'idéal est de [versionner son code](https://docs.sspcloud.fr/onyxia-guide/controle-de-version) avec Git et de procéder à des sauvegardes régulières des données à l'aide du [système de stockage S3](https://docs.sspcloud.fr/onyxia-guide/stockage-de-donnees){:target="_blank"}.
|
||||
Pour certains services, la suppression d'une instance entraîne la suppression de toutes les données associées, et cette action est irrémédiable. Il est donc nécessaire de toujours bien lire le README associé à l'instance, qui précise les conséquences d'une suppression de l'instance. De manière générale, il est très important de s'assurer que les données ainsi que le code utilisés sont sauvegardés avant de supprimer l'instance. L'idéal est de <a href="https://docs.sspcloud.fr/onyxia-guide/controle-de-version" target="_blank">versionner son code</a> avec Git et de procéder à des sauvegardes régulières des données à l'aide du <a href="https://docs.sspcloud.fr/onyxia-guide/stockage-de-donnees" target="_blank">système de stockage S3</a>.
|
||||
|
||||
Les ressources mises à disposition pour l'execution des services sont partagées entre les différents utilisateurs du Datalab. Veuillez à ne pas laisser en cours des services dont vous ne faites plus l'usage. Nous procédons parfois à une suppression systématique des instances inactives depuis un certain temps, afin de libérer des ressources.
|
||||
|
||||
|
@ -156,12 +154,12 @@ Ainsi que le mot de passe du service, qui est configurable et récupérable de d
|
|||
|
||||

|
||||
|
||||
**Cependant attention**, car par défaut lors de la configuration d’un service, le mot de passe sera toujours le mêmes et qui a été spécifié dans l’onglet Mon compte puis [Information du compte](https://onyxia.lab.groupe-genes.fr/account/infos){:target="_blank"}:
|
||||
**Cependant attention**, car par défaut lors de la configuration d’un service, le mot de passe sera toujours le mêmes et qui a été spécifié dans l’onglet Mon compte puis <a href="https://onyxia.lab.groupe-genes.fr/account/infos" target="_blank">Information du compte</a>:
|
||||
|
||||
|
||||

|
||||
|
||||
Si vous ne vous rappelez plus du mot de passe que vous avez attribué lors de la configuration d’un service, celui-ci est affiché automatiquement à chaque fois que vous re-lancer votre service via l’onglet [Mes services](https://onyxia.lab.groupe-genes.fr/my-services){:target="_blank"}:
|
||||
Si vous ne vous rappelez plus du mot de passe que vous avez attribué lors de la configuration d’un service, celui-ci est affiché automatiquement à chaque fois que vous re-lancer votre service via l’onglet <a href="https://onyxia.lab.groupe-genes.fr/my-services" target="_blank">Mes services</a>:
|
||||
|
||||

|
||||
|
||||
|
@ -174,25 +172,25 @@ Le nom d'utilisateur reste **Onyxia**. Par ailleurs il ne faut pas cocher Enable
|
|||
Dans cet onglet vous pourrez modifier différents paramètres, les plus important étant :
|
||||
|
||||
- Modification des comptes et jetons Gitlab, Github et Kaggle qui seront par lié par défaut a tous les services que vous créérez, disponible dans le sous onglet [Services externes](https://onyxia.lab.groupe-genes.fr/account/third-party-integration){:target="_blank"} ;
|
||||
- La capacité de récupérer des scripts d’initialisation dans le language de programmation de votre choix, qui vous permettrons d’accéder au stockage S3 en dehors des services du datalab Onyxia GENES. Disponible dans le sous onglet [Connexion au stockage](https://onyxia.lab.groupe-genes.fr/account/storage){:target="_blank"} (attention, les token fournit dans ces scripts d’initialisation expirent rapidement) ;
|
||||
- Récupérer les identifiants Vault afin de pouvoir l’utiliser dans votre terminal, disponible dans le sous onglet [Vault](https://onyxia.lab.groupe-genes.fr/account/vault){:target="_blank"} ;
|
||||
- La capacité de récupérer des scripts d’initialisation dans le language de programmation de votre choix, qui vous permettrons d’accéder au stockage S3 en dehors des services du datalab Onyxia GENES. Disponible dans le sous onglet <a href="https://onyxia.lab.groupe-genes.fr/account/storage" target="_blank">Connexion au stockage</a> (attention, les token fournit dans ces scripts d’initialisation expirent rapidement) ;
|
||||
- Récupérer les identifiants Vault afin de pouvoir l’utiliser dans votre terminal, disponible dans le sous onglet <a href="Vault" target="_blank">https://onyxia.lab.groupe-genes.fr/account/vault</a> ;
|
||||
|
||||
# Information du compte
|
||||
Dans le sous onglet [Information du compte](https://onyxia.lab.groupe-genes.fr/account/infos){:target="_blank"} vous retrouverez les informations générales de votre compte Datalab Onyxia GENES et la capacité de modifier le mot de passe pour accéder aux différents services déployer dans votre espace :
|
||||
Dans le sous onglet <a href="https://onyxia.lab.groupe-genes.fr/account/infos" target="_blank">Information du compte</a> vous retrouverez les informations générales de votre compte Datalab Onyxia GENES et la capacité de modifier le mot de passe pour accéder aux différents services déployer dans votre espace :
|
||||
|
||||
|
||||
|
||||
# Services externes
|
||||
Dans le sous onglet [Services externes](https://onyxia.lab.groupe-genes.fr/account/third-party-integration){:target="_blank"} vous pourrez récupérer et modifier les informations des comptes et jetons Gitlab, Github et Kaggle qui seront par défaut, lié à tous les services que vous créerez. Nous vous conseillons donc de laisser ces paramètres par défaut et que si vous avez besoin d’utiliser un Git différent de celui du GENES pour un service en particulier.
|
||||
Dans le sous onglet <a href="https://onyxia.lab.groupe-genes.fr/account/third-party-integration" target="_blank">Services externes</a> vous pourrez récupérer et modifier les informations des comptes et jetons Gitlab, Github et Kaggle qui seront par défaut, lié à tous les services que vous créerez. Nous vous conseillons donc de laisser ces paramètres par défaut et que si vous avez besoin d’utiliser un Git différent de celui du GENES pour un service en particulier.
|
||||
|
||||
Et d’effectuer la modification lors de la configuration du service dans le [Catalogue de services](https://onyxia.lab.groupe-genes.fr/catalog/ide){:target="_blank"} <span style="color:red">(explication de la configuration en détail disponible ici LIEN A RAJOUTER)</span> exemple:
|
||||
Et d’effectuer la modification lors de la configuration du service dans le <a href="https://onyxia.lab.groupe-genes.fr/catalog/ide" target="_blank">Catalogue de services</a> <span style="color:red">(explication de la configuration en détail disponible ici LIEN A RAJOUTER)</span> exemple:
|
||||
|
||||
|
||||
|
||||

|
||||
|
||||
# Connexion au stockage
|
||||
Dans le sous onglet [Connexion au stockage](https://onyxia.lab.groupe-genes.fr/account/storage){:target="_blank"} vous trouverez toutes les informations de votre [stockage S3](https://minio-console.lab.groupe-genes.fr/browser) fournit par le GENES et qui sera automatiquement lié à tous les services du Datalab Onyxia GENES que vous créerez.
|
||||
Dans le sous onglet <a href="https://onyxia.lab.groupe-genes.fr/account/storage" target="_blank">Connexion au stockage</a> vous trouverez toutes les informations de votre [stockage S3](https://minio-console.lab.groupe-genes.fr/browser) fournit par le GENES et qui sera automatiquement lié à tous les services du Datalab Onyxia GENES que vous créerez.
|
||||
|
||||
**Attention**, concernant l’obtention du Session token S3, il n’est pas affiché dans son entièreté, éviter donc de le copier directement en le sélectionnant puis “copier”. Utiliser bien l'icône “Copier dans le presse-papier" à droite de celui-ci :
|
||||

|
||||
|
@ -202,7 +200,7 @@ Vous pourrez également générer un script d’initialisation dans le langage d
|
|||

|
||||
|
||||
# Vault
|
||||
Dans le sous onglet [Vault](https://onyxia.lab.groupe-genes.fr/account/vault){:target="_blank"}, vous aurez la possibilité de copier les variables d’environnement afin de configurer votre Vault CLI local : <span style="color:red">(VOIR PLUS D’INFO SUR LE FONCTIONNEMENT)</span>
|
||||
Dans le sous onglet <a href="Vault" target="_blank">https://onyxia.lab.groupe-genes.fr/account/vault</a>, vous aurez la possibilité de copier les variables d’environnement afin de configurer votre Vault CLI local : <span style="color:red">(VOIR PLUS D’INFO SUR LE FONCTIONNEMENT)</span>
|
||||
|
||||

|
||||
|
||||
|
@ -211,31 +209,31 @@ Attention, concernant l’obtention du token Vault, comme pour le token S3, il n
|
|||

|
||||
|
||||
# Modes d’interfaces
|
||||
Dans le sous onglet [Modes d’interfaces](https://onyxia.lab.groupe-genes.fr/account/user-interface){:target="_blank"} vous pourrez modifier le thème d’Onyxia, changer la langue, et activer la fonctionnalités “béta-testeur” qui actuellement vous ajout l’accès à un nouvelle onglet “Coquille SQL OLAP” <span style="color:red">A VOIR PLUS EN DETAIL LE TERMINAL DUCKDB</span>
|
||||
Dans le sous onglet <a href="https://onyxia.lab.groupe-genes.fr/account/user-interface" target="_blank">Modes d’interfaces</a> vous pourrez modifier le thème d’Onyxia, changer la langue, et activer la fonctionnalités “béta-testeur” qui actuellement vous ajout l’accès à un nouvelle onglet “Coquille SQL OLAP” <span style="color:red">A VOIR PLUS EN DETAIL LE TERMINAL DUCKDB</span>
|
||||
|
||||
# Catalogue de services
|
||||
L’onglet [Catalogue de services](https://onyxia.lab.groupe-genes.fr/catalog/databases){:target="_blank"} va vous permettre de lancer, paramétrer et sauvegarder la configuration de vos différents services, qui posséderons plus au moins de sous onglets paramétrables S3, Init, Git etc... qui seront plus détaillé dans <span style="color:red">“LIEN VERS Configuration avancée du Catalogue de services“</span> .
|
||||
L’onglet <a href="https://onyxia.lab.groupe-genes.fr/catalog/ide" target="_blank">Catalogue de services</a> va vous permettre de lancer, paramétrer et sauvegarder la configuration de vos différents services, qui posséderons plus au moins de sous onglets paramétrables S3, Init, Git etc... qui seront plus détaillé dans <span style="color:red">“LIEN VERS Configuration avancée du Catalogue de services“</span> .
|
||||
|
||||
Pour lancer et paramétrer un service, il suffit de cliquer sur “Lancer”.
|
||||
|
||||
Chaque service son dans différent sous onglet selon leurs catégories (IDE, Databases etc...), par ailleurs sur quasiment chaque pages web d’onyxia, peu importe la page. Vous trouverez en haut, une redirection en lien avec la page sur laquelle vous vous trouvez et qui peut vous fournir des informations/guide additionnel.
|
||||
|
||||
Par exemple dans le Catalogue de services dans la catégorie [Interactive services](https://onyxia.lab.groupe-genes.fr/catalog/ide){:target="_blank"} vous trouverez une redirection vers un [dépôt helm](https://github.com/InseeFrLab/helm-charts-interactive-services){:target="_blank"} qui rassemble la collection des charts helm qu’utilise Onyxia pour déployer les services:
|
||||
Par exemple dans le Catalogue de services dans la catégorie <a href="https://onyxia.lab.groupe-genes.fr/catalog/ide" target="_blank">Interactive services</a> vous trouverez une redirection vers un <a href="https://github.com/InseeFrLab/helm-charts-interactive-services" target="_blank">dépôt helm</a> qui rassemble la collection des charts helm qu’utilise Onyxia pour déployer les services:
|
||||

|
||||
|
||||
|
||||
# Configuration général du catalogue de services
|
||||
Dans [catalogue de services](https://onyxia.lab.groupe-genes.fr/catalog/ide){:target="_blank"} après avoir cliquer sur “lancer” du services que vous souhaitez utiliser, vous pourrez :
|
||||
Dans <a href="https://onyxia.lab.groupe-genes.fr/catalog/ide" target="_blank">Catalogue de services</a> après avoir cliquer sur “lancer” du services que vous souhaitez utiliser, vous pourrez :
|
||||
|
||||
Attribué un nom personnalisé au service, une fois le service lancé ou enregistré, celui-ci apparaitra dans l’onglet [Mes services](https://onyxia.lab.groupe-genes.fr/my-services){:target="_blank"}.
|
||||
Attribué un nom personnalisé au service, une fois le service lancé ou enregistré, celui-ci apparaitra dans l’onglet <a href="https://onyxia.lab.groupe-genes.fr/my-services" target="_blank">Mes services</a>.
|
||||
|
||||
Le choix de la version du service.
|
||||
|
||||
Sauvegarder l’entièreté de la configuration du service, que vous pourrez redéployer à volonté dans l’onglet [Mes services](https://onyxia.lab.groupe-genes.fr/my-services){:target="_blank"}.
|
||||
Sauvegarder l’entièreté de la configuration du service, que vous pourrez redéployer à volonté dans l’onglet <a href="https://onyxia.lab.groupe-genes.fr/my-services" target="_blank">Mes services</a>.
|
||||
|
||||
Une extension est cliquable en bas à droite de la page, en parallèle de “Configuration %nom_du_service%”, cela déroulera un menu supplémentaire où vous pourrez configurer beaucoup plus de paramètre qui sont expliqué dans la section suivante.
|
||||
|
||||
Copier l’URL de lancement automatique, cela vous permettra de configurer un service, puis d’obtenir une URL que vous pourrez partager avec des collaborateurs. En cliquant sur cette URL, cela déploiera le service que vous avez configurer dans leurs espace onyxia. Cette option est aussi accessible dans l’onglet [Mes services](https://onyxia.lab.groupe-genes.fr/my-services), sur vos services déjà enregistrés.
|
||||
Copier l’URL de lancement automatique, cela vous permettra de configurer un service, puis d’obtenir une URL que vous pourrez partager avec des collaborateurs. En cliquant sur cette URL, cela déploiera le service que vous avez configurer dans leurs espace onyxia. Cette option est aussi accessible dans l’onglet <a href="https://onyxia.lab.groupe-genes.fr/my-services" target="_blank">Mes services</a>, sur vos services déjà enregistrés.
|
||||
|
||||
Par ailleurs, l’option de la copie URL de lancement automatique ne s’affiche pas avant que vous ayez modifié un paramètre sur le service. L’option “Enregistrer la configuration” s’élargit également lors d’une quelconque modification, sinon c’est une petite icône de sauvegarde situé en haut à droite.
|
||||
|
||||
|
@ -245,12 +243,12 @@ Par ailleurs, l’option de la copie URL de lancement automatique ne s’affiche
|
|||
<span style="color:red">A VOIR POUR EXPLIQUER PLUS EN DETAIL LE PARAMETRAGE DES SERVICES HORS CATEGORIE TYPE “INTERACTIVE SERVICES” genre database, mlflow... </span>
|
||||
|
||||
## S3
|
||||
La configuration par défaut est celle de votre [stockage S3](https://minio-console.lab.groupe-genes.fr/browser){:target="_blank"} fournit par le groupe GENES, il vous sera donc possible d'accéder aux fichiers stockés directement dans les services de data science (R, Python, Jupyter...) proposés sur le Datalab, sans avoir besoin de copier les fichiers localement au préalable, ce qui améliore fortement la reproductibilité des analyses.
|
||||
La configuration par défaut est celle de votre <a href="https://minio-console.lab.groupe-genes.fr/browser" target="_blank">stockage S3</a> fournit par le groupe GENES, il vous sera donc possible d'accéder aux fichiers stockés directement dans les services de data science (R, Python, Jupyter...) proposés sur le Datalab, sans avoir besoin de copier les fichiers localement au préalable, ce qui améliore fortement la reproductibilité des analyses.
|
||||
|
||||
Modifier uniquement ces paramètres si vous possédez par exemple un stockage AWS S3 et que vous souhaitez le monter sur un service Onyxia ou que vous avez besoins d’accéder à un stockage S3 GENES autres que celui qui vous a été attribué par défaut.
|
||||

|
||||
|
||||
Pour apprendre à utiliser cet onglet, voir là [page dédiée](https://docs.sspcloud.fr/onyxia-guide/stockage-de-donnees){:target="_blank"}.
|
||||
Pour apprendre à utiliser cet onglet, voir là <a href="https://docs.sspcloud.fr/onyxia-guide/stockage-de-donnees" target="_blank">page dédiée</a>.
|
||||
|
||||
## Kubernetes
|
||||
Cette option est relativement technique et spécifique, vous ne devriez pas en avoir l’intérêt, hors manipulation direct dans l’environnement Kubernetes. Cependant cette option vous permettra, depuis les différents services que vous avez déployés (pods aux seins de votre namespace Onyxia), de pouvoir effectuer des interactions Kubernetes avec le Master Node et exécuter des commandes kubectl dans un terminal de service (kubectl get pods, kubectl edit deployment etc...). Les interactions seront limitées à ce qui est déployé au sein de votre namespace. Vous avez également la possibilité de modifier le rôle Kubernetes attribué aux services, restreignant les actions possibles : view, edit ou admin.
|
||||
|
@ -303,6 +301,7 @@ Le script créera via la commande touch deux fichiers fichier1.txt et fichier2.t
|
|||
|
||||
## Resources
|
||||
C’est l’endroit où vous allez pouvoir configurer le minimum à maximum de ressource à vos services, pour rappel, vous êtes limités par compte à 5 services, 20 CPU, 50Go RAM et 1 GPU.
|
||||
|
||||

|
||||
|
||||
## Networking
|
||||
|
@ -323,6 +322,7 @@ Si coché, le service n'est accessible que par une seule IP, à décocher si l'o
|
|||
|
||||
## Git
|
||||
Par défaut cette option est activée sur chaque service, ce qui configure Git et tente un clone d’un dépôt au démarrage du service. Attention, vous devez renseigner l’URL du dépôt Git dans l’option “Repository”.
|
||||
|
||||

|
||||
|
||||
### Repository
|
||||
|
@ -344,9 +344,9 @@ L'adresse email qui apparaîtra dans les commits (pas forcément le mail associ
|
|||
### Token
|
||||
Jeton d'accès défini sur la plateforme utilisée (Gitlab, Github...).
|
||||
|
||||
Pour apprendre à utiliser plus en détails cette partie de Git, voir là [page dédiée](https://docs.sspcloud.fr/onyxia-guide/controle-de-version){:target="_blank"}.
|
||||
Pour apprendre à utiliser plus en détails cette partie de Git, voir là <a href="https://docs.sspcloud.fr/onyxia-guide/controle-de-version" target="_blank">page dédiée</a>.
|
||||
|
||||
Il n'est pas possible de cloner automatiquement un projet privé d'une instance privée (c'est-à-dire autre que gitlab.com et github.com). Pour le faire, il faudra recourir à un script shell comme indiqué [ici](https://docs.sspcloud.fr/onyxia-guide/configuration-des-services#init){:target="_blank"}.
|
||||
Il n'est pas possible de cloner automatiquement un projet privé d'une instance privée (c'est-à-dire autre que gitlab.com et github.com). Pour le faire, il faudra recourir à un script shell comme indiqué <a href="https://docs.sspcloud.fr/onyxia-guide/configuration-des-services#init" target="_blank">ici</a>.
|
||||
|
||||
|
||||
## Service
|
||||
|
@ -359,7 +359,7 @@ Les différentes options du discovery sont activées, elles permettent de détec
|
|||
Vous permet de modifier la taille du disque alloué à votre service. <span style="color:red">A VOIR car non persistent normalement, bien préciser que les données utilisateurs doivent impérativement être stocker sur git/s3 et non pas sur le service directement. </span>
|
||||
|
||||
## Vault
|
||||
Pour apprendre à utiliser cet onglet, voir la [page dédiée](https://docs.sspcloud.fr/onyxia-guide/gestion-des-secrets){:target="_blank"}.
|
||||
Pour apprendre à utiliser cet onglet, voir la <a href="https://docs.sspcloud.fr/onyxia-guide/gestion-des-secrets" target="_blank">page dédiée</a>.
|
||||
|
||||
##
|
||||
[]()
|
||||
|
|
Loading…
Reference in New Issue
Block a user