forked from DSIT/documentation-dsit
Actualiser docs/Services/pole-scientifique/Onyxia/docs/version.md
ajout information git
This commit is contained in:
parent
e4a05fd052
commit
8430b4c1fc
|
|
@ -67,7 +67,7 @@ Le guide montre en détail comment récupérer les informations suivantes sur Gi
|
|||
|
||||
### 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 :
|
||||
Le jeton d'accès n'est affiché q'une seul fois après sa création et n'est plus récupérable par la suite. Si vous perdez votre token vous devrer simplement en recréé un :
|
||||
|
||||
=== "Github"
|
||||
|
||||
|
|
@ -94,24 +94,51 @@ Le jeton d'accès est uniquement affiché une fois après la création de celui-
|
|||
|
||||
Une fois le jeton généré, ce dernier apparaît à l'écran. Un jeton ne peut être visualisé qu'une seule fois ; en cas de perte, il faudra en générer un nouveau.
|
||||
|
||||
### Ajouter le jeton d'accès au Datalab
|
||||
### Création & récupération de l'URL d'un dépôt
|
||||
|
||||
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.
|
||||
L'URL de vos dépôt vous sera demander lors de la configuration de vos service Onyxia, celui-ci doit être spécifié afin que le service clone automatiquement votre dépôt sur votre service.
|
||||
|
||||
<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.
|
||||
=== "Github"
|
||||
|
||||
## Utiliser Git avec les services du Datalab
|
||||
Rendez vous sur <a href="https://github.com/" target="_blank">Github</a>, cliquer en haut à droite sur l'image de votre profile et sélectionner "Your repositories"
|
||||
|
||||
|
||||
Git est préconfiguré pour fonctionner nativement avec les différents services pertinents du Datalab. A l'ouverture d'un service, il est possible de configurer certains éléments. Si l'on a ajouté un jeton d'accès GitHub à son compte sur le Datalab, ce dernier est pré-configuré. Il est par ailleurs possible d'indiquer l'URL **complète** d'un _Repository_ Git (ex : [https://code.groupe-genes.fr/aguyot-ensae/test-gitop ](https://code.groupe-genes.fr/aguyot-ensae/test-gitop a)), qui sera alors cloné à l'initialisation dans l'espace de travail de l'instance.
|
||||
Ici vous retrouver tous vos dépôts et pourrez en créer de nouveau en cliquant sur l'icône verte "new".
|
||||
|
||||
Pour récuperer l'URL, cliquer sur le dépôts que vous souhaitez cloner sur vos services Onyxia vu précédemment. Sur la nouvelle page, cliquer sur le menu déroulant vert "<> code" puis copier l'URL https:
|
||||
|
||||
|
||||
|
||||
<div style="text-align:center;">Configuration de Git à l’ouverture d’un service</div>
|
||||
|
||||
=== "GitGenes"
|
||||
Pour la création d'un dépôt, rendez vous sur <a href="https://code.groupe-genes.fr/" target="_blank">GitGenes</a, cliquer en haut à droite sur l'icône "+" puis "Nouveau dépôt"
|
||||
|
||||
|
||||
### Via le terminal
|
||||
Pour la création d'un dépôt, rendez vous sur <a href="https://code.groupe-genes.fr/" target="_blank">GitGenes</a, cliquer en haut à droite sur l'image de votre profile puis sur "Profil":
|
||||
|
||||
|
||||
Ici vous retrouverez vos différents dépôt personnel, cliquer sur le dépôt que vous souhaitez cloner sur vos services onyxia, sur la nouvelle page cliquer sur "copier l'URL" HTTPS:
|
||||
|
||||
|
||||
|
||||
https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/#services-externes
|
||||
|
||||
### Ajouter les informations Git sur le Datalab Onyxia Genes
|
||||
Nous avons vu précédemment les différentes informations nécessaires pour la configuration d'un dépôt GitHub & GitGenes sur Onyxia. Nous allons maintenant voir où ajouter ces informations sur le datalab Onyxia Genes pour que vos dépôt soient clonés automatiquement sur vos services Onyxia.
|
||||
|
||||
#### Nom d'utilisateur, email & jeton d'accès (token)
|
||||
|
||||
Ces informations peuvent être ajoutées à deux endroits différents:
|
||||
- Sur l'onglet "Mon compte" qui va permettre d'ajouter un Git qui sera ensuite configuré par défaut sur chaque nouveau service que vous créerez, <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/#services-externe" target="_blank">plus d'information ici</a>.
|
||||
- Individuellement sur chaques services que vous créerez dans le sous onglet "Git" lors de la configuration du service, <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/#git" target="_blank">plus d'information ici</a>.
|
||||
|
||||
|
||||
#### Ajout de l'URL de dépôt
|
||||
|
||||
Pour que vos dépôt soit ajouter sur vos services, il faudra le spécifié l'URL de dépôt à chaque création d'un nouveau service L'URL de dépôt <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/#git" target="_blank">détaillé ici</a>, penser donc à enregistrer la configuration de vos services afin de facilité la création récurente de vos services, plus de détails sur comment enregistrer et configurer un <a href="https://documentation-dsit.lab.groupe-genes.fr/Services/pole-scientifique/Onyxia/docs/#configuration-general-du-catalogue-de-services" target="_blank">service ici</a>.
|
||||
|
||||
|
||||
### Git via le terminal
|
||||
|
||||
Le jeton d'accès GitHub est disponible dans le terminal des différents services via la variable d'environnement `$GIT_PERSONAL_ACCESS_TOKEN`. Afin d'éviter de devoir s'authentifier à chaque opération impliquant le dépôt distant (_clone_, _push_ & _pull_), il est recommandé de cloner celui-ci en incluant le jeton d'accès dans le lien HTTPS, à l'aide de la commande suivante :
|
||||
```git
|
||||
|
|
@ -119,7 +146,7 @@ Le jeton d'accès GitHub est disponible dans le terminal des différents service
|
|||
```
|
||||
où \<owner> et \<repo> sont à remplacer respectivement par le nom d'utilisateur et le nom du dépôt GitHub.
|
||||
|
||||
### Via des interfaces graphiques intégrées
|
||||
### Git via des interfaces graphiques intégrées
|
||||
|
||||
Les principaux services de production de code disponibles sur le Datalab disposent d'une interface graphique pour faciliter l'utilisation de Git :
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user