Cómo instalar Redmine en CentOS 7

• Prerrequisitos
• Instalar Apache
• Instalar PostgreSQL
• Instalar Ruby
• Instalar pasajero
• Instalar Redmine
• Configurar Apache
• Asegurando Apache con Let's Encrypt SSL

Redmine es una herramienta de gestión de proyectos basada en web gratuita y de código abierto. Está escrito en Ruby on Rails y admite múltiples servidores de bases de datos para almacenar la base de datos. Es una aplicación rica en funciones que admite múltiples proyectos, ACL basada en roles y sistema de seguimiento de problemas. También tiene soporte para gráficos y calendarios de Gantt, gestión de archivos, wiki y foro por proyecto, así como muchas otras características. Admite sistemas de control de versiones como Git, SVN o CVS. También es multilingüe y admite hasta 49 idiomas.

Esta guía fue escrita para Redmine 3.4.4, pero también puede aplicarse a versiones más recientes.

Prerrequisitos

• Una instancia de servidor Vultr CentOS 7.
• Un usuario de sudo .
• Un nombre de dominio apuntado hacia el servidor.

Para este tutorial, lo utilizaremos 192.168.1.1como la dirección IP pública y redmine.example.comcomo el nombre de dominio que apunta hacia la instancia de Vultr. Asegúrese de reemplazar todas las apariciones del nombre de dominio de ejemplo y la dirección IP con la actual.

Actualice su sistema base utilizando la guía Cómo actualizar CentOS 7 . Una vez que su sistema ha sido actualizado, proceda a instalar las dependencias.

Instalar Apache

Redmine está escrito en Ruby on Rails, por lo que necesitaremos que Phusion Passenger se integre con el servidor web Apache para servir la aplicación. Instala Apache.

sudo yum -y install httpd httpd-devel libcurl-devel

Para construir la aplicación Redmine, también necesitaremos algunas herramientas de desarrollo. Instale las herramientas requeridas.

sudo yum -y install ImageMagick ImageMagick-devel git libxml2-devel libxslt-devel gcc bzip2 openssl-devel zlib-devel gdbm-devel ncurses-devel autoconf automake bison gcc-c++ libffi-devel libtool patch readline-devel sqlite-devel glibc-headers glibc-devel libyaml-devel libicu-devel libidn-devel

Instalar PostgreSQL

Redmine admite múltiples tipos de servidores de bases de datos como MySQL, PostgreSQL y MSSQL. En este tutorial, utilizaremos PostgreSQL para alojar el servidor de base de datos Redmine.

PostgreSQL es un sistema de base de datos relacional de objetos. El yumrepositorio predeterminado contiene una versión anterior de PostgreSQL, por lo tanto, agregue el repositorio PostgreSQL al sistema.

sudo yum -y install https://download.postgresql.org/pub/repos/yum/10/redhat/rhel-7-x86_64/pgdg-centos10-10-1.noarch.rpm

Instale el servidor de base de datos PostgreSQL.

sudo yum -y install postgresql10-server postgresql10-contrib postgresql10 

Inicializar la base de datos.

sudo /usr/pgsql-10/bin/postgresql-10-setup initdb

Inicie el servidor PostgreSQL y permita que se inicie automáticamente en el momento del arranque.

sudo systemctl start postgresql-10
sudo systemctl enable postgresql-10

Cambie la contraseña para el usuario predeterminado de PostgreSQL.

sudo passwd postgres

Inicie sesión como usuario de PostgreSQL.

sudo su - postgres

Cree un nuevo usuario de PostgreSQL para Redmine.

createuser redmine

Puede usar cualquier nombre de usuario en lugar de redmine. PostgreSQL proporciona el psqlshell para ejecutar consultas en la base de datos. Cambie al shell PostgreSQL.

psql

Establezca una contraseña para el usuario recién creado para la base de datos de Redmine.

ALTER USER redmine WITH ENCRYPTED password 'DBPassword';

Reemplazar DBPasswordcon una contraseña segura. Cree una nueva base de datos para la instalación de Redmine.

CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;

Salga de la psqlcáscara.

\q

Cambiar al sudousuario.

exit

Edite el pg_hba.confarchivo para habilitar la autenticación basada en MD5.

sudo nano /var/lib/pgsql/10/data/pg_hba.conf

Encuentre las siguientes líneas y cambie los valores peery identen la METHODcolumna a trusty md5, respectivamente.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     peer
# IPv4 local connections:
host    all             all             127.0.0.1/32            ident
# IPv6 local connections:
host    all             all             ::1/128                 ident

