Presentación de GitLab
GitLab es una plataforma DevOps que reúne en una sola aplicación el alojamiento de repositorios Git, las merge requests, el seguimiento de incidencias, el registro de paquetes y la integración continua (CI/CD). La edición Community (CE) es de código abierto. Encaja con equipos de desarrollo, agencias y pequeñas empresas que quieren mantener su código y sus pipelines en un servidor bajo su control.
Al entregar el servidor, el VPS Linux (Debian 12 o 13, Ubuntu 20.04, 22.04 o 24.04) incluye GitLab CE instalado desde el repositorio oficial packages.gitlab.com, mediante el paquete Omnibus. Se genera un certificado TLS autofirmado, válido durante 10 años, para la dirección IP pública del servidor. La URL externa queda configurada como https://SERVER_IP y el tráfico HTTP se redirige a HTTPS.
La cuenta de administración es root y su contraseña inicial se guarda en /etc/gitlab/initial_root_password. La receta exige al menos 4 GB de RAM (se recomiendan 8 GB) y 2 núcleos de CPU: GitLab consume bastantes recursos, así que dimensiona el VPS en consecuencia.
Lo que puede hacer con GitLab
Instalación Omnibus oficial
GitLab CE se instala desde el repositorio apt de GitLab y se configura con
gitlab-ctl reconfigure. Las actualizaciones posteriores se hacen con apt.HTTPS desde la entrega
Se crea un certificado autofirmado RSA 2048 en
/etc/gitlab/ssl/para la IP del servidor. Nginx redirige el HTTP a HTTPS.Contraseña root generada
La contraseña inicial de la cuenta
rootse guarda en/etc/gitlab/initial_root_password, sin ningún valor por defecto conocido.Repositorios, revisiones y CI/CD
Merge requests, incidencias, wikis, registro de paquetes y pipelines CI/CD conviven en la misma interfaz, sin herramientas de terceros que conectar.
Configuración en un solo archivo
Todo el ajuste se hace en
/etc/gitlab/gitlab.rb, seguido de ungitlab-ctl reconfigure. Es fácil de versionar y de reproducir.
Empezar con GitLab
Del pedido a la puesta en producción en pocos minutos.
- 1
Pide el VPS con GitLab
Elige un [VPS Linux](/vps-linux) en París o Fráncfort con al menos 4 GB de RAM (se recomiendan 8 GB). En la pestaña «Aplicaciones» del formulario de pedido, marca GitLab.
- 2
Espera la entrega y conéctate
La instalación y la primera configuración tardan varios minutos tras el arranque. Síguelas por SSH y, cuando terminen, consulta la contraseña de root.
Bashssh root@SERVER_IP tail -f /var/log/cloud-init-output.log sudo cat /etc/gitlab/initial_root_password - 3
Abre GitLab e inicia sesión
Entra en https://SERVER_IP y acepta la advertencia del navegador, causada por el certificado autofirmado. Inicia sesión con
rooty la contraseña que acabas de leer, y cámbiala después desde tu perfil.Bashsudo gitlab-ctl status - 4
Protege el servidor para producción
Apunta un nombre de dominio al servidor y sustituye
external_urlen/etc/gitlab/gitlab.rbporhttps://YOUR_DOMAIN. Activa Let's Encrypt (letsencrypt['enable'] = true) o instala tu propio certificado y aplica la configuración. Limita el acceso con un cortafuegos (puertos 22, 80 y 443) y programa copias de seguridad.Bashsudo nano /etc/gitlab/gitlab.rb sudo gitlab-ctl reconfigure sudo gitlab-backup create
Casos de uso de GitLab
Forja Git privada para un equipo
Aloja el código fuente de tus proyectos en un servidor europeo que administras tú, con permisos por grupo y por proyecto.
Pipelines CI/CD internos
Ejecuta tus pruebas y despliegues a partir de archivos
.gitlab-ci.ymlversionados junto al código, en tus propios runners.Migración desde un servicio alojado
Importa tus repositorios desde GitHub u otro GitLab para recuperar el control de tus datos y de tus reglas de acceso.
Entorno de aprendizaje y pruebas
Prueba la configuración de GitLab, las copias de seguridad o una actualización de versión en un servidor aparte antes de tocar producción.
Preguntas frecuentes sobre GitLab
La receta indica 4 GB como mínimo y 8 GB recomendados, con al menos 2 núcleos de CPU. Por debajo de eso, la instalación puede fallar o la interfaz volverse muy lenta. Si vas a usar CI/CD con regularidad, cuenta con 8 GB.
Más sobre GitLab
Sustituir el certificado autofirmado
El certificado incluido está vinculado a la dirección IP, por lo que los navegadores muestran una advertencia. Para eliminarla, usa un nombre de dominio (consulta /web-domains) y edita /etc/gitlab/gitlab.rb:
Rubyexternal_url 'https://YOUR_DOMAIN' letsencrypt['enable'] = true letsencrypt['contact_emails'] = ['admin@YOUR_DOMAIN']
A continuación ejecuta sudo gitlab-ctl reconfigure. El dominio ya debe apuntar al servidor, y los puertos 80 y 443 tienen que estar accesibles para la validación.
Recursos y memoria
GitLab lanza varios servicios (Puma, Sidekiq, PostgreSQL, Redis, Nginx, Gitaly). Con 4 GB de RAM la instancia funciona para un equipo pequeño, pero conviene añadir swap y dejar algo de margen. Pasa a 8 GB en cuanto tengas pipelines frecuentes o varias decenas de usuarios.
Copias de seguridad y actualizaciones
El comando sudo gitlab-backup create genera un archivo con los datos de la aplicación. Haz también copia de /etc/gitlab/gitlab.rb y de /etc/gitlab/gitlab-secrets.json, que no se incluyen en ese archivo. Para actualizar, usa sudo apt update && sudo apt install gitlab-ce. Antes, lee la ruta de actualización oficial, porque GitLab a veces exige pasar por versiones intermedias.
