Cómo Resetear la Contraseña del Usuario root en GitLab

En entornos de desarrollo y producción donde se utiliza GitLab como plataforma de control de versiones y DevOps, puede ocurrir que se pierda el acceso a la cuenta root o sea necesario restablecer su contraseña. Afortunadamente, GitLab proporciona una tarea Rake que permite realizar esta operación de forma sencilla y segura desde el sistema donde está instalado.

A continuación, te explicamos paso a paso cómo resetear la contraseña del usuario root en una instalación de GitLab CE.

Requisitos Previos

• Acceso al servidor donde está instalado GitLab.
• Privilegios de superusuario (root) o acceso con sudo.
• GitLab debe estar instalado como paquete Omnibus (el método más común en instalaciones on-premise).

Pasos para Resetear la Contraseña de root

1. Accede al servidor: Conéctate por SSH o accede físicamente al servidor donde está instalado GitLab:
   ssh usuario@mi-servidor-gitlab
2. Ejecuta la tarea Rake de reseteo: Ejecuta el siguiente comando para iniciar el proceso de cambio de contraseña:
   sudo gitlab-rake "gitlab:password:reset"
3. Introduce el nombre de usuario: El sistema te pedirá el nombre de usuario al que deseas cambiar la contraseña. En este caso, escribe:
   root
4. Escribe la nueva contraseña: A continuación, se te solicitará la nueva contraseña. Escríbela cuidadosamente y presiona Enter.
5. Confirmación: Si todo ha ido bien, verás un mensaje indicando que la contraseña ha sido actualizada con éxito.

Validación

Una vez cambiada la contraseña, abre tu navegador y accede a la URL de tu instancia de GitLab. Inicia sesión con el usuario root y la nueva contraseña para verificar que los cambios se han aplicado correctamente.

Notas Adicionales

• Si el comando gitlab-rake no está disponible, asegúrate de que GitLab está correctamente instalado y que estás en el servidor correcto.
• Para ver todas las tareas Rake disponibles, puedes ejecutar:
  sudo gitlab-rake --tasks
• Este procedimiento solo resetea la contraseña del usuario, no afecta configuraciones ni repositorios.

Recomendaciones de Seguridad

• Una vez recuperado el acceso, considera desactivar el acceso de root si no es estrictamente necesario.
• Utiliza cuentas de administrador personalizadas y habilita autenticación de dos factores (2FA).
• Realiza auditorías periódicas sobre las cuentas con privilegios elevados en GitLab.