Escrito el 24 mayo 2012 por Luis Ignacio Díaz Martínez
Aprovechando que por fín he conseguido a concienciarme e instalar Ubuntu 12.04 en el ordenador del despacho explicaré como instalar Git + GitLab en el. Sencillamente, dentro de poquito empezaré con tareas de desarrollo ( nueva página web, módulos, aplicativos… ) por lo tanto, es fundamental tener instalado un software decente dedicado al control de versiones.
Así que a continuación podréis ver una guía básica y por encima de su instalación.
Entorno
- Sistema operativo: Ubuntu 11.10 ( también realizado con Debian 6.0 )
- Memoria RAM: 2Gb ( proximamente ampliare a 4Gb )
- Tipo de máquina: Genérica
Desarrollo
Ahora empezaremos con lo bueno. Primero de todo explicar que estructuraré este mini-manual por pasos. Por si alguien se pierde ( chiste fácil ). Así que simplemente ir siguiendo las indicaciones que seguro que el camino de las baldosas amarillas será el sencillo de superar.
Instalación base del software
**Nota para instalación en Debian 6.0, para realizar estos pasos necesitaremos tener instalado «sudo» para ello lo instalaremos de la siguiente forma:
|
|
apt-get update && apt-get upgrade && apt-get install sudo |
Vale, comenzamos la guinda del pastel. Tenemos que tener en cuenta que git ya se encuentra en repositorios así que aprovechando esto empezaremos instalando los paquetes que necesitamos.
|
|
sudo apt-get update sudo apt-get install -y wget curl gcc checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libreadline6-dev libc6-dev libssl-dev libmysql++-dev make build-essential zlib1g-dev libicu-dev redis-server openssh-server git-core python-dev python-pip libyaml-dev postfix libpq-dev |
Ahora tendremos que instalar MySQL que es uno de los requisitos básicos:
|
|
sudo apt-get install -y mysql-server mysql-client libmysqlclient-dev |
**Tendremos que apuntarnos bien la contraseña!
Ahora, por lo que veo y leo en este momento, GitLab necesita el comando sendmail para funcionar. Por ejemplo lo utilizará para enviar un email cuando hemos perdido la contraseña. Este comando lo podemos encontrar dentro de los paquetes exim4, postfix y sendmail. Pero por supuesto tan solo tenemos que tener uno de ellos instalado.
Yo instalare postfix. Así que primero comprobaré que no lo tenga ya instalado:
Vaya se me acaba de chivar que no tengo sendmail, que no encuentra el comando. Eso quiere decir que no lo tengo disponible y que por lo tanto procederé a instalar postfix.
|
|
sudo apt-get install postfix |
Aquí postfix nos pregunta una serie de cosas, ¿que tendremos que contestar?
- Tipo de configuración: Sólo correo local
- Nombre del sistema de correo: DEPINF01
**Nota: Donde pone «nombre del sistema de correo» pondremos lo que nosotros queramos. Damos este paso por finalizado.
Instalando Ruby 1.9
Gitlab necesita que tengamos instalado Ruby en su versión 1.9.3. En los repositorios de Debian no se encuentra la última versión de Ruby, pero en Ubuntu si, ahora procederemos a instalarlo de la siguiente forma:
|
|
sudo apt-get install ruby1.9.3 |
Actualización: Ahora viene si queremos instalarlo en Debian 6.0:
|
|
wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p194.tar.gz tar xzvf ruby-1.9.3-p194.tar.gz cd ruby-1.9.3-p194 ./configure make make install |
A mi, me ha instalado la versión 1.1.3 de bundler.
Instalando gitolite
Gitolite es una herramienta utilizada por GitLab. Esta herramienta maneja el acceso y el control sobre el repositorio git. Para utilizar esa herramienta tendremos que generar y registrar una serie de claves publicas ( keys public ). Una vez más podemos encontrar este paquete en repositorios.
|
|
sudo apt-get install gitolite |
**Nota: Paso actualizado 19NOV2012
Vamos a crear los usuarios que necesitamos para todo este tinglao… primero crearemos el usuario para git y luego el de gitlab… con los correspondientes grupos… así que vamos a fijarnos:
Creando usuario git:
|
|
sudo adduser \ --system \ --shell /bin/sh \ --gecos 'git version control' \ --group \ --disabled-password \ --home /home/git \ git |
Creando usuario GitLab:
|
|
sudo adduser --disabled-login --gecos 'gitlab system' gitlab |
Ahora añadimos git al grupo gitlab:
|
|
sudo usermod -a -G git gitlab |
Y ahora a la inversa…
|
|
sudo usermod -a -G gitlab git |
Ahora comprobamos que este creado:
|
|
sudo cat /etc/passwd | grep gitlab |
Ahora nos tendrá que aparecer algo parecido a esto:
|
|
gitolite:x:1004:1004::/home/gitlab:/bin/sh |
Si es así, es que el usuario se ha creado correctamente.
Ahora, tenemos que generar las llaves de acceso SSH, para ello introduciremos lo siguiente:
|
|
sudo -H -u gitlab ssh-keygen -q -N '' -t rsa -f /home/gitlab/.ssh/id_rsa |
Tan solo pulsaremos la tecla «Enter» siempre que se nos pregunte algo.
Vale, ahora tendremos que buscar y copiar la clave que hemos generado, para ello introduciremos lo siguiente:
|
|
sudo -u gitolite cat /var/lib/gitolite/.ssh/id_rsa.pub |
Ahora descargamos el código de GitoLite:
|
|
sudo -H -u git git clone -b gl-v304 https://github.com/gitlabhq/gitolite.git /home/git/gitolite |
Ahora vamos a proceder con la instalación
|
|
cd /home/git sudo -u git -H mkdir bin sudo -u git sh -c 'echo -e "PATH=\$PATH:/home/git/bin\nexport PATH" >> /home/git/.profile' sudo -u git sh -c 'gitolite/install -ln /home/git/bin' sudo cp /home/gitlab/.ssh/id_rsa.pub /home/git/gitlab.pub sudo chmod 0444 /home/git/gitlab.pub sudo -u git -H sh -c "PATH=/home/git/bin:$PATH; gitolite setup -pk /home/git/gitlab.pub" |
Permisos…
|
|
sudo chmod -R g+rwX /home/git/repositories/ sudo chown -R git:git /home/git/repositories/ |
Ahora procederemos a la comprobación de acceso a git…
|
|
# clone admin repo to add localhost to known_hosts # & be sure your user has access to gitolite sudo -u gitlab -H git clone git@localhost:gitolite-admin.git /tmp/gitolite-admin # if succeed you can remove it sudo rm -rf /tmp/gitolite-admin |
Si no da errores podemos continuar!… y si da errores… comentarlo o repetir los pasos! 😉
Instalar GitLab
Instalando dependencias:
Vamos a instalar las dependencias…
|
|
sudo gem install charlock_holmes --version '0.6.8' sudo pip install pygments sudo gem install bundler cd /home/gitlab |
Descargando GitLab:
Ahora si que nos tendremos que descargar el código fuente del programa ( versión «stable» ). Así que teclearemos lo siguiente en nuestra consola:
|
|
cd /home/gitlab sudo -H -u gitlab git clone -b stable https://github.com/gitlabhq/gitlabhq.git gitlab |
Configurándolo:
Ahora tendríamos que empezar a configurarlo, para ello primero configuraremos el acceso a la base de datos.
|
|
cd gitlab sudo -u gitlab cp config/database.yml.mysql config/database.yml nano config/database.yml.mysql config/database.yml |
Con el comando anterior se nos abrirá la aplicación «nano» para que podamos editar los campos correspondientes con la conexión a la base de datos como… el usuario y la contraseña… es bastante intuitivo así que no realizaré ninguna aclaración..
Ahora, vamos con la configuración general de GitLab.
|
|
sudo -u gitolite cp config/gitlab.yml.example config/gitlab.yml sudo -u gitolite nano config/gitlab.yml |
Aquí vamos a modificar lo siguiente:
- Email: En el campo «from» introduciremos la persona que envía el correo. Y en host el servidor.
- git_host: Editaremos «base_path» y «git_user«
Este sería el resultado:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
# Gitlab application config file # Email used for notification # about new issues, comments email: from: luigdima@localhost host: localhost # Protocol used for links in email letters # Value can be http or https protocol: http # or https # Git Hosting congiguration git_host: system: gitolite admin_uri: git@localhost:gitolite-admin base_path: /home/git/repositories/ host: localhost git_user: gitolite # port: 22 # Git settings # Use default values unless you understand it git: # Max size of git object like commit, in bytes # This value can be increased if you have a very large commits git_max_size: 5242880 # 5.megabytes # Git timeout to read commit, in seconds git_timeout: 10 |
Ahora modificamos los permisos para mejorar algo la seguridad:
|
|
sudo -u gitolite chmod o-rwx config/*.yml |
Instalando gemas y base de datos:
Vale ahora empezamos con la chicha, ya que vamos a empezar a instalar la base de datos y los módulos necesarios para el programa. Así que iremos paso por paso, primero ejecutaremos esto:
|
|
sudo -u gitlab -H bundle install --without development test sqlite postgres --deployment |
**Nota: Apartado oculto por la última actualización ( 19NOV2012 ):
Mostrar »
Vale, al ejecutar este último comando me ha aparecido un error, le falta un complemento. En especial el de la base de datos. Así que tendremos que instalarlo.
Solución: Complemento MySQL ( SOLO si realmente falla )
|
|
sudo apt-get install libmysql-cil-dev libmysql++-dev sudo apt-get install ruby-mysql sudo bundle install |
Nota de actualización: El paquete denominado «ruby-mysql» en Debian lo encontraremos como libmysql-ruby.
{ Faltaba una librería, exactamente no se cual, así que he instalado varias como se puede apreciar arriba }
Ahora me sale otro error con otra gema linguist ( Importante leer la nota ). Estoy buscando ahora una solución para ello.
{ Nota importante sobre el error! Este error tan solo me ha salido una de las dos veces que lo he instalado, quiero decir con ello, que la última vez que seguí este manual no me apareció el error }
Solución: Gema linguist
|
|
cd /tmp git clone <a href="https://github.com/ab5tract/linguist.git">https://github.com/ab5tract/linguist.gi</a>t cd linguist/ gem install rake -v '0.9.2.2' gem install blankslate -v '2.1.2.4' sudo bundle install gem build linguist.gemspec sudo gem install linguist-1.0.0.gem cd /opt/gitlabhq/ |
**Antes de seguir tenemos que asignarle una contraseña a nuestro MySQL si no lo teníamos antes. ( Tendremos que introducir la misma contraseña que hemos introducido más arriba con la configuración de gitolite ). Esto lo podemos realizar solo si no recordamos la contraseña o teníamos otra asignada… o simplemente el configurador de MySQL no se lanzó correctamente. Si ya has introducido una contraseña anteriormente en MySQL NO REALICES ESTOS PASOS, si no introduciremos esta serie de comandos:
|
|
sudo /etc/init.d/mysql stop sudo mysqld --skip-grant-tables & mysql -u root mysql UPDATE user SET Password=PASSWORD('TUCONTRASEÑA') WHERE User='root'; FLUSH PRIVILEGES; exit; |
Ahora procederemos a ejecutar los dos últimos comandos que nos queda para la instalación:
|
|
sudo -u gitolite bundle exec rake db:setup RAILS_ENV=production sudo -u gitolite bundle exec rake db:seed_fu RAILS_ENV=production |
Si todo va bien veremos como poco a poco va creando las tablas en la base de datos. Al finalizar con el último comando nos aparecerá «Administrator account created» tendremos que apuntar bien los datos ya que como podemos ver nos refleja el usuario y contraseña!
Instalando base de datos
Ahora vamos a realizar la instalación de la base de datos:
|
|
sudo -u gitlab bundle exec rake gitlab:app:setup RAILS_ENV=production |
Y… ahora los «hooks»:
|
|
sudo cp ./lib/hooks/post-receive /home/git/.gitolite/hooks/common/post-receive sudo chown git:git /home/git/.gitolite/hooks/common/post-receive |
Chequeando el estado
Para comprobar que todo está en orden ejecutaremos lo siguiente:
|
|
sudo -u gitlab bundle exec rake gitlab:app:status RAILS_ENV=production |
Nos tendría que mostrar lo siguiente:
|
|
Starting diagnostics config/database.yml............exists config/gitlab.yml............exists /home/git/repositories/............exists /home/git/repositories/ is writable?............YES remote: Counting objects: 12, done. remote: Compressing objects: 100% (8/8), done. Receiving objects: 100% (12/12), 1.14 KiB, done. Resolving deltas: 100% (1/1), done. remote: Total 12 (delta 1), reused 0 (delta 0) Can clone gitolite-admin?............YES UMASK for .gitolite.rc is 0007? ............YES /home/git/.gitolite/hooks/common/post-receive exists? ............YES Finished |
Si vemos que todo está en «YES» es que es bueno.
Iniciando GitLab
Ahora vamos a comprobar que todo funcione correctamente… para ello tenemos que ejecutar gitlab…
|
|
sudo -u gitlab bundle exec rails s -e production |
Vale, ya lo tenemos ejecutado que nos dice al ejecutar el comando?
Simplemente nos indicará donde nos tenemos que conectar… en mi caso… la dirección local con el puerto 3000
Nota importante: Si accedemos desde fuera tenemos que tener el puerto abierto!
Integrando GitLab con Apache2
Esto lo podéis ver en el artículo… GitLab en Apache
Referencia:
Cargando...
Debian • Git • GitLab • Ubuntu
