Cómo instalar GitLab en Ubuntu

GitLab es una potente plataforma DevOps de código abierto que proporciona herramientas de control de versiones, integración continua/entrega continua (CI/CD) y colaboración. La instalación de GitLab en Ubuntu le permite gestionar proyectos y colaborar con equipos de manera eficiente. Esta guía le guiará a través de la instalación de GitLab en un servidor Ubuntu

1. Actualiza los paquetes del sistema

Antes de comenzar la instalación, asegúrate de que los paquetes de tu sistema están actualizados

sudo apt update && sudo apt upgrade -y

2. Instala las dependencias necesarias

GitLab requiere algunos paquetes adicionales para funcionar correctamente. Instálelos ejecutando

sudo apt install -y curl openssh-server ca-certificates tzdata perl

3. Añadir el repositorio de GitLab

GitLab ofrece un repositorio oficial que simplifica el proceso de instalación. Para añadirlo, primero descarga el script de GitLab

curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

Este script configura el repositorio y te permite instalar GitLab directamente desde la fuente oficial de paquetes

4. Instalar GitLab

Ahora, instala GitLab Community Edition (CE). Sustituye https://gitlab.example.com por la URL deseada para acceder a tu instancia de GitLab

sudo EXTERNAL_URL=”https://gitlab.example.com” apt install gitlab-ce

Este comando instala GitLab y lo configura para utilizar la URL externa especificada. Si estás usando un servidor local, puedes sustituirla por la dirección IP de tu servidor

5. Configurar GitLab

Después de la instalación, configura GitLab utilizando el siguiente comando

sudo gitlab-ctl reconfigure

Este comando configura GitLab con los ajustes por defecto y genera todos los componentes necesarios, como bases de datos y servicios

6. Acceso a GitLab desde un navegador web

Una vez instalado y configurado GitLab, puedes acceder a él a través de la URL que hayas especificado (https://gitlab.example.com o la dirección IP de tu servidor). La primera vez que accedas a GitLab, se te pedirá que establezcas una contraseña de administrador. Después de establecer la contraseña, puedes iniciar sesión con

Nombre de usuario: root
Contraseña: (la contraseña que acabas de establecer)

7. Configuración de las notificaciones por correo electrónico de GitLab (opcional)

Si quieres que GitLab envíe notificaciones por correo electrónico, configura los ajustes de correo electrónico en el archivo de configuración de GitLab ubicado en /etc/gitlab/gitlab.rb. Ejemplo de configuración de correo electrónico

gitlab_rails[‘smtp_enable’] = true gitlab_rails[‘smtp_address’] = “smtp.yourmailprovider.com” gitlab_rails[‘smtp_port’] = 587 gitlab_rails[‘smtp_user_name’] = “your_email@example.com” gitlab_rails[‘smtp_password’] = “your_email_password” gitlab_rails[‘smtp_domain’] = “example.com” gitlab_rails[‘smtp_authentication’] = “login” gitlab_rails[‘smtp_enable_starttls_auto’] = true

Después de modificar el archivo de configuración, vuelve a configurar GitLab para aplicar los cambios

sudo gitlab-ctl reconfigure

8. Gestión de los servicios de GitLab

GitLab proporciona varios comandos para gestionar sus servicios

Iniciar GitLab
sudo gitlab-ctl start
Detener GitLab
sudo gitlab-ctl stop
Reiniciar GitLab
sudo gitlab-ctl restart
Comprobar el estado de GitLab
sudo gitlab-ctl status

9. Habilitar HTTPS (Opcional)

Para un acceso seguro, se recomienda habilitar HTTPS. Puedes usar Let’s Encrypt, un proveedor gratuito de certificados SSL, modificando /etc/gitlab/gitlab.rb. Añade la siguiente configuración

letsencrypt[‘enable’] = true letsencrypt[‘contact_emails’] = [‘you@example.com’] letsencrypt[‘auto_renew’] = true

Ejecuta el comando de reconfiguración después de guardar los cambios

sudo gitlab-ctl reconfigure

Esta configuración habilita HTTPS con renovación automática para tu certificado SSL

10. Configuración básica de GitLab

Tras la instalación, configure GitLab para su organización estableciendo grupos, proyectos y canalizaciones CI/CD según sea necesario. GitLab ofrece una interfaz web intuitiva para gestionar usuarios, crear repositorios y establecer permisos

Conclusión

La instalación de GitLab en Ubuntu es sencilla y proporciona una potente plataforma para DevOps, control de versiones y gestión de proyectos. Con GitLab en funcionamiento, puedes empezar a colaborar en proyectos, utilizando las sólidas características de GitLab para la gestión de código y CI/CD.