Instalação do Redmine 3.4 no CentOS 7: Guia Passo a Passo

Requisitos do Sistema

Interpretador Ruby

A versão do Ruby necessária para o Redmine 3.4 é a seguinte:

Versão do Redmine Versões do Ruby Suportadas Versão do Rails Utilizada
3.4 Ruby 1.9.3, 2.0.0, 2.1, 2.2, 2.3, 2.4 Rails 4.2

Bancos de Dados Suportados

  • MariaDB/MySQL: 5.5 a 5.7 (versões 5.0 e 5.1 também suportadas no Redmine 3.x).
  • PostgreSQL: 9.2 ou superior (configurar o estilo de data para ISO no banco).
  • SQLite 3: Apenas para ambientes de teste, não recomendado para produção com múltiplos usuários.

Componentes Opcionais

  • Ferramentas SCM como svn para navegação em repositórios.
  • ImageMagick para exportação de diagramas Gantt em PNG e geração de miniaturas.

Passo 1: Download do Redmine

Desative o firewall temporariamente e baixe a versão 3.4.7 do Redmine:

systemctl stop firewalld
wget https://www.redmine.org/releases/redmine-3.4.7.tar.gz
tar xf redmine-3.4.7.tar.gz -C /opt/
cd /opt/redmine-3.4.7

Passo 2: Configuração do Banco de Dados

Instale o MariaDB e crie um banco de dados e usuário para o Redmine:

yum install mariadb-server mariadb-devel -y
systemctl start mariadb
mysql -u root -p

-- No prompt do MySQL, execute:
CREATE DATABASE redmine_bd CHARACTER SET utf8mb4;
CREATE USER 'rm_user'@'localhost' IDENTIFIED BY 'S3nh@F0rt3!';
GRANT ALL PRIVILEGES ON redmine_bd.* TO 'rm_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Passo 3: Ajuste do Arquivo de Configuração do Banco

Copie o arquivo de exemplo e edite as configurações de produção:

cp /opt/redmine-3.4.7/config/database.yml.example /opt/redmine-3.4.7/config/database.yml
vim /opt/redmine-3.4.7/config/database.yml

Modifique a seção de produção conforme abaixo:

production:
  adapter: mysql2
  database: redmine_bd
  host: localhost
  username: rm_user
  password: "S3nh@F0rt3!"
  encoding: utf8mb4

Passo 4: Instalação de Dependências

Instale as ferramentas necessárias e configure as gemas do Ruby:

yum install ImageMagick-devel ruby rubygems ruby-devel -y
gem sources --add http://mirrors.tuna.tsinghua.edu.cn/rubygems/
gem sources --remove https://rubygems.org/
gem install bundler
cd /opt/redmine-3.4.7
bundle install --without development test

Passo 5: Geração do Token de Sessão

Crie a chave secreta para o Rails:

cd /opt/redmine-3.4.7
RAILS_ENV=production bundle exec rake generate_secret_token

Passo 6: Migração do Esquema do Banco

Execute a migração para criar as tabelas. Se encontrar erro de tamanho de chave, aplique a correção a seguir:

cd /opt/redmine-3.4.7/config/initializers
cat > mysql_fix.rb << 'EOF'
require 'active_record/connection_adapters/abstract_mysql_adapter'

module ActiveRecord
  module ConnectionAdapters
    class AbstractMysqlAdapter
      NATIVE_DATABASE_TYPES[:string] = { :name => "varchar", :limit => 191 }
    end
  end
end
EOF

cd /opt/redmine-3.4.7
RAILS_ENV=production bundle exec rake db:migrate

Passo 7: Carregamento de Dados Padrão

Insira os dados iniciais no banco de dados, selecionando o idioma preferido:

RAILS_ENV=production bundle exec rake redmine:load_default_data
# Escolha 'pt' para português ao ser solicitado

Passo 8: Permissões de Diretórios

Se o aplicativo não for executado como root, ajuste as permisões para os diretórios files, log, tmp e public/plugin_assets.

Passo 9: Teste Inicial do Servidor

Inicie o servidor WEBrick para verificação:

cd /opt/redmine-3.4.7
bundle exec rails server webrick -e production -b 0.0.0.0 -p 3000

Acesse http://endereço-do-servidor:3000 no navegador. O login padrão é admin com a senha admin.

Passo 10: Configurações Adicionais

Para habilitar o envio de e-mails, edite o arquivo de configuração:

cp /opt/redmine-3.4.7/config/configuration.yml.example /opt/redmine-3.4.7/config/configuration.yml
vim /opt/redmine-3.4.7/config/configuration.yml

Configure os parâmetros SMTP, por exemplo:

default:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: smtp.provedor.com
      port: 587
      domain: provedor.com
      authentication: :plain
      user_name: "usuario@dominio.com"
      password: "senha_email"
      enable_starttls_auto: true

Reinicie o Redmine após quaisquer alterações para que entrem em vigor.

Tags: CentOS7 Redmine Ruby MariaDB Rails

Publicado em 6-3 19:34 por Thomas