La intensión de esta entrada es recrear los pasos necesarios y complementarios para tener un servidor de control de versiones GIT corriendo sobre Debian Wheezy, el cual pueda soportar la gestión cotidiana de cambios sobre códigos fuentes de un equipo de desarrollo. Para ello usaremos GITOLITE como método de control de acceso de nuestros programadores a los repositorios de software. También veremos algunas de las opciones para tener GITWEB ajustado a las necesidades e identidad del equipo.
Gitolite es una capa de la autorización en la parte superior de Git, que se apoya en ssh para la autenticación. Permite especificar permisos no sólo por repositorio, sino también por rama o etiquetas dentro de cada repositorio.
Instalación de paquetes
Servidor de GIT
Dentro del que sera nuestro Servidor GIT
Instalar los siguientes paquetes:
aptitude install git-core git-doc gitolite git-daemon-run gitweb highlight
Agregar usuario para el servicio GIT y sus operaciones:
root@debian7:~#adduser git
root@debian7:~# su - git
git@debian7:~$ git config --global user.name "git"
git@debian7:~$ git config --global user.email [email protected]
En lo sucesivo hacemos referencia a la IP 192.168.0.104 como la ip del servidor, pudiera ser también un nombre de host o subdominio como git.leninmhs.com
Generar y enviar al servidor la llave publica de los usuarios (Desde tu maquina local)
lenin@i5:~$ scp /home/lenin/.ssh/id_rsa.pub [email protected]:/tmp/lhernandez.pub
Consumir la llave del usuario anterior para otorgar el acceso (de vuelta al servidor git)
root@debian7:~# su - git
git@debian7:~$ gl-setup /tmp/lhernandez.pub
The default settings in the rc file (/home/git/.gitolite.rc) are fine for most
people but if you wish to make any changes, you can do so now.
hit enter...
creating gitolite-admin...
Initialized empty Git repository in /home/git/repositories/gitolite-admin.git/
creating testing...
Initialized empty Git repository in /home/git/repositories/testing.git/
[master (root-commit) 8a39640] start
2 files changed, 6 insertions(+)
create mode 100644 conf/gitolite.conf
create mode 100644 keydir/lhernandez.pub
Al ejecutar el comando anterior abrirá directamente un editor de texto con el archivo /home/git/.gitolite.rc donde deberán cambiar
$REPO_UMASK = 0077;
por
$REPO_UMASK = 0027;
y luego ajustar permisos:
chmod g+r /home/git/projects.list chmod -R g+rx /home/git/repositories
De vuelta a tu maquina local, obtendremos los archivos de configuración de gitolite en el cual se gestionan los proyectos versionados con sus respectivos usuarios y accesos. Procederemos a agregar dos repositorios
lenin@i5:~/Escritorio$git clone [email protected]:gitolite-admin.git
lenin@i5:~/Escritorio$cd gitolite-admin
lenin@i5:~/gitolite-admin$ vi conf/gitolite.conf
repo gitolite-admin
RW+ = lhernandez bdiaz
repo tuwiki
RW+ = @all
R = daemon
R = gitweb
repo sistemasoporte
RW+ = lhernandez mvalverde lortiz bdiaz fgordon
R = daemon
R = gitweb
lenin@i5:~/gitolite-admin$
lenin@i5:~/gitolite-admin$git add *
lenin@i5:~/gitolite-admin$git commit -m "Agregando repositorios tuwiki y sistemasoporte con permiso de escritura para lhernandez mvalverde lortiz bdiaz fgordon "
lenin@i5:~/gitolite-admin$git push origin master
.
Configuración de GITWEB
De vuelta a nuestro servidor de GIT procedemos a configurar nuestra interfaz web de GIT
root@debian7:~#vi /etc/gitweb.conf
$projectroot = «/var/cache/git»;
dejar
$projectroot = «/home/git/repositories»;
#$projects_list = $projectroot;
dejar
$projects_list = «/home/git/projects.list»;
root@debian7:~# vi /etc/sv/git-daemon/run
#!/bin/sh
exec 2>&1
echo ‘git-daemon starting.’
exec chpst -ugitdaemon:git \
«$(git –exec-path)»/git-daemon –verbose –reuseaddr \
–base-path=/home/git/repositories /home/git
root@debian7:~# sv restart git-daemon
ok: run: git-daemon: (pid 6393) 0s
root@debian7:~#
.
![gitweb-default](https://leninmhs.com/wp-content/uploads/2013/06/gitweb-default.png?w=604)
.
Agregar theme a gitweb
Usaremos un tema similar a github de nombre gitweb-theme http://kogakure.github.io/gitweb-theme/
git@debian7:~$ su – git
git@debian7:~$ git clone git://github.com/kogakure/gitweb-theme
git@debian7:~$ su
root@debian7:/home/git/gitweb-theme# cp -Rfv /usr/share/gitweb/static/ /usr/share/gitweb/static_old
root@debian7:/home/git/gitweb-theme# cd gitweb-theme/
root@debian7:/home/git/gitweb-theme# cp gitweb.css gitweb.js /usr/share/gitweb/static
![gitweb-theme](https://leninmhs.com/wp-content/uploads/2013/06/gitweb-theme.png?w=604)
![Servidor de GIT](https://leninmhs.com/wp-content/uploads/2013/06/gitweb-theme-summary-150x150.png)
![gitweb-diff](https://leninmhs.com/wp-content/uploads/2013/06/gitweb-diff.png)
Adicionalmente pueden reemplazar los logos, ajustar el archivo css y js a su necesidad en /usr/share/gitweb/static como resultado pudieran tener algo como:
![Servidor de GIT](https://leninmhs.com/wp-content/uploads/2013/06/gitweb-own-theme-150x150.png)
.
Agregar opciones adicionales a gitweb
Agregar las lineas que se presentan a continuación al final del archivo /etc/gitweb.conf
$feature{‘blame’}{‘default’} = [1];
$feature{‘blame’}{‘override’} = 1;
$feature{‘pickaxe’}{‘default’} = [1];
$feature{‘pickaxe’}{‘override’} = 1;
$feature{‘snapshot’}{‘default’} = [‘zip’, ‘tgz’];
$feature{‘snapshot’}{‘override’} = 1;
$feature{‘search’}{‘default’} = [1];
$feature{‘grep’}{‘default’} = [1];
$feature{‘grep’}{‘override’} = 1;
$feature{‘show-sizes’}{‘default’} = [1];
$feature{‘show-sizes’}{‘override’} = 1;
$feature{‘avatar’}{‘default’} = [‘gravatar’];
$feature{‘avatar’}{‘override’} = 1;
$feature{‘highlight’}{‘default’} = [1];
$feature{‘highlight’}{‘override’} = 1;
Habilitando estas opciones obtenemos resaltado de sintaxis del código fuente versionado, un completo buscador, descargar las versiones de los proyectos en otros formatos de compresión, tener avatares de los usuarios, entre otras…
Para consultar la documentación oficial de gitweb en el terminal usen: man gitweb ó visiten: https://www.kernel.org/pub/software/scm/git/docs/gitweb.conf.html
Lenin que tal de nuevo x aquí mira en la parte de Agregar opciones adicionales a gitweb están mal las comillas simples te paso el conf
$feature{‘blame’}{‘default’} = [1];
$feature{‘blame’}{‘override’} = 1;
$feature{‘pickaxe’}{‘default’} = [1];
$feature{‘pickaxe’}{‘override’} = 1;
$feature{‘snapshot’}{‘default’} = [‘zip’, ‘tgz’];
$feature{‘snapshot’}{‘override’} = 1;
$feature{‘search’}{‘default’} = [1];
$feature{‘grep’}{‘default’} = [1];
$feature{‘grep’}{‘override’} = 1;
$feature{‘show-sizes’}{‘default’} = [1];
$feature{‘show-sizes’}{‘override’} = 1;
$feature{‘avatar’}{‘default’} = [‘gravatar’];
$feature{‘avatar’}{‘override’} = 1;
$feature{‘highlight’}{‘default’} = [1];
$feature{‘highlight’}{‘override’} = 1;
Y en la parte de los permisos los cambie por 0750 y me sirvio. Y tambien reinicie el servicio de apache !! de resto tengo GIT
Excelente aporte! A seguir instalando muchos servidores GIT
Amigo gracias por tu aporte, pero te quería consultar una duda. La parte del servidor Git funciona perfectamente pero el git web cuando abro desde el explorador me arroja un mensaje «404 – No projects found»
Inicializaste ya uno o mas repositorios??
Cambiaste $REPO_UMASK = 0077; por $REPO_UMASK = 0027; colocaste los permisos correctos y realizaste los cambios con cuidado en /etc/gitweb.conf y /etc/sv/git-daemon/run
Me pasa lo mismo, basta con que des permisos al repositorio que acabas de crear y refrescar el web, saludos.
Excelente!!
Hola gracias por compartir,
Tengo una duda donde se almacenan localmente los archivos que subo desde una maquina local al servidor git?,
Pasa que cuando voy desde consola a /git/repositories/nombre.git no encuentro por ejemplo el archivo físicamente hello.py que acabo de subir desde un cliente local, pero en el gitweb si logro verlo… es por esto que no entiendo esta parte, si esta lógicamente pero no físicamente?, donde puedo encontrarlos?
Saludos
Lo mas practico es hacer un clone desde cualquier host remoto al servidor, ahora hay que recordar que el Servidor git realmente almacena son las diferencias de los archivos seguramente por ello te ha costado encontrar lo que buscas, igualmente revisare en mi servidor git por lo curioso e interesante del tema
Pues este tema se vuelve aun más curioso porque he empezado a implementarlo en varias maquinas cliente 6 winbugs y 2 GNU/Linux y efectivamente mis cambios se ven en todos los clientes pero en el server git sigo sin encontrarlos, quizás vaya por lo que comentas que el solo guarda los cambios en el proyecto no todo el proyecto, cualquier cosa que encentres a entender mejor esto por acá nos leemos.
Saludos.
Saludos, cada vez que hago un cambio en un proyecto desde la terminal pierdo los permisos necesarios para que el proyecto siga viéndose por gitweb.
Para empezar, después de seguir esta guía pude usar git a través de la terminal sin mayor problema, pero me aparecía el error que relatan más arriba en los comentarios “404 – No projects found”. Lo que finalmente solucionó el error fue cambiar el dueño de la carpeta /home/git/repositories y del archivo /home/git/projects.list a www-data
# chown -R www-data:www-data /home/git/projects.list
# chown -R www-data:www-data /home/git/repositories
Pero cuando hago una edición desde un cliente remoto y luego tiro el «$git push origin master» ya no puedo ver más el proyecto a través de gitweb hasta que repita el cambio de permisos.
¿Qué solución se les ocurre para evitar esto?
Yo he probado agregar al usuario git al grupo www-data y viceversa, cambiar los permisos a 777, colocar al usuario gitweb con privilegios de lectura y escritura en los proyectos, y nada que puedo dar con el problema.
Gracias por tu guía es la más explícita que he visto por ahí que incorpora gitolite.
Saludos verifica:
– Si en conf/gitolite.conf en el renglón de ese proyecto tienes a gitweb autorizado para lectura del repo(R = gitweb) ?
– Si en /home/git/.gitolite.rc se cambio $REPO_UMASK = 0077; por $REPO_UMASK = 0027; ?
Espero sea de utilidad esta guía y la cadena de comentarios, ciertamente para el momento de escribirla no había mucho sobre el tema en internet!
Hola yo solucione el problema como comentas, cambiando el propietario, pero en lugar de data use el usuario git ya que es el que realmente realiza los cambios cuando mandas el push desde tu maquina administrador, saludos.
Excelente, muchas gracias por compartir
Saludos, gracias por sus respuestas, voy a probar las soluciones y les aviso. Había estado ocupado en otro proyecto pero ya volví al Git. Salud!
Excelente!
Buenas compañero, ante todo un saludo cordial y felicitaciones por esta guía de verdad que esta muy bien explicada, me he guiado por este tutorial para instalarlo en debían 8 con el resultado de que me menciona que tengo uno repositorio desfasado , alguien sabe donde puedo conseguir información al respecto Gracias.
Hola no he visto aun este caso en instalaciónes en Debian Jessie, muéstranos el mensaje textual del error para indagar. Saludos!!
Hola
Excelente guia, felicitaciones.
Estoy intentando configurarlo en ubuntu server 14.04.2, me preguntaba si hay alguna limitante o algo que falte, porque no me corre me dice «Not Found The requested URL /gitweb was not found on this server».
He revisado cada uno de los pasos una y otra vez, y nada que consigo la cura.
El archivo /etc/sv/git-daemon/run del servicio lo tengo asi
#!/bin/sh
exec 2>&1
echo ‘git-daemon starting.’
exec chpst -ugitdaemon:git
«$(git -exec-path)»/git-daemon -verbose -reuseaddr
-base-path=/home/git/repositories /home/git
Modifique el archivo /home/git/.gitolite.rc
$REPO_UMASK = 0077; —-> $REPO_UMASK = 0027;
Modifique el archivo/etc/gitweb.conf
$projectroot = «/var/cache/git»; —->$projectroot = «/home/git/repositories»;
#$projects_list = $projectroot;—->$projects_list = «/home/git/projects.list»;
le di permisos 777 recursivos a los directorios:
chmod -R 777 /home/git/projects.list
chmod -R 777 /home/git/repositories
Y git me funciona desde el cliente sin ningun problema ya que puedo hacer add, commit y push.
El problema esta que en el navegador, muestra «Not Found The requested URL /gitweb was not found on this server».
Se agradece la ayuda de antemano.
Saludos
Saludos verifica que el document root de tu apache este apuntando a /usr/share/gitweb
Compara un poco con esta entrada sobre configuración de gitweb & gitweb
http://troglobit.github.io/blog/2015/06/30/howto-apache-with-gitweb-on-debian-8-dot-1/
hola compañero disculpa la tardanza el problema es como te comente que cuando trato instalar gitolite «apt-get install gitolite » en mi debian 8 jessien me dice package gitolite is not available, but is referred to by another package. this may mean that the package is missing, has been obsoleted. en conclusion el paquete es obsoleto para la version de mi sistema operativo o eso es lo que entiendo. investigando un poco encontre que hay una version de gitolite compatible para mi sistema operativo llamado gitolite3 estoy en eso resolviendo alguno detalle despues te informo de los detalle para aquello que lo este intentando en este sistema operativo
Pingback: GitLab CE vs EE - Versión Comunity Edition ó Enterprise Edition? - Leninmhs