modification URL

This commit is contained in:
Alexis GUYOT 2024-02-09 14:09:45 +01:00
parent 79ad8ff317
commit 08e994343d
3 changed files with 17 additions and 17 deletions

View File

@ -49,10 +49,10 @@ L'avantage du datalab réside dans la possibilité de partager chaque service av
## Liens utiles ## Liens utiles
- <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/secrets/" target="_blank">Gestion des secrets</a> - <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/secrets/" target="_blank">Gestion des secrets</a>
- <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/stockage/" target="_blank">Stockages de données</a> - <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/stockage/" target="_blank">Stockages de données</a>
- <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/version/" target="_blank">Contrôle de version</a> - <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/version/" target="_blank">Contrôle de version</a>
- <a href=" https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/terms/" target="_blank">Conditions général d'utilisations</a> - <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/terms/" target="_blank">Conditions général d'utilisations</a>
@ -130,7 +130,7 @@ Il sagit dune présentation sommaire n'expliquant pas de façon détaillé
!!! warning !!! warning
Les conditions d'utilisation du Datalab sont consultables à <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/terms/" target="_blank">ici</a>. 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. Les conditions d'utilisation du Datalab sont consultables à <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/terms/" target="_blank">ici</a>. 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
@ -166,7 +166,7 @@ Supprimer une instance d'un service s'effectue simplement en cliquant sur l'icô
!!! danger !!! danger
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://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/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://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/stockage/" target="_blank">système de stockage S3</a>. 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://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/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://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/stockage/" target="_blank">système de stockage S3</a>.
!!! info !!! info
@ -229,7 +229,7 @@ Dans le sous onglet <a href="https://onyxia.lab.groupe-genes.fr/account/third-pa
Nous vous conseillons donc de laisser ces paramètres par défaut, si vous devez utiliser un dépôt git différent (github, bitbucket...) sur un service spécifique, faite 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>, expliquer plus <a href="#git" target="_blank"> en détails ici.</a>: Nous vous conseillons donc de laisser ces paramètres par défaut, si vous devez utiliser un dépôt git différent (github, bitbucket...) sur un service spécifique, faite 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>, expliquer plus <a href="#git" target="_blank"> en détails ici.</a>:
Vous retrouverez également un guide complet sur comment créer et retrouver les informations nécessaires pour la configuration de votre <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/version/#pourquoi-github" target="_blank">Git sur Github & GitGenes ici</a>. Vous retrouverez également un guide complet sur comment créer et retrouver les informations nécessaires pour la configuration de votre <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/version/#pourquoi-github" target="_blank">Git sur Github & GitGenes ici</a>.
![Screenshot](img/image11.png) ![Screenshot](img/image11.png)
@ -277,7 +277,7 @@ Dans <a href="https://onyxia.lab.groupe-genes.fr/catalog/ide" target="_blank">Ca
- Attribué un nom personnalisé au service, une fois le service lancé ou enregistré, celui-ci apparaitra dans longlet <a href="https://onyxia.lab.groupe-genes.fr/my-services" target="_blank">Mes services</a>. - Attribué un nom personnalisé au service, une fois le service lancé ou enregistré, celui-ci apparaitra dans longlet <a href="https://onyxia.lab.groupe-genes.fr/my-services" target="_blank">Mes services</a>.
- Le choix de la version du service. - Le choix de la version du service.
- Sauvegarder lentièreté de la configuration du service, que vous pourrez redéployer à volonté dans longlet <a href="https://onyxia.lab.groupe-genes.fr/my-services" target="_blank">Mes services</a>. - Sauvegarder lentièreté de la configuration du service, que vous pourrez redéployer à volonté dans longlet <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 <a href="https://code.groupe-genes.fr/DSIT/documentation-dsit/src/branch/main/docs/Services/pole-scientifique/Onyxia/docs/index.md#configuration-g%C3%A9n%C3%A9ral-du-catalogue-de-services" target="_blank">disponible ici</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 <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/docs/index.md#configuration-g%C3%A9n%C3%A9ral-du-catalogue-de-services" target="_blank">disponible ici</a>.
- Copier lURL de lancement automatique, cela vous permettra de configurer un service, puis dobtenir 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 longlet <a href="https://onyxia.lab.groupe-genes.fr/my-services" target="_blank">Mes services</a>, sur vos services déjà enregistrés. - Copier lURL de lancement automatique, cela vous permettra de configurer un service, puis dobtenir 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 longlet <a href="https://onyxia.lab.groupe-genes.fr/my-services" target="_blank">Mes services</a>, sur vos services déjà enregistrés.
Par ailleurs, loption de la copie URL de lancement automatique ne saffiche pas avant que vous ayez modifié un paramètre sur le service. Loption “Enregistrer la configuration” sélargit également lors dune quelconque modification, sinon cest une petite icône de sauvegarde situé en haut à droite. Par ailleurs, loption de la copie URL de lancement automatique ne saffiche pas avant que vous ayez modifié un paramètre sur le service. Loption “Enregistrer la configuration” sélargit également lors dune quelconque modification, sinon cest une petite icône de sauvegarde situé en haut à droite.
@ -292,7 +292,7 @@ La configuration par défaut est celle de votre <a href="https://minio-console.l
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 daccéder à un stockage S3 GENES autres que celui qui vous a été attribué par défaut. 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 daccéder à un stockage S3 GENES autres que celui qui vous a été attribué par défaut.
![Screenshot](img/image18.png) ![Screenshot](img/image18.png)
Pour apprendre à utiliser cet onglet, voir là <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/stockage/" target="_blank">page dédiée</a>. Pour apprendre à utiliser cet onglet, voir là <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/stockage/" target="_blank">page dédiée</a>.
### Kubernetes ### Kubernetes
Cette option est relativement technique et spécifique, vous ne devriez pas en avoir lintérêt, hors manipulation direct dans lenvironnement 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...). Cette option est relativement technique et spécifique, vous ne devriez pas en avoir lintérêt, hors manipulation direct dans lenvironnement 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...).
@ -381,7 +381,7 @@ Par défaut cette option est activée sur chaque service, ce qui va automatiquem
![Screenshot](img/image22.png) ![Screenshot](img/image22.png)
Un guide complet sur comment créer et trouver les informations d'un dépôt GitHub/GitGenes pour les ajouters sur les services Onyxia est <a href="https://code.groupe-genes.fr/DSIT/documentation-dsit/src/branch/main/docs/Services/pole-scientifique/Onyxia/docs/version.md#pourquoi-git" target="_blank">disponible ici</a>. Un guide complet sur comment créer et trouver les informations d'un dépôt GitHub/GitGenes pour les ajouters sur les services Onyxia est <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/version/" target="_blank">disponible ici</a>.
**Repository :** **Repository :**
@ -403,7 +403,7 @@ L'adresse email qui apparaîtra dans les commits (pas forcément le mail associ
**Token :** **Token :**
Jeton d'accès défini sur la plateforme utilisée (Gitlab, Github...). 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à <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/secrets/" target="_blank">page dédiée</a>. Pour apprendre à utiliser plus en détails cette partie de Git, voir là <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/secrets/" 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é <a href="#init" target="_blank">plus de détails ici</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é <a href="#init" target="_blank">plus de détails ici</a>.
@ -433,7 +433,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. Vous permet de modifier la taille du disque alloué à votre service.
### Vault ### Vault
Pour apprendre à utiliser cet onglet, voir la <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/secrets/" target="_blank">page dédiée</a> et <a href="#vault" target="_blank">Vault</a>. Pour apprendre à utiliser cet onglet, voir la <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/secrets/" target="_blank">page dédiée</a> et <a href="#vault" target="_blank">Vault</a>.
# Mes services # Mes services
@ -461,7 +461,7 @@ Grafana est un outil de surveillance et de visualisation des données qui offre
# Mes secrets # Mes secrets
Les variables denvironnement, il arrive que certaines informations doivent être mise à disposition dun grand nombre dapplications, ou ne doivent pas figurer en clair dans votre code (jetons daccès, mots de passe, etc.). Lutilisation de variables denvironnement permet de pouvoir accéder à ces informations depuis nimporte quel service. Les variables denvironnement, il arrive que certaines informations doivent être mise à disposition dun grand nombre dapplications, ou ne doivent pas figurer en clair dans votre code (jetons daccès, mots de passe, etc.). Lutilisation de variables denvironnement permet de pouvoir accéder à ces informations depuis nimporte quel service.
Pour apprendre à utiliser cet onglet, voir la <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/secrets/" target="_blank">page dédiée</a>. Pour apprendre à utiliser cet onglet, voir la <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/secrets/" target="_blank">page dédiée</a>.
# Mes fichiers # Mes fichiers
La page <a href="https://onyxia.lab.groupe-genes.fr/my-files/aguyot-ensae" target="_blank">Mes fichiers</a> du Datalab prend la forme d'un explorateur de fichiers présentant les différents buckets (dépôts) auxquels lutilisateur a accès. La page <a href="https://onyxia.lab.groupe-genes.fr/my-files/aguyot-ensae" target="_blank">Mes fichiers</a> du Datalab prend la forme d'un explorateur de fichiers présentant les différents buckets (dépôts) auxquels lutilisateur a accès.
@ -469,7 +469,7 @@ Chaque utilisateur dispose par défaut d'un bucket personnel pour stocker ses fi
Il est possible de lire directement vos fichiers depuis cette interface en double cliquant simplement dessus (.mp4, .parquet, .csv etc...), si le format n'est pas lisible depuis l'interface du datalab, cela vous téléchargement automatiquement le fichier. Il est possible de lire directement vos fichiers depuis cette interface en double cliquant simplement dessus (.mp4, .parquet, .csv etc...), si le format n'est pas lisible depuis l'interface du datalab, cela vous téléchargement automatiquement le fichier.
Pour apprendre à utiliser cet onglet, voir la <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/stockage/" target="_blank">page dédiée</a>. Pour apprendre à utiliser cet onglet, voir la <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/stockage/" target="_blank">page dédiée</a>.
# Explorateur de Données # Explorateur de Données

