Cómo instalar y configurar redmine en ubuntu 18.04

Redmine es una de las herramientas de software de gestión de proyectos y seguimiento de problemas de código abierto más populares. Es multiplataforma y base de datos cruzada y está construido sobre el marco de Ruby on Rails.

Redmine incluye soporte para múltiples proyectos, wikis, sistema de seguimiento de problemas, foros, calendarios, notificaciones por correo electrónico y mucho más.

Este tutorial describe cómo instalar y configurar la última versión de Redmine en un servidor Ubuntu 18.04 usando MySQL como back-end de la base de datos y Passenger + Nginx como un servidor de aplicaciones Ruby.

Prerrequisitos

Asegúrese de cumplir con los siguientes requisitos previos antes de continuar con este tutorial:

• Tiene un nombre de dominio que apunta a la IP pública de su servidor. En este tutorial usaremos example.com . example.com iniciado sesión como usuario con privilegios de sudo. Tiene instalado Nginx siguiendo estas instrucciones. Tiene un certificado SSL instalado para su dominio. Puede instalar un certificado SSL Let's Encrypt gratuito siguiendo estas instrucciones.

Crear una base de datos MySQL

Redmine es compatible con MySQL / MariaDB, Microsoft SQL Server, SQLite 3 y PostgreSQL. En este tutorial usaremos MySQL como una base de datos.

Inicie sesión en el shell de MySQL escribiendo el siguiente comando:

sudo mysql

Desde el shell de MySQL, ejecute la siguiente instrucción SQL para crear una nueva base de datos:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

A continuación, cree una cuenta de usuario MySQL y otorgue acceso a la base de datos:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Asegúrese de cambiar change-with-strong-password con una contraseña segura.

Una vez hecho esto, salga de la consola mysql escribiendo:

EXIT;

Instalando Ruby

La forma más fácil de instalar Ruby en su sistema Ubuntu es a través del administrador de paquetes apt . Al momento de escribir, la versión en los repositorios de Ubuntu es 2.5.1, que es la última versión estable de Ruby.

Instala Ruby escribiendo:

sudo apt install ruby-full

Instalando Passenger y Nginx

Passenger es un servidor de aplicaciones web rápido y liviano para Ruby, Node.js y Python que se puede integrar con Apache y Nginx. Instalaremos Passenger como un módulo Nginx.

Asegúrese de seguir los requisitos previos y de instalar Nginx antes de continuar con los siguientes pasos.

Comience instalando los paquetes necesarios:

sudo apt install dirmngr gnupg apt-transport-https ca-certificates

Importe la clave GPG del repositorio y habilite el repositorio Phusionpassenger:

sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 561F9B9CAC40B2F7 sudo add-apt-repository 'deb https://oss-binaries.phusionpassenger.com/apt/passenger bionic main'

Una vez que el repositorio de apt esté habilitado, actualice la lista de paquetes e instale el módulo Passenger Nginx con:

sudo apt update sudo apt install libnginx-mod-http-passenger

Instalar Redmine en Ubuntu

Comenzaremos instalando las dependencias necesarias para construir Redmine:

sudo apt install build-essential libmysqlclient-dev imagemagick libmagickwand-dev

Al momento de escribir este artículo, la última versión estable de Redmine es la versión 4.0.0.

Antes de continuar con el siguiente paso, debe consultar la página de descarga de Redmine para ver si hay una versión más nueva disponible.

1. Descargando Redmine

Descargue el archivo Redmine con el siguiente comando curl:

sudo curl -L http://www.redmine.org/releases/redmine-4.0.0.tar.gz -o /tmp/redmine.tar.gz

Una vez que se complete la descarga, extraiga el archivo y muévalo al directorio /opt :

cd /tmp sudo tar zxf /tmp/redmine.tar.gz sudo mv /tmp/redmine-4.0.0 /opt/redmine

2. Configuración de la base de datos Redmine

Comience copiando el archivo de configuración de ejemplo de Redmine:

sudo cp /opt/redmine/config/database.yml.example /opt/redmine/config/database.yml

Abra el archivo con su editor de texto:

sudo nano /opt/redmine/config/database.yml

Busque la sección de production e ingrese la base de datos MySQL y la información del usuario que creamos anteriormente:

/opt/redmine/config/database.yml

production: adapter: mysql2 database: redmine host: localhost username: redmine password: "change-with-strong-password" encoding: utf8

Una vez hecho esto, guarde el archivo y salga del editor.

3. Instalar dependencias de Ruby

Vaya al directorio de redmine e instale el paquete y otras dependencias de Ruby:

cd /opt/redmine/ sudo gem install bundler --no-rdoc --no-ri sudo bundle install --without development test postgresql sqlite

4. Generar claves y migrar la base de datos

Ejecute el siguiente comando para generar claves y migrar la base de datos:

cd /opt/redmine/ sudo bundle exec rake generate_secret_token sudo RAILS_ENV=production bundle exec rake db:migrate

5. Establezca los permisos correctos

Nginx se ejecuta como usuario y grupo www-data . Establezca los permisos correctos emitiendo el siguiente comando chown:

sudo chown -R www-data: /opt/redmine/

Configurar Nginx

En este momento, ya debería tener instalado Nginx con certificado SSL en su sistema, si no, consulte los requisitos previos para este tutorial.

Abra su editor de texto y cree el siguiente archivo de bloqueo del servidor Nginx:

sudo nano /etc/nginx/sites-available/example.com /etc/nginx/sites-available/example.com

# Redirect HTTP -> HTTPS server { listen 80; server_name www.example.com example.com; include snippets/letsencrypt.conf; return 301 https://example.com$request_uri; } # Redirect WWW -> NON WWW server { listen 443 ssl http2; server_name www.example.com; ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; include snippets/ssl.conf; return 301 https://example.com$request_uri; } server { listen 443 ssl http2; server_name example.com; root /opt/redmine/public; # SSL parameters ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; include snippets/ssl.conf; include snippets/letsencrypt.conf; # log files access_log /var/log/nginx/example.com.access.log; error_log /var/log/nginx/example.com.error.log; passenger_enabled on; passenger_min_instances 1; client_max_body_size 10m; } No olvide reemplazar example.com con su dominio de Redmine y establecer la ruta correcta a los archivos de certificado SSL. Todas las solicitudes HTTP serán redirigidas a HTTPS. Los fragmentos utilizados en esta configuración se crean en esta guía.

Habilite el bloqueo del servidor creando un enlace simbólico al directorio sites-enabled para sites-enabled :

sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/

Antes de reiniciar el servicio Nginx, realice una prueba para asegurarse de que no haya errores de sintaxis:

sudo nginx -t

Si no hay errores, la salida debería verse así:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful

Finalmente, reinicie el servicio Nginx escribiendo:

sudo systemctl restart nginx

Accediendo a Redmine

Abra su navegador, escriba su dominio y suponiendo que la instalación sea exitosa, aparecerá una pantalla similar a la siguiente:

Una vez que cambie la contraseña, será redirigido a la página de la cuenta de usuario.

Conclusión

Ha instalado correctamente Redmine en su sistema Ubuntu. Ahora debe consultar la documentación de Redmine y obtener más información sobre cómo configurar y usar Redmine.

ubuntu redmine ruby ​​mysql nginx