136 lines
4.1 KiB
Markdown
136 lines
4.1 KiB
Markdown
**Cette page a été importée automatiquement de notre ancien wiki mais n'a pas encore été révisée.**
|
|
|
|
# Plugin Redmine Git Hosting + Gitolite
|
|
|
|
#### Redmine et Gitolite doivent se situer sur le même serveur !
|
|
|
|
## Prérequis
|
|
|
|
Installation de gitolite 3 (sous Wheezy nécessite les backports) :
|
|
|
|
~~~
|
|
# aptitude install gitolite3
|
|
~~~
|
|
|
|
Installation des dépendances Redmine Git Hosting :
|
|
|
|
~~~
|
|
# aptitude install build-essential libssh2-1 libssh2-1-dev cmake libgpg-error-dev
|
|
~~~
|
|
|
|
Mise en place de [wiki:HowtoGitDaemon git-daemon] et [wiki:HowtoGitWeb gitweb] (optionnel).
|
|
|
|
## I. Installation Gitolite
|
|
|
|
Choix de l'utilisateur $GITOLITE :
|
|
|
|
* $GITOLITE : utilisateur propriétaire de l'application
|
|
* accès SSH depuis $GITOLITE@votre-domaine.tld
|
|
|
|
~~~
|
|
GITOLITE='git'
|
|
~~~
|
|
|
|
Création de l'utilisateur système $GITOLITE ainsi que son groupe.
|
|
|
|
~~~
|
|
useradd $GITOLITE -d "/home/$GITOLITE" -c "Gitolite $GITOLITE" -s "/bin/bash" -m
|
|
~~~
|
|
|
|
Initialisation de Gitolite :
|
|
|
|
~~~
|
|
cp /home/$REDMINE/.ssh/redmine_gitolite_admin_id_rsa.pub /home/$GITOLITE/
|
|
chown $GITOLITE: /home/$GITOLITE/redmine_gitolite_admin_id_rsa.pub
|
|
su - $GITOLITE -c "gitolite setup -pk redmine_gitolite_admin_id_rsa.pub"
|
|
rm /home/$GITOLITE/redmine_gitolite_admin_id_rsa.pub
|
|
~~~
|
|
|
|
Configuration gitolite3 :
|
|
|
|
~~~
|
|
chmod 750 -R /home/$GITOLITE/repositories /home/$GITOLITE/projects.list
|
|
vi /home/$GITOLITE/.gitolite.rc
|
|
#changer UMASK de 0077 à 0027
|
|
#changer GIT_CONFIG_KEYS de '' à '.*'
|
|
#décommenter la ligne : LOCAL_CODE => "$ENV{HOME}/local"
|
|
~~~
|
|
|
|
Interdit l'utilisateur $GITOLITE de se connecter avec un mot de passe et l'autorise à se connecter si l'accès SSH est limité :
|
|
|
|
~~~
|
|
cat >> /etc/ssh/sshd_config <<SSH
|
|
Match User $GITOLITE
|
|
PasswordAuthentication no
|
|
SSH
|
|
sed -ie "/^AllowUsers/s/.*/& $GITOLITE/" /etc/ssh/sshd_config
|
|
sed -ie "/^AllowGroups/s/.*/& $GITOLITE/" /etc/ssh/sshd_config
|
|
service ssh reload
|
|
~~~
|
|
|
|
### II. Installation du plugin redmine Git Hosting -User = $REDMINE)
|
|
|
|
Connection en tant que l'utilisateur $REDMINE :
|
|
|
|
~~~
|
|
su - $REDMINE
|
|
~~~
|
|
|
|
Génération de la clé SSH :
|
|
|
|
~~~
|
|
ssh-keygen -N '' -f /home/$REDMINE/.ssh/redmine_gitolite_admin_id_rsa
|
|
~~~
|
|
|
|
#### Cette clé aura accès à tous les dépots de Gitolite !
|
|
Ajout de localhost dans les know_hosts de l'utilisateur $REDMINE (vous devez accepter le fingerprint !) :
|
|
|
|
~~~
|
|
ssh localhost
|
|
~~~
|
|
|
|
Clonage des plugins dans redmine/plugins :
|
|
|
|
~~~
|
|
git clone <https://github.com/jbox-web/redmine_bootstrap_kit.git> -b v0.2.x ~/redmine/plugins/redmine_bootstrap_kit
|
|
git clone <https://github.com/jbox-web/redmine_git_hosting.git> -b v1.2.x ~/redmine/plugins/redmine_git_hosting
|
|
~~~
|
|
|
|
Ajout du scm Xitolite dans Redmine :
|
|
|
|
~~~
|
|
echo " scm_xitolite_command: /usr/bin/git" >> ~/redmine/config/configuration.yml
|
|
~~~
|
|
|
|
### III. Configuration de l'accès sudo (User = root)
|
|
|
|
*A faire même si l'utilisateur $GITOLITE est le même que $REDMINE*
|
|
|
|
Autorise $REDMINE à sudo vers $Gitolite :
|
|
|
|
~~~
|
|
cat > /etc/sudoers.d/$REDMINE\_$GITOLITE <<SUDO
|
|
Defaults:$REDMINE !requiretty
|
|
$REDMINE ALL=($GITOLITE) NOPASSWD:ALL
|
|
SUDO
|
|
chmod 440 /etc/sudoers.d/$REDMINE\_$GITOLITE
|
|
~~~
|
|
|
|
#### Si le plugin est installé après Redmine et non en même temps
|
|
|
|
Exécuter les taches [wiki:HowToRedmine-Source/Plugins post-installation].
|
|
|
|
### Configuration du plugin
|
|
|
|
* Rendez vous dans Administration -> Redmine Git Hosting Plugin -> SSH et remplacer :
|
|
* Nom d'utilisateur Gitolite par la valeur de $GITOLITE
|
|
* L'emplacement des clés privées et publiques SSH de Gitolite par le dossier .ssh de l'utilisateur $REDMINE
|
|
* Rendez vous dans Administration -> Redmine Git Hosting Plugin -> Accès et remplacer :
|
|
* Nom de domaine du serveur HTTP et HTTPS par le nom de domaine de votre serveur
|
|
* Nom de domaine du serveur SSH par $GITOLITE.votredomain.tld
|
|
* Rendez vous dans Administration -> Redmine Git Hosting Plugin -> Stockage et remplacer :
|
|
* Répertoire de stockage des hooks non-core par hooks
|
|
* Rendez vous dans Administration -> Redmine Git Hosting Plugin -> Hooks et remplacer :
|
|
* Url des hooks par <https://votre-domaine.tld>
|
|
* Cliquer en haut à droit sur installer les hooks !
|
|
* Rendez vous dans Administration -> Redmine Git Hosting Plugin -> Test de la configuration et vérifier que tous les indicateurs sont au vert |