04.12.2024

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. Actualizar 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. Instale 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 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

Tras 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, puede 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 deseas 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

Tras 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
Reinicia GitLab:
sudo gitlab-ctl restart
Comprueba el estado de GitLab:
sudo gitlab-ctl status

9. Activación de HTTPS (opcional)

Para un acceso seguro, se recomienda habilitar HTTPS. Puedes utilizar Let’s Encrypt, un proveedor de certificados SSL gratuito, 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, configura GitLab para tu organización configurando 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.