Fiche 2 Configurer git et RStudio pour utiliser la forge gitlab du pôle ministériel

Gitlab-forge ne permet pas de s’identifier par clé SSH. L’identification des utilisateurs qui contribuent à un projet se fait par token personnel.

Voici les étapes pour configurer votre poste :

  1. Se loguer avec CERBERE sur https://gitlab-forge.din.developpement-durable.gouv.fr.

  2. Editer les paramètres de votre compte à partir du menu du bandeau en haut à droite

  3. Créer votre token personnel en lui donnant un nom et en lui attribuant tous les droits (cochez toutes les cases au niveau du bloc ‘scope’)
    Cliquer sur le bouton create personal access token.

Un message et le token apparaissent en haut de la page :

Votre token ou PAT (pour Personal Access Token) est un mot de passe de la forme glpat-xxxxxxxxxxxxxxxx. Copier le.

  1. Sauvegardez votre PAT en copiant-collant votre identifiant PAT dans un fichier txt accessible de vous seul.e.

  2. Créez votre 1er repo sur gitlab-forge grâce au bouton “Nouveau projet” en haut à droite. Choisissez l’option qui vous convient pour soit créer un projet vide (‘Create blank project’) ou créer un projet à partir d’un export (‘Import project’) cf Migration d’un projet depuis gitlab.com vers Gitlab-forge.

  3. Copier le lien pour cloner ce nouveau répertoire avec https :
    Par exemple : https://gitlab-forge.din.developpement-durable.gouv.fr/dreal-pdl/csd/nouveau_projet.git

  4. Depuis RStudio, créer un nouveau projet avec New project / Version control

Indiquer au niveau de ‘Repository URL’ le lien de clonage https://gitlab-forge.din.developpement-durable.gouv.fr/dreal-pdl/csd/nouveau_projet.git et indiquer le chemin du répertoire du projet R a créer sur votre poste. Puis cliquer sur le bouton Create Project.

  1. Dans RStudio, il faut maintenant déclarer nos identifiants de connexion à gitlab-forge.

Installez les packages {gitcreds} et {gert} s’ils ne sont pas encore installés chez vous.

install.packages("gitcreds")
install.packages("gert")

Pour lancer la procédure d’enregistrement de vos identifiants sur votre poste, lancez l’instruction

gitcreds::gitcreds_set(url = "https://gitlab-forge.din.developpement-durable.gouv.fr")

Renseigner ensuite votre nom d’utilisateur sur gitlab_forge au niveau de ‘user’. C’est début de votre adresse email, généralement prenom.nom.

Renseigner votre PAT au niveau de login.

Vérifier que tout est ok en faisant votre premier push grâce au package {gert}

gert::git_push(set_upstream = TRUE)

🎉