Una vez actualizada, la configuración debería verse así.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     trust
# IPv4 local connections:
host    all             all             127.0.0.1/32            md5
# IPv6 local connections:
host    all             all             ::1/128                 md5

Reinicie PostgreSQL para que los cambios surtan efecto.

sudo systemctl restart postgresql-10

Instale algunas dependencias PostgreSQL más requeridas.

sudo yum -y install libpqxx-devel protobuf-devel

Instalar Ruby

Se recomienda utilizar un usuario sin privilegios para ejecutar la aplicación y mantenerla aislada del resto del sistema. Cree un nuevo usuario para Redmine y cambie al usuario recién creado.

sudo adduser redmine
sudo su - redmine

Instalaremos la última versión de Ruby usando Ruby Version Manager, o RVM. Se utiliza para instalar y administrar múltiples versiones de Ruby.

Agregue la clave GPG de RVM a su servidor.

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

Instalar RVM.

curl -sSL https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm

Obtenga la lista de las versiones disponibles de Ruby.

rvm list known

Verá una larga lista de versiones de Ruby.

[redmine@vultr ~]$ rvm list known
# MRI Rubies

[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.7]
[ruby-]2.3[.4]
[ruby-]2.4[.1]
ruby-head

...

Instale la última versión de Ruby de la lista.

rvm install 2.4

Use la versión instalada de Ruby.

rvm use 2.4

Puedes verificar su versión.

ruby -v

Verá una salida similar.

[redmine@vultr ~]$ ruby -v
ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-linux]

Instale bundler, que es el administrador de dependencias para la aplicación Ruby.

gem install bundler

Ruby ya está instalado. Antes de instalar Redmine, necesitaremos instalar Phusion Passenger.

Instalar pasajero

Ejecute el siguiente comando para instalar Passenger.

gem install passenger

Proporcione permiso de ejecución al directorio de inicio del redmineusuario. El pasajero necesita ejecutar los archivos binarios para servir la aplicación.

chmod o+x "/home/redmine"

Instale el módulo Apache para Pasajero.

passenger-install-apache2-module

El script de instalación le hará algunas preguntas. Primero, le proporcionará información sobre el proceso de instalación. Luego le pedirá que seleccione el idioma que usará. Como nuestra aplicación está escrita en Ruby on Rails, seleccione Ruby en el menú y presione " Enter" para continuar.

Which languages are you interested in?

Use <space> to select.
If the menu doesn't display correctly, press '!'

 ‣ ⬢  Ruby
   ⬡  Python
   ⬡  Node.js
   ⬡  Meteor

El instalador ahora verificará los requisitos. El instalador no encontrará dependencias faltantes y automáticamente procederá a compilar e instalar el módulo.

Una vez que el módulo está instalado, le pedirá que agregue el módulo al archivo de configuración de Apache.

Almost there!

Please edit your Apache configuration file, and add these lines:

   LoadModule passenger_module /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12/buildout/apache2/mod_passenger.so
   <IfModule mod_passenger.c>
     PassengerRoot /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12
     PassengerDefaultRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
   </IfModule>

After you restart Apache, you are ready to deploy any number of web
applications on Apache, with a minimum amount of configuration!

Press ENTER when you are done editing.

Omitiremos esto por ahora y lo completaremos más adelante en el tutorial ya que el usuario con el que hemos iniciado sesión ahora no tiene sudopermisos. Presione " Enter" para omitir este paso.

Finalmente, el script del instalador validará la instalación y verá una advertencia que dice que el módulo Passenger no está especificado en la configuración de Apache.

Validating installation...

 * Checking whether this Passenger install is in PATH... ✓
 * Checking whether there are no other Passenger installations... ✓
 * Checking whether Apache is installed... ✓
 * Checking whether the Passenger module is correctly configured in Apache... (!)

   You did not specify 'LoadModule passenger_module' in any of your Apache
   configuration files. Please paste the configuration snippet that this
   installer printed earlier, into one of your Apache configuration files, such
   as /etc/httpd/conf/httpd.conf.


Detected 0 error(s), 1 warning(s).
Press ENTER to continue.

Ahora que hemos instalado el módulo Passenger para Apache, proceda a descargar e instalar Redmine.

Instalar Redmine

Descargue la última versión de Redmine desde la página oficial de descargas de Redmine .

cd ~
wget http://www.redmine.org/releases/redmine-3.4.4.tar.gz

Extraiga el archivo y cambie el nombre del directorio por conveniencia.

tar -xf redmine-*.tar.gz
mv redmine-*/ redmine/

Copie los archivos de configuración de ejemplo en su ubicación de producción.

