forked from DSIT/documentation-dsit
Actualiser docs/Services/pole-scientifique/Onyxia/docs/version.md
ajout d'information
This commit is contained in:
parent
ead237743f
commit
993d52f630
|
|
@ -20,16 +20,24 @@ Dans le cadre de projets collaboratifs :
|
|||
Ce tutoriel vise à présenter comment le contrôle de version peut être facilement implémenté grâce aux outils présents sur le Datalab. Il ne présente pas le fonctionnement de Git et présuppose donc une certaine familiarité avec l'outil. De nombreuses ressources en ligne peuvent servir d'introduction ; l'utilisateur de R pourra par exemple consulter <a href="https://linogaliana.gitlab.io/collaboratif/git.html" target="_blank">ce guide</a>. Une formation complète à Git sera bientôt proposée dans l'espace formation du Datalab qui sera bientôt ajouter sur notre Datalab Onyxia.
|
||||
|
||||
|
||||
## Intégration de GitHub avec le Datalab
|
||||
## Intégration de Git avec le Datalab
|
||||
|
||||
### Pourquoi Git ?
|
||||
|
||||
Bien qu'une utilisation hors-ligne de Git soit possible, tout l'intérêt du contrôle de version réside dans la synchronisation de la copie locale d'un projet (_clone_) avec un dépôt distant (_remote_). Différents services de forge logicielle permettent cette synchronisation des projets Git, dont les plus connus sont <a href="https://github.com" target="_blank">Github</a> et <a href="https://about.gitlab.com" target="_blank">GitLab</a>. Dans la mesure où le premier dispose aujourd'hui de beaucoup plus de visibilité — par exemple, les dépôts du Genes, sont hébergé en interne via Gitea <a href="https://code.groupe-genes.fr/" target="_blank">accessible ici</a>.
|
||||
|
||||
Vous disposer donc automatiquement d'un dépôt <a href="https://code.groupe-genes.fr/" target="_blank">GitGenes</a>, vous pouvez y accéder en utilisant votre compte ENSAE. Celui-ci est également automatiquement intégré sur votre compte du datalab Onyxia Genes comme <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/#services-externes" target="_blank">décrit ici</a>.
|
||||
Vous disposer donc automatiquement d'un dépôt <a href="https://code.groupe-genes.fr/" target="_blank">GitGenes</a>, que vous pouvez accéder en utilisant votre compte ENSAE. Celui-ci est également automatiquement intégré sur votre compte du datalab Onyxia Genes comme <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/#services-externes" target="_blank">décrit ici</a>.
|
||||
|
||||
|
||||
le Datalab Onyxia Genes propose une intégration facilitée avec GitHub, que nous présentons à travers ce tutoriel.
|
||||
le Datalab Onyxia Genes propose une intégration facilitée avec Git, que nous vous présentons à travers ce tutoriel. La suite du guide vous permettra de configurer GitHub & GitGenes sur le datalab Onyxia Genes à deux endroits:
|
||||
- Dans l'onglet <a href="https://onyxia.lab.groupe-genes.fr/account/third-party-integration" target="_blank">Services externes</a> qui ajoutera la configuration de votre dépôt git automatiquement sur chaques service qui vous créé (plus d'information sur notre <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/#services-externes" target="_blank">guide principal ici</a> )
|
||||
- Lors de la création d'un <a href="https://onyxia.lab.groupe-genes.fr/my-services" target="_blank">Services</a>
|
||||
|
||||
Le guide montre en détail comment récupérer les informations suivantes sur Github & GitGenes:
|
||||
- Nom d'utilisateur pour Git
|
||||
- Email pour Git
|
||||
- Jeton d'accès personnel (Token)
|
||||
- URL Repository
|
||||
|
||||
|
||||
!!! tip
|
||||
|
|
@ -40,15 +48,32 @@ le Datalab Onyxia Genes propose une intégration facilitée avec GitHub, que nou
|
|||
Si l'utilisation du Datalab avec la plateforme GitHub & GitGenes est facilitée, elle n'est en aucun cas obligatoire : il reste tout à fait possible d'utiliser la forge logicielle de son choix pour la synchronisation des projets.
|
||||
|
||||
|
||||
### Récuperer votre nom d'utilisateur et email
|
||||
|
||||
|
||||
|
||||
=== "Github"
|
||||
|
||||
Ces deux informations sont <a href="https://github.com/settings/emails" target="_blank">disponible ici</a>
|
||||
|
||||
|
||||
|
||||
=== "GitGenes"
|
||||
Vous retrouverez automatiquement votre nom d'utilisateur dans votre <a href="https://code.groupe-genes.fr/user/settings" target="_blank">compte GitGenes disponible ici</a>.
|
||||
Votre nom d'utilisateur sera systématiquement composé tout attaché de la première lettre de votre prénom + votre nom + "-ensae" exemple:
|
||||
- Nom: Houdin ; Prenom: Christophe
|
||||
- Nom d'utilisateur: hchristophe-ensae
|
||||
|
||||
|
||||
### Créer un jeton d'accès (_token_)
|
||||
|
||||
Le jeton d'accès est uniquement affiché une fois après la création de celui-ci et n'est plus récupérable par la suite. Si vous perdez votre token vous devrer simplement en recréé un :
|
||||
|
||||
=== "Github"
|
||||
|
||||
La synchronisation avec un dépôt distant nécessite une authentification auprès de GitHub. Celle-ci s'effectue à l'aide d'un jeton d'accès personnel, qui doit être généré à partir du compte GitHub de l'utilisateur. Le service de génération est accessible à <a href="https://github.com/settings/tokens" target="_blank">cette adresse</a>. La <a href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token" target="_blank">documentation GitHub</a>(en Anglais) propose des illustrations pour guider le processus.
|
||||
|
||||
|
||||
|
||||
|
||||
Pour générer un jeton, il est nécessaire de choisir un nom de jeton, un délai d'expiration et des droits d'accès (_scope_). Il est recommandé de choisir un délai court (30 jours) et un accès restreint (_repo_ seulement) afin de limiter les risques de sécurité en cas de diffusion malveillante du jeton.
|
||||
|
||||
<div style="text-align:center;">Configuration recommandée pour la génération d’un jeton d’accès GitHub</div>
|
||||
|
|
@ -74,7 +99,7 @@ Une fois le jeton généré, ce dernier apparaît à l'écran. Un jeton ne peut
|
|||
Il est recommandé d'ajouter ses jetons d'accès à un gestionnaire de mots de passe. Le jeton peut également être ajouté à la configuration "Services externes" du compte utilisateur sur le Datalab, ce qui permet au jeton d'être directement accessible au sein des services proposés sur la plateforme.
|
||||
|
||||
<div style="text-align:center;">Ajouter un jeton d’accès GitHub à un compte utilisateur sur le Datalab</div>
|
||||
|
||||
|
||||
|
||||
!!! warning
|
||||
Attention à bien utiliser dans les "Informations du compte" l'adresse mail associée à votre compte GitHub, c'est elle qui permet de lier effectivement les _commits_ que vous effectuerez à votre compte GitHub.
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user