Actualiser docs/Services/pole-scientifique/Onyxia/docs/index.md

modification URL incorrect
This commit is contained in:
Alexis GUYOT 2024-01-26 11:25:24 +01:00
parent 19aa275320
commit e7634c124e

View File

@ -67,9 +67,9 @@ 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.
!!! info
Onyxia, Datalab SSP Cloud : quelles différences ?
Onyxia, Datalab Onyxia GENES : quelles différences ?
[Onyxia ](https://github.com/InseeFrLab/onyxia.git)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/) est une instance du projet Onyxia, hébergée au GENES.
[Onyxia ](https://github.com/InseeFrLab/onyxia.git)est un projet open-source de l'Insee qui propose une plateforme de services de _data science_, accessible via une application Web. Le [Datalab Onyxia Genes](https://onyxia.lab.groupe-genes.fr/) est une instance du projet Onyxia, hébergée au GENES.
# Principes fondamentaux
@ -122,7 +122,7 @@ Il sagit dune présentation sommaire, chaque page web donyxia, vous tro
!!! warning
Les conditions d'utilisation du Datalab sont consultables à <a href="https://code.groupe-genes.fr/DSIT/documentation-dsit/src/branch/main/docs/Services/pole-scientifique/Onyxia/docs/terms.md" 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/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.
# Le catalogue de services
@ -144,7 +144,7 @@ Une page centrée sur le service demandé s'ouvre alors, qui offre plusieurs pos
- sauvegarder une configuration personnalisée en cliquant sur le signet en haut à droite du service, ce qui vous permettra denregistrer l'entièreté de la configuration du service et de le relancer depuis longlet <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 à la section <a href="#configuration-avancée-du-catalogue-de-services" target="_blank">Configuration avancée du Catalogue de 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 à la section <a href="#configuration-avancee-du-catalogue-de-services" target="_blank">Configuration avancée du Catalogue de services</a>.
# Utiliser un service
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.
@ -158,7 +158,7 @@ Supprimer une instance d'un service s'effectue simplement en cliquant sur l'icô
!!! 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://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>.
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>.
!!! info
@ -250,7 +250,7 @@ Attention, concernant lobtention du token Vault, comme pour le token S3, il n
Dans le sous onglet <a href="https://onyxia.lab.groupe-genes.fr/account/user-interface" target="_blank">Modes dinterfaces</a> vous pourrez modifier le thème dOnyxia, changer la langue, et activer la fonctionnalités “béta-testeur” qui actuellement vous ajout laccès à un nouvelle onglet “Coquille SQL OLAP”.
# Catalogue de services
Longlet <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 la section <a href="#configuration-avancée-du-catalogue-de-services" target="_blank">Configuration avancée du Catalogue de services</a> .
Longlet <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 la section <a href="#configuration-avancee-du-catalogue-de-services" target="_blank">Configuration avancée du Catalogue de services</a> .
Pour lancer et paramétrer un service, il suffit de cliquer sur “Lancer”.
@ -280,7 +280,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.
![Screenshot](img/image18.png)
Pour apprendre à utiliser cet onglet, voir là <a href="https://code.groupe-genes.fr/DSIT/documentation-dsit/src/branch/main/docs/Services/pole-scientifique/Onyxia/docs/stockage.md" target="_blank">page dédiée</a>.
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>.
### 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...).
@ -308,7 +308,7 @@ Echo “Hello World” > work/hello-onyxia.txt
Ce script peut être hébergé nimporte où, du moment quil possède une URL publique (example: <https://raw.githubusercontent.com/test/monscript.sh/>) que jajoute ensuite dans le Init parameters “PersonalInit” de longlet Init:
Ce script peut être hébergé nimporte où, du moment quil possède une URL publique (example: <https://git.drees.fr/drees_code_public/ressources/tutos/-/blob/diffusion/contenu/init.sh>) que jajoute ensuite dans le Init parameters “PersonalInit” de longlet Init:
![Screenshot](img/image19.png)
### PersonalInit
@ -388,7 +388,7 @@ 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à <a href="https://code.groupe-genes.fr/DSIT/documentation-dsit/src/branch/main/docs/Services/pole-scientifique/Onyxia/docs/secrets.md" 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/pole-scientifique/Onyxia/docs/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>.
@ -403,7 +403,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.
### Vault
Pour apprendre à utiliser cet onglet, voir la <a href="https://code.groupe-genes.fr/DSIT/documentation-dsit/src/branch/main/docs/Services/pole-scientifique/Onyxia/docs/secrets.md" target="_blank">page dédiée</a>.
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>.
# Mes services
## Grafana