Ecco come creare un repository git e condividerlo con gitosis su ubuntu 9.04.
Installare git
sudo apt-get install git-core python-setuptools
Installare gitosis
cd /tmp
git clone git://eagain.net/gitosis.git
cd gitosis
python setup.py install
Gitosis è un modo “semplificato” – si fa per dire – per gestire gli accessi al repository git e consiste nel modificare un file di configurazione con una serie di autorizzazioni e di chiavi pubbliche ssh associata ad ogni utente.
Prima di poter utilizzare gitosis va creato un utente ad hoc e configurato come amministratore di gitosis. L’utente che andiamo a creare molto originariamente si chiamerà git.
sudo adduser \
--system \
--shell /bin/sh \
--gecos 'git version control' \
--group \
--disabled-password \
--home /home/git \
git
l’utente appena creato avrà come unico compito di “ospitare” il repository e di far girare gitosis. Quindi i repository saranno almeno due
- il repository in cui vogliamo mettere i nostri dati da versionare (può essere più di uno)
- il repository amministrativo di gitosis che si chiama gitosis-admin
a questo punto bisogna fornire l’accesso al repository amministrativo ad un utente del sistema utilizzato per sviluppare (chiamiamolo valerio)
occorre quindi recuperare la chiave pubblica dell’utente valerio da ~/.ssh/id_rsa.pub ma se non è presente va creata con
ssh-keygen -t rsa
e importata nel repository amministrativo gitosis-admin con
sudo -H -u git gitosis-init < ~/.ssh/id_rsa.pub
il quale confermerà con un
Initialized empty Git repository in ./
Initialized empty Git repository in ./
si lo dirà 2 volte.
Bisogna aggiornare alcuni permessi poichè gitosis li imposta in maniera non corretta
sudo chmod 755 /home/git/repositories/gitosis-admin.git/hooks/post-update
A questo punto il repository amministrativo è pronto e lo si può accedere ovviamente utilizzando git con
git clone git@localhost:gitosis-admin.git
verrà creata una sandbox con il file e la directory
-rw-r–r– 1 valerio valerio 142 2009-07-04 17:31 gitosis.conf
drwxr-xr-x 2 valerio valerio 80 2009-07-04 17:31 keydir
gitosis.conf contiene la configurazione degli utenti mentre keydir contiene le chiavi pubbliche di tutti gli utenti (compresa già quella di valerio che è stata passata precedentemente con il comando sudo -H -u git gitosis-init < ~/.ssh/id_rsa.pub )
gitosis.conf contiene le seguenti voci
[gitosis]
[group gitosis-admin]
writable = gitosis-admin
members = valerio@ken
il che significa che attualmente il repository gitosis-admin è accedibile da valerio dalla macchina ken utilizzando la chiave pubblica valerio@ken che è in
ls -l keydir/
-rw-r–r– 1 valerio valerio 393 2009-07-04 17:31 valerio@ken.pub
A questo punto l’installazione è conclusa anche se ovviamente dovrebbero essere aggiunti i repository su cui si vuole versionare il proprio codice. Supponendo di voler creare un repository chiamato personale gitosis.conf assumerà l’aspetto
[gitosis]
[group gitosis-admin]
writable = gitosis-admin
members = valerio@ken
[group team]
writable = personale
members = valerio@ken
dopodichè va fatto il commit ed il push di queste modifiche
git commit -m “new personal repository” -a
git push
a questo punto l’utente valerio@ken è in grado di creare il repository personale con
cd /tmp
mkdir personale
cd personale/
git init
git remote add origin git@localhost:personale.git
echo “il mattino ha l’oro in bocca” > readme.txt
git add readme.txt
git commit -m “primo file”
git push origin master
e il repository personale adesso è accessibile con
git clone git@localhost:personale.git
Utenti multipli
Ovviamente è possibile utilizzare utenti multipli per un singolo repository aggiungendo vari utenti alla configurazione
[group team]
writable = personale
members = vcrini@vcrini-laptop valerio@ken
qui il repository mysite è scrivibile da vcrini e valerio. In keydir va copiata a mano la chiave pubblica vcrini@vcrini-laptop.pub
Volete debuggare?
Aggiungere “loglevel = DEBUG” proprio sotto la voce [gitosis] e fate attenzione agli spazi altrimenti non funziona.
[gitosis]
loglevel = DEBUG
[group gitosis-admin]
writable = gitosis-admin
…
Maggiori informazioni?
C’è un ottimo tutorial su Git qui.