cd redmine
cp config/configuration.yml.example config/configuration.yml
cp config/database.yml.example config/database.yml

Abra el archivo de configuración de la base de datos que acabamos de copiar para ingresar los detalles de la base de datos.

nano config/database.yml

Por defecto, el archivo de la base de datos está configurado para MySQL. Encuentre las configuraciones para producción y desarrollo, y pruebe cuál usa el adaptador MySQL. Comente todas estas líneas.

#production:
#  adapter: mysql2
#  database: redmine
#  host: localhost
#  username: root
#  password: ""
#  encoding: utf8

#development:
#  adapter: mysql2
#  database: redmine_development
#  host: localhost
#  username: root
#  password: ""
#  encoding: utf8

#test:
#  adapter: mysql2
#  database: redmine_test
#  host: localhost
#  username: root
#  password: ""
#  encoding: utf8

Además, encuentre las líneas que se comentan, que tienen productionconfiguración para el postgresqladaptador. Descomente esas líneas y actualice el nombre de la base de datos y las credenciales de usuario. Asegúrese de usar la sangría correcta, que son dos espacios.

production:
  adapter: postgresql
  database: redmine
  host: localhost
  username: redmine
  password: "DBPassword"

Configure la aplicación para usar la configuración de PostgreSQL.

bundle config build.pg --with-pg-config=/usr/pgsql-10/bin/pg_config

Instale las dependencias de la aplicación requeridas por la aplicación.

bundle install --without development test

Verá el siguiente mensaje al final de la instalación.

Installing roadie-rails 1.1.1
Bundle complete! 31 Gemfile dependencies, 55 gems now installed.
Gems in the groups development and test were not installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.

El siguiente comando genera tokens secretos que se utilizan para codificar los datos de la sesión.

bundle exec rake generate_secret_token

Escriba la base de datos PostgreSQL.

RAILS_ENV=production bundle exec rake db:migrate

Ejecute el siguiente comando, que escribe los datos predeterminados en la base de datos PostgreSQL.

RAILS_ENV=production bundle exec rake redmine:load_default_data

El comando anterior le pedirá que elija el idioma predeterminado que se utilizará con la aplicación. La opción predeterminada es inglés; elija de acuerdo a su preferencia.

[redmine@vultr redmine]$ RAILS_ENV=production bundle exec rake redmine:load_default_data

Select language: ar, az, bg, bs, ca, cs, da, de, el, en, en-GB, es, es-PA, et, eu, fa, fi, fr, gl, he, hr, hu, id, it, ja, ko, lt, lv, mk, mn, nl, no, pl, pt, pt-BR, ro, ru, sk, sl, sq, sr, sr-YU, sv, th, tr, uk, vi, zh, zh-TW [en]
====================================
Default configuration data loaded.

La instalación de la aplicación Redmine ya ha finalizado. Cambiar la propiedad y los permisos de los directorios y archivos.

mkdir -p tmp tmp/pdf public/plugin_assets
chown -R redmine:redmine files log tmp public/plugin_assets
chmod -R 755 files log tmp public/plugin_assets

Hemos configurado todo lo que necesitamos del usuario sin privilegios. Vuelva al sudousuario ejecutándose su - <username>.

Configurar Apache

Agregue el módulo de Pasajero para Apache en el archivo de configuración de Apache. Esto cargará automáticamente el módulo Pasajero.

echo "LoadModule passenger_module /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12/buildout/apache2/mod_passenger.so" | sudo tee -a /etc/httpd/conf.modules.d/00-base.conf

Cree un nuevo archivo de host virtual para su aplicación Redmine.

sudo nano /etc/httpd/conf.d/redmine.conf

Rellene el archivo con el siguiente contenido.

<VirtualHost *:80>
    ServerName redmine.example.com

    DocumentRoot /home/redmine/redmine/public

    PassengerRoot /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12
    PassengerRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
    PassengerUser redmine

    <Directory /home/redmine/redmine/public>
      Allow from all
      Options -MultiViews
      Require all granted
    </Directory>
</VirtualHost>

Asegúrese de reemplazar redmine.example.comcon su nombre de dominio real. Además, asegúrese de que la ruta hacia PassengerRooty PassengerRubysea ​​correcta. El camino hacia los binarios puede cambiar cuando hay una nueva versión de Ruby o Passenger. Para encontrar estas rutas, ejecute el siguiente comando.

sudo su redmine -c "passenger-config about ruby-command"

Obtendrá el siguiente resultado.