View File

@ -4,7 +4,7 @@
Il arrive que certaines informations doivent être mise à disposition d'un grand nombre d'applications, ou ne doivent pas figurer en clair dans votre code (jetons d'accès, mots de passe, etc.). L'utilisation de **variables d'environnement** permet de pouvoir accéder à ces informations depuis n'importe quel service. Il arrive que certaines informations doivent être mise à disposition d'un grand nombre d'applications, ou ne doivent pas figurer en clair dans votre code (jetons d'accès, mots de passe, etc.). L'utilisation de **variables d'environnement** permet de pouvoir accéder à ces informations depuis n'importe quel service.
Au lancement d'un service, plusieurs variables d'environnement sont déjà injectées automatiquement — par exemple, les tokens d'accès à <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/version/" target="_blank">GitHub</a> et <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/stockage/" target="_blank">MinIO</a>. Au lancement d'un service, plusieurs variables d'environnement sont déjà injectées automatiquement — par exemple, les tokens d'accès à <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/version/" target="_blank">GitHub</a> et <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/stockage/" target="_blank">MinIO</a>.
![](/img/secret.png) ![](/img/secret.png)

View File

@ -34,11 +34,11 @@ Pour simplifier la mise à disposition en lecture de plusieurs fichiers — dans
!!! warning !!! warning
Conformément aux <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/terms/" target="_blank">conditions d'utilisation</a>, seuls des données de type _open data_ ou ne présentant aucune sensibilité peuvent être stockées sur le Datalab. Le fait qu'un fichier ait un statut de diffusion "privé" ne suffit pas à garantir une parfaite confidentialité. Conformément aux <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/terms/" target="_blank">conditions d'utilisation</a>, seuls des données de type _open data_ ou ne présentant aucune sensibilité peuvent être stockées sur le Datalab. Le fait qu'un fichier ait un statut de diffusion "privé" ne suffit pas à garantir une parfaite confidentialité.
## Utiliser des données stockées sur MinIO ## Utiliser des données stockées sur MinIO
Les identifiants d'accès nécessaires pour accéder à des données sur MinIO sont pré-configurés dans les différents services du Datalab, accessibles sous la forme de <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/secrets/" target="_blank">variables d'environnement</a>. Ainsi, l'import et l'export de fichiers à partir des services est grandement facilité. Les identifiants d'accès nécessaires pour accéder à des données sur MinIO sont pré-configurés dans les différents services du Datalab, accessibles sous la forme de <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/Datalab/Onyxia/secrets/" target="_blank">variables d'environnement</a>. Ainsi, l'import et l'export de fichiers à partir des services est grandement facilité.