Nous encourageons les personnes, à utiliser git et en particulier GitLab afin de pouvoir versionner les changements et aussi pour gérer les différentes demandes .

GIT

Votre projet est peut être géré sur notre Gitlab, sur Github (en repo public ou sur Github en repo privé).

Nous proposons une instance Gitlab pour nos clients (à titre expérimental et sans surcoût pendant la phase expérimentale). Pour obtenir un compte et un projet sur Gitlab nous contacter .

Access Tokens

Suite à une sécurisation de git, une évolution a eu lieu en 2023 et nous contraint de changer de système d’identification pour plus de sécurité. Il n’est plus nécessaire d’autoriser l’utilisateur nursit-deploy sur votre projet.

Il faut générer un Token d’accès qui va nous permettre de reconfigurer le clone de votre dépot sur nos serveurs.

Envoyez nous cet acces token via notre formulaire de Contact , ce token nous permettra de cloner votre projet et remplacer votre dossier squelettes.

Gitlab : Project Access Tokens

Sur Gitlab voici comment générer un accès token. Attention de bien mettre une expiration ( à 5 ans par exemple) ensuite cliquez sur visualiser et/ou copier le token pour nous le transmettre

Github : Fine-grained Personal Access Tokens

Sur Github, c’est depuis un compte utilisateur qu’on peut fournir un token uniquement en lecture pour un projet, depuis Settings > Developer > Personnal access token > Fine-grained tokens

Il faudra lui donner un petit nom, une date d’expiration (maximum 1 an chez Github), indiquer pour quel projet il doit s’appliquer, des droits de « Contents » en lecture (qui nous permettent de clone et pull), et générer le token.

Mise à jour

Une fois que nous avons mis en place le repos une nouvelle entrée apparaît dans la maintenance du site pour les administrateurs Maintenance / mise à jour des dépôts

Mise à jour problème

Update octobre 2020

Si la mise à jour semble bloquée et qu’il n’y a rien d’affiché uniquement l’heure du lancement, c’est qu’il y a un soucis (et nous ne pouvons pas afficher directement pour l’instant la source de l’erreur sur cette page) .

Il faut alors nous contacter car quelque chose empêche de mettre à jour.

par exemple un conflit sur un fichier :

git status
Sur la branche master
Votre branche est à jour avec 'origin/master'.
Chemins non fusionnés :
  (utilisez "git reset HEAD <fichier>..." pour désindexer)
  (utilisez "git add <fichier>..." pour marquer comme résolu)
modifié des deux côtés :  inclure/resume/article_sommaire.html

aucune modification n'a été ajoutée à la validation (utilisez "git add" ou "git commit -a")

Architecture

Le principe mis en place est le suivant : l’archivage de votre projet correspond au dossier squelettes de votre site SPIP. Au fond de la salle des voix se font entendre : oui mais les plugins je les mets où ? : pas de panique, comme l’explique l’article Ajouter un plugin , ils peuvent être dans le dossier squelettes\plugins.

Pour vos fichiers de squelettes pas de problème particulier donc : vous gérez vos fichiers sommaire.html et C^ie dans GIT.

Pour les plugins ( les plugins qui ne sont pas dans Les plugins SPIP disponibles chez Nursit ) il y a plusieurs façons de faire. Vous choisissez celle que vous souhaitez.

Plugins Méthode Webdav

Vous ne gérez sous Git que votre squelettes et vous ajoutez via WEBDAV le dossier squelettes/plugins et les plugins que vous avez choisis

Plugins Méthode archivage sous git

L’idée est d’extraire en local vos plugins (par svn par exemple), d’ignorer les références svn, et d’archiver sous git

Pour résumer cela en lignes de commandes cela peut être :

cd monRepertoireGit
## indiquer à gitlab d'ignorer les répertoires svn
echo ".svn/" >.gitignore
## créer un répertoire plugin et y ajouter un plugin 
mkdir plugins 
cd plugins 
svn co svn://zone.spip.org/spip-zone/_plugins_/palette palette
## archiver sur git 
cd ..
git status 
git commit -m "Ajout du plugin palette" -a 

Windows et GIT

Erationnal a publié un article très détaillé sur son paramétrage de Git sur la plateforme Nursit

Editer directement dans GITLAB

  Si votre projet est hébergé sur notre Gitlab une petite icone est apparue en mai 2023 :

Vous pouvez mettre à jour le fichier directement depuis le web puis vous rendre dans l’espace privé de votre site et mettre à jour