Git https://www.carloscarrascal.com/ es Servidor de Git privado con Gogs https://www.carloscarrascal.com/blog/servidor-de-git-privado-con-gogs <article data-history-node-id="15" class="node node--type-blog-post node--view-mode-rss group-one-column ds-2col-stacked-fluid clearfix"> <div class="group-header"> <div class="field field--name-node-title field--type-ds field--label-hidden field--item"><h1> Servidor de Git privado con Gogs </h1> </div> <div class="field field--name-node-post-date field--type-ds field--label-hidden field--item">Domingo, Febrero 19, 2017 - 01:45</div> </div> <div class="group-left"> <div class="field field--name-field-tags field--type-entity-reference field--label-hidden field--items"> <div class="field--item"><a href="/tags/linux" hreflang="es">Linux</a></div> <div class="field--item"><a href="/tags/git" hreflang="es">Git</a></div> <div class="field--item"><a href="/tags/servicios" hreflang="es">Servicios</a></div> </div> <div class="field field--name-body field--type-text-with-summary field--label-hidden field--item"><p><img alt="Gogs logo" class="pull-right" data-entity-type="file" data-entity-uuid="afc7ad21-f5cb-4185-a329-4b3437bf7c27" src="/sites/default/files/inline-images/gogs_logo.png" />El único problema que tengo con GitHub es que en su versión gratuita todos los repos tienen que ser públicos. Si queremos tener repositorios privados tenemos que pasar por caja, y creo que son unos 7$ al mes, que me parece cojonudo, pero en mi caso necesito minimizar al máximo el coste de mis sistemas, principalmente porque no me da dinero.</p> <p>Así que estuve investigando que alternativas tenia para instalar un servidor de Git privado. Lo primero que me vino a la cabeza fue <a href="https://about.gitlab.com/">GitLab</a>, porque lo he utilizado durante una buena temporada en el trabajo con equipos relativamente grandes y nos ha dado muy buen resultado. En mi actual empresa estamos usando <a href="https://es.atlassian.com/software/bitbucket">Bitbucket</a> de Atlasian, y prácticamente es lo mismo que teníamos con GitLab, pero al ser de pago no es una opción para mi.</p> <p>Una vez decidido a instalar GitLab, el problema está cuando te pones a mirar los <a href="https://docs.gitlab.com/ce/install/requirements.html#hardware-requirements">requisitos</a>:</p> <ul> <li>4GB de RAM es lo recomendado.</li> <li>2GB de RAM + 2GB de swap, ya te dicen que va a ir como el culo</li> <li>Se necesitan varios GB de espacio en disco solo para la instalación de GitLab</li> </ul> <p>Demasiada caña para mi pobre servidor, y mas si pienso servir desde la misma máquina un par de sitios o algún otro servicio, necesitaba algo mas ligero pero que al menos molase (ya que estamos...).</p> <p>Así que después de dar algunas vueltas e investigar un poco, acabé encontrando Gogs:</p> <p><a href="https://gogs.io/">https://gogs.io/</a></p> <p>Según ellos mismos, Gogs es:</p> <blockquote> <p>Gogs is a painless self-hosted Git service.</p> </blockquote> <p>Que viene a ser un servicio de Git que te alojas tu mismo e indoloro.</p> <p>Y la verdad es que no ha sido nada doloroso, llevo ya varios meses usándolo y ha sido una gran opción, y es que fue muy sencillo de instalar, viene con un montón de funcionalidades de serie, y tiene una interfaz muy pulida y que es calcada a GitHub.</p> <p>Entre las funcionalidades interesantes:</p> <ul> <li>Open Source</li> <li>Ligero, muy ligero. Esta ocupando menos de 500Mb en disco (con las sus fuentes y las de Go) y aun no lo he visto sobrecargar la máquina.</li> <li>Gravatar (venga va...)</li> <li>Pull request, funcionan igual que Github</li> <li>Webhooks !! (esto ya es lo mas, pero no los he probado aún)</li> <li>Notificaciones por correo</li> <li>Soporta SSH, tanto para servir la aplicación como para los repos</li> <li>Tickets para incidencias, sencillo pero útil.</li> <li>Wiki para cada proyecto</li> <li>Creación de cuentas de usuario: Con registro o manual</li> <li>Permite desactivar el registro de usuarios</li> <li>Permite configurar repositorios privados</li> <li>Webhooks, espera esto ya lo había dicho, ¿no?</li> </ul> <p> </p> <h2>Instalación</h2> <p>La ayuda oficial para la instalación la podéis encontrar aquí (todo en inglés):</p> <ul> <li>Instalación desde fuentes: <a href="https://gogs.io/docs/installation/install_from_source">https://gogs.io/docs/installation/install_from_source</a></li> <li>Ejecución: <a href="https://gogs.io/docs/installation/configuration_and_run">https://gogs.io/docs/installation/configuration_and_run</a></li> <li>Instalación avanzada: <a href="https://gogs.io/docs/advanced/configuration_for_source_builds">https://gogs.io/docs/advanced/configuration_for_source_builds</a></li> <li>Instalación desde binarios: <a href="https://gogs.io/docs/installation/install_from_binary">https://gogs.io/docs/installation/install_from_binary</a></li> </ul> <p>La instalación oficial la están haciendo con Ngnix y postgresql. Yo lo monté tirando de un viejo Apache2 y MySQL que ya tenia corriendo. Voy a hacer una traducción de la instalación que son los pasos que yo he seguido, y luego pongo mis archivos de configuración. Y ojo, que estos pasos son para instalarlo desde el fuente, que es lo que hice yo.</p> <p>Lo que queremos hacer es:</p> <ul> <li>Servir ‘Gogs’ desde un dominio midominio.com, por ejemplo como git.midominio.com</li> <li>Apache2 como servidor web</li> <li>MySQL como servidor de base de datos</li> </ul> <p>Primero creamos un usuario para que corra la aplicación:</p> <pre> $ sudo adduser --disabled-login --gecos 'Gogs' git</pre> <h3>Descarga e instalación de Go</h3> <p>Vamos a instalar Go dentro del home del usuario que acabamos de crear para no interferir con ninguna otra versión de la distribución que usemos. Usaremos</p> <pre> /home/git/local/go</pre> <p>Creamos un directorio:</p> <pre> $ sudo su - git $ cd ~ $ mkdir local </pre> <p>Bajamos la versión disponible:</p> <pre> $ wget https://storage.googleapis.com/golang/go1.7.3.linux-amd64.tar.gz $ tar -C /home/git/local -xzf go1.7.3.linux-amd64.tar.gz</pre> <p>Añadimos unas cuantas rutas al fichero bashrc de nuestro usuario git:</p> <pre> $ sudo su - git $ cd ~ $ echo 'export GOROOT=$HOME/local/go' &gt;&gt; $HOME/.bashrc $ echo 'export GOPATH=$HOME/go' &gt;&gt; $HOME/.bashrc $ echo 'export PATH=$PATH:$GOROOT/bin:$GOPATH/bin' &gt;&gt; $HOME/.bashrc $ source $HOME/.bashrc</pre> <h3>Instalar Gogs</h3> <p>La forma rápida de instalar Gogs parece ser esta:</p> <pre> $ go get -u github.com/gogits/gogs $ cd $GOPATH/src/github.com/gogits/gogs $ go build</pre> <p>Y una vez compilado, podemos probarlo con:</p> <pre> $ cd $GOPATH/src/github.com/gogits/gogs $ ./gogs web</pre> <h2>Configuración</h2> <p>La configuración por defecto está en conf/app.ini pero no vamos a editar ese fichero. En lugar de eso Gogs nos permite crear una copia que será donde pondremos nuestras modificaciones. Primero vamos a crear unos directorios:</p> <pre> mkdir -p $GOPATH/src/github.com/gogits/gogs/custom/conf mkdir -p ~/gogs-repositories sudo mkdir -p /var/log/gogs sudo chown git:git /var/log/gogs</pre> <p>Hacemos una copia del fichero de configuración original, en donde haremos nuestros cambios:</p> <pre> cd $GOPATH/src/github.com/gogits/gogs cp conf/app.ini custom/conf/</pre> <p>En teoría en nuestro fichero de configuración 'custom' solamente deberíamos tener la configuración especifica que necesitemos. Es decir, que podemos borrar todo lo que se quede por defecto. La principal razón de esto es que cuando actualicemos la versión de Gogs, nuestra configuración no se modificará, ya que tienen un .gitignore para este fichero local. Este es el fichero que yo tengo:</p> <pre> ; Change it if you run locally RUN_USER = git ; Either "dev", "prod" or "test", default is "dev" RUN_MODE = prod [repository] ROOT = /home/git/gogs-repositories [server] PROTOCOL = http DOMAIN = git.midominio.com ROOT_URL = http://git.midominio.com/ HTTP_ADDR = 0.0.0.0 HTTP_PORT = 3000 [database] ; Either "mysql", "postgres" or "sqlite3", it's your choice DB_TYPE = mysql HOST = 127.0.0.1:3306 NAME = gogs USER = gogs PASSWD = **CONTRASEÑA** [admin] [security] INSTALL_LOCK = true ; !!CHANGE THIS TO KEEP YOUR USER DATA SAFE!! #@FDEWREWR&amp;*( SECRET_KEY = *KEY* ; Auto-login remember days LOGIN_REMEMBER_DAYS = 7 COOKIE_USERNAME = gogs_awesome COOKIE_REMEMBER_NAME = gogs_incredible ; Reverse proxy authentication header name of user name REVERSE_PROXY_AUTHENTICATION_USER = X-WEBAUTH-USER [service] ACTIVE_CODE_LIVE_MINUTES = 180 RESET_PASSWD_CODE_LIVE_MINUTES = 180 ; User need to confirm e-mail for registration REGISTER_EMAIL_CONFIRM = false ; Does not allow register and admin create account only DISABLE_REGISTRATION = true ; User must sign in to view anything. REQUIRE_SIGNIN_VIEW = false ; Mail notification ENABLE_NOTIFY_MAIL = false [log] ROOT_PATH = /home/git/go/src/github.com/gogits/gogs/log ; Either "console", "file", "conn", "smtp" or "database", default is "console" ; Use comma to separate multiple modes, e.g. "console, file" MODE = file ; Buffer length of channel, keep it as it is if you don't know what it is. BUFFER_LEN = 10000 ; Either "Trace", "Debug", "Info", "Warn", "Error", "Critical", default is "Trace" LEVEL = Info </pre> <p> </p> <h2>Configurar Apache2 con Gogs</h2> <p>Si quereis usar Nginx en lugar de Apache, la ayuda oficial tiene la info <a href="https://gogs.io/docs/advanced/configuration_for_source_builds#setting-up-nginx-sever">necesaria</a>. En Debian podemos instalar Apache2 si no lo tenemos ya:</p> <pre> sudo apt-get install apache2</pre> <p>La instalación de Gogs que acabamos de hacer corre en el puerto 3000 por defecto. Lo que queremos hacer es utilizar un servidor web como proxy para poder servir Gogs desde el puerto 80, como un subdominio de nuestro dominio, por ejemplo en este caso:</p> <pre> http://git.midominio.com</pre> <p>La mejor forma de hacer esto es crear un fichero de configuración para hacer un VirtualHost y usar mod_proxy para poder servir Gogs en el puerto 80 con Apache.</p> <pre> vi /etc/apache2/sites-available/080-gogs.conf</pre> <p>El contenido del fichero puede ser tan simple como esto:</p> <pre> &lt;VirtualHost *:80&gt; ServerName git.midominio.com ProxyPreserveHost On ProxyPass / http://localhost:3000/ ProxyPassReverse / http://localhost:3000/ ErrorLog ${APACHE_LOG_DIR}/gogs-error.log CustomLog ${APACHE_LOG_DIR}/gogs-access.log combined &lt;/VirtualHost&gt;</pre> <p>El nombre del dominio que usemos aqui será el mismo que pondremos en la configuración de Gogs. Aún tenemos que activar este VirtualHost:</p> <pre> ln -s /etc/apache2/sites-available/080-gogs.conf /etc/apache2/sites-enabled/</pre> <p>Ahora activaremos el módulo mod_proxy de Apache. Podemos probar con a2enmod:</p> <pre> $ sudo a2enmod proxy</pre> <p>Esto debería crear los dos ficheros necesarios dentro de <em>/etc/apache2/mods-enabled/ : proxy.conf y proxy.load</em></p> <p>Reiniciar Apache y a correr. Con suerte no tendreis ningún error.</p> <pre> $ sudo service apache2 restart</pre> <p> </p> <h2>Configurar MySQL</h2> <p>No voy a entrar en detalles sobre la configuración inicial de MySQL, porque eso daría para un libro entero. En principio bastará con crear una base de datos nueva y asignar todos los permisos a un usuario para Gogs:</p> <pre> CREATE DATABASE gogs CHARACTER SET utf8 COLLATE utf8_general_ci; GRANT ALL PRIVILEGES ON gogs.* To 'gogs'@'localhost' IDENTIFIED BY 'password';</pre> <p>Lo suyo sería ahora verificar la conexión a la nueva base de datos para estar seguros de que funciona correctamente, por ejemplo, desde la linea de comandos:</p> <pre> mysql --user=gogs --password=password --host=localhost gogs</pre> <p> </p> <h2>Ejecutar el instalador</h2> <p>Llegado este punto deberíamos tener todo lo necesario para arrancar el dichoso Gogs. Lo arrancamos manualmente con:</p> <pre> $ cd $GOPATH/src/github.com/gogits/gogs $ ./gogs web</pre> <p>Si ahora usamos un navegador para acceder a la dirección que hayamos configurado en nuestro Apache, deberiamos acceder a la primera pantalla del instalador, que nos guiará por la configuración básica. En nuestro ejemplo seria:</p> <pre> http://git.midominio.com</pre> <p> </p> <h2>Añadir Gogs a init.d</h2> <p>Llegados a este punto todo deberia estar funcionando, sin embargo necesitamos arrancar Gogs a mano. Lo que necesitamos es poder levantar y parar Gogs como un servicio mas de nuestra máquina, y además, que este arranque automaticamente al levantar o reiniciar el servidor.</p> <p>Para esto los chavales de Gogs nos han preparado una plantilla que nos facilitará mucho las cosas (para Debian / Ubuntu). Esta aqui:</p> <pre> $GOPATH/src/github.com/gogits/gogs/scripts/init/debian/gogs</pre> <p>La copiamos al directorio de init.d:</p> <pre> $ sudo cp $GOPATH/src/github.com/gogits/gogs/scripts/init/debian/gogs /etc/init.d/gogs</pre> <p>Y ahora modificamos un par de cosas. Editaremos las dos primeras lineas:</p> <pre> # Required-Start: $syslog $network # Required-Stop: $syslog </pre> <p>De esta manera</p> <pre> # Required-Start: $syslog $network $local_fs apache2 mysql # Required-Stop: $syslog $local_fs </pre> <p>Y nos aseguramos de que la variable WORKINGDIR apunte al directorio correcto:</p> <pre> WORKINGDIR=/home/git/go/src/github.com/gogits/gogs</pre> <p>El script necesita permisos de ejecución, y lo añadimos a la configuración de inicio:</p> <pre> $ sudo chmod ug+x /etc/init.d/gogs $ sudo update-rc.d gogs defaults 30 70 </pre> <p>Ahora podemos probar nuestra configuración y levantar el servicio gogs:</p> <pre> $ sudo service gogs start</pre> <p>Y conectar con un navegador a la URL que hemos configurado</p> <pre> http://git.midominio.com</pre> <p>Listo, espero que disfrutéis tanto como yo montando este pollo. Ahora ya nadie podrá ver los WTF que tenéis en vuestro código.</p> <p> </p> <p> </p> </div> </div> <div class="group-footer"> <section> <h2>Añadir nuevo comentario</h2> <drupal-render-placeholder callback="comment.lazy_builders:renderForm" arguments="0=node&amp;1=15&amp;2=comment&amp;3=comment" token="EQr7U62Ohq-jqYwGuQE5z60d5XQ-npXesPuXroqMZ3M"></drupal-render-placeholder> </section> </div> </article> Sun, 19 Feb 2017 00:45:21 +0000 root 15 at https://www.carloscarrascal.com