[user@vultr ~]$ sudo su redmine -c "passenger-config about ruby-command"
passenger-config was invoked through the following Ruby interpreter:
  Command: /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
  Version: ruby 2.4.1p111 (2017-03-22 revision 58053) [x86_64-linux]
  To use in Apache: PassengerRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
  To use in Nginx : passenger_ruby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
  To use with Standalone: /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12/bin/passenger start

Una vez que se crea el archivo de host virtual, reinicie el servidor web Apache.

sudo systemctl restart httpd

Modifique la configuración del firewall para permitir el puerto a 80través del firewall.

sudo firewall-cmd --zone=public --add-service=http --permanent
sudo firewall-cmd --reload

Ahora puede acceder a su interfaz de Redmine en http://redmine.example.com. Inicie sesión con nombre de usuario adminy contraseña admin. En su primer inicio de sesión, Redmine le pedirá que actualice la contraseña.

Asegurando Apache con Let's Encrypt SSL

Dado que nuestra instalación de Redmine está en un servidor público, se recomienda usar SSL para asegurar el intercambio de datos desde el servidor.

Instale Certbot, que es la aplicación cliente para Let's Encrypt CA.

sudo yum -y install epel-release
sudo yum -y install certbot mod_ssl

Antes de que pueda solicitar los certificados, deberá permitir el puerto 80y / 443o estándar HTTPy HTTPSservicios a través del firewall. Como ya hemos permitido el puerto 80antes, permitamos el puerto 443.

sudo firewall-cmd --zone=public --add-service=https --permanent
sudo firewall-cmd --reload

Nota: Para obtener certificados de Let's Encrypt CA, el dominio para el que se generarán los certificados debe apuntar hacia el servidor. De lo contrario, realice los cambios necesarios en los registros DNS del dominio y espere a que se propague el DNS antes de volver a solicitar el certificado. Certbot verifica la autoridad del dominio antes de proporcionar los certificados.

Generar los certificados SSL.

sudo certbot certonly --webroot -w /home/redmine/redmine/public -d redmine.example.com

Es probable que los certificados generados se almacenen en /etc/letsencrypt/live/redmine.example.com/. El certificado SSL se almacenará como cert.pemy la clave privada se almacenará como privkey.pem.

Encriptemos los certificados caducan en 90 días, por lo tanto, se recomienda configurar la renovación automática de los certificados utilizando trabajos Cron.

Abra el archivo de trabajo Cron para el rootusuario.

sudo crontab -e

Agregue la siguiente línea al final del archivo.

30 5 * * * /usr/bin/certbot renew --quiet

El trabajo Cron anterior se ejecutará todos los días a las 5:30 a.m. Si el certificado vence, se renovará automáticamente.

Edite el archivo de host virtual que creamos anteriormente para Redmine.

sudo nano /etc/httpd/conf.d/redmine.conf

Modifique el archivo de host virtual para que se vea como el siguiente.

<VirtualHost *:80>
    Redirect permanent / https://www.example.com/
    ServerName redmine.example.com
</VirtualHost>

<VirtualHost *:443>
    ServerAdmin [email protected]
    ServerName redmine.example.com
    DocumentRoot "/home/redmine/redmine/public"
    <Directory "/home/redmine/redmine/public">
        Options None
        Require all granted
    </Directory>
    PassengerAppEnv production
    PassengerRoot /home/redmine/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.12
    PassengerRuby /home/redmine/.rvm/gems/ruby-2.4.1/wrappers/ruby
    PassengerUser redmine
    PassengerHighPerformance on

    SSLEngine on
    SSLCertificateFile      /etc/letsencrypt/live/redmine.example.com/cert.pem
    SSLCertificateKeyFile   /etc/letsencrypt/live/redmine.example.com/privkey.pem
    SSLCertificateChainFile /etc/letsencrypt/live/redmine.example.com/chain.pem

    SSLProtocol             all -SSLv2 -SSLv3
    SSLHonorCipherOrder     on
    SSLCipherSuite          ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:ECDHE-ECDSA-DES-CBC3-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:!DSS

    <IfModule headers_module>
        Header always edit Set-Cookie ^(.*)$ $1;HttpOnly;Secure
        Header always set Strict-Transport-Security "max-age=15768000; includeSubDomains"
    </IfModule>
</VirtualHost>

Guarde el archivo y salga del editor.

Reinicie Apache para que los cambios surtan efecto.

sudo systemctl restart httpd

Ahora puede acceder Redmine sobre HTTPSel https://redmine.example.com.

Felicitaciones, ha instalado con éxito Redmine en su instancia de CentOS 7. Comience a desarrollar su proyecto ya sea creando o importando su proyecto.