Como Instalar a Ferramenta de Gerenciamento de Projetos Redmine no Ubuntu 22.04

Redmine é uma ferramenta de gerenciamento de projetos e rastreamento de problemas gratuita e de código aberto. É um software de aplicação baseado na web, principalmente escrito em Ruby on Rails. É multiplataforma e suporta múltiplos bancos de dados e múltiplas línguas.

Redmine é flexível e pode ser usado para diferentes tipos de organizações e projetos, desde pequenas, médias ou grandes organizações. Ele permite que você crie e gerencie múltiplos projetos, e cada projeto tem seu próprio Wiki, Fóruns, rastreamento de problemas, etc. Além disso, permite que você crie funções personalizadas com base nas necessidades da sua organização, e muito mais.

Redmine é lançado sob a licença GNU GPL v2 e pode ser instalado em qualquer sistema operacional, como Linux, Windows ou macOS. Ele suporta diferentes tipos de bancos de dados, incluindo PostgreSQL, MySQL e SQLite (padrão).

Neste guia, você instalará o Redmine com o servidor web Apache2 e o servidor MySQL em um servidor Ubuntu 22.04. Você também protegerá a instalação do Redmine com certificados SSL.

Pré-requisitos

Este tutorial requer os seguintes requisitos:

• Um servidor Ubuntu 22.04 - Este exemplo usa um servidor Ubuntu com o nome do host redmine-server.
• Um usuário não-root com privilégios de sudo root - Mas você também pode usar o usuário root.
• Um nome de domínio apontado para o endereço IP do seu servidor - para produção, você deve garantir que seu nome de domínio esteja apontado para o endereço IP do seu servidor.

Uma vez que você tenha tudo em ordem, você pode prosseguir para o primeiro passo da instalação do Redmine.

Instalando Dependências

Redmine é uma ferramenta de gerenciamento de projetos e rastreamento de problemas de código aberto, principalmente escrita em Ruby e Ruby on Rails (RoR). Para instalar o Redmine, você deve instalar o Ruby primeiro, depois pode instalar outras dependências, como o servidor web Apache2 e o banco de dados usando o servidor MySQL.

Neste exemplo, você executará o Redmine com o servidor web Apache2 e o servidor MySQL.

Antes de começar a instalar pacotes, execute o comando apt abaixo para atualizar e refrescar o índice de pacotes do Ubuntu.

sudo apt update

Após o repositório ser atualizado, instale algumas dependências de pacotes via o comando apt abaixo.

Com este comando, você instalará o servidor web Apache2 seguido do linapache2-mod-passenger que será usado para configurar a aplicação RoR a fim de rodar sob o Apache2. Você também instalará pacotes Ruby.

sudo apt install apache2 ruby ruby-dev build-essential libapache2-mod-passenger libmysqlclient-dev

Quando solicitado a confirmar a instalação, digite y e pressione ENTER para prosseguir.

Após o Apache2 e o Ruby serem instalados, execute o seguinte comando para instalar o servidor MySQL. O Redmine suporta múltiplos RDBMS, como PostgreSQL, MySQL/MariaDB e SQLite. Neste exemplo, você usará o servidor MySQL.

sudo apt install mysql-server

Digite y quando solicitado a confirmar a instalação, e pressione ENTER para prosseguir.

Para a instalação do Redmine, você também precisará instalar um bundler em seu servidor Ubuntu. O bundler é uma linha de comando que será usada para gerenciar pacotes Ruby Gems.

Execute o seguinte comando para instalar um bundler em seu sistema.

sudo gem install bundler

Uma vez que o bundler esteja instalado, você verá a saída como a seguinte:

Por fim, verifique os serviços do Apache2 e MySQL via o comando systemctl abaixo. Isso garantirá que ambos os serviços Apache2 e MariaDB estejam em execução e habilitados.

Verifique o serviço Apache2.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Abaixo você pode ver que o serviço Apache2 está habilitado e será executado automaticamente na inicialização do sistema. E o status atual do serviço está em execução.

Verifique o serviço MySQL.

sudo systemctl is-enabled mysql  
sudo systemctl status mysql

Você verá uma saída semelhante à seguinte - O serviço MySQL está habilitado e será executado automaticamente na inicialização. E o status atual do serviço MySQL está em execução.

Configurando o Servidor MySQL

Após o Apache2 e o servidor MySQL serem instalados, você configurará a senha root do MySQL e protegerá a implantação via mysql_secure_installation. Em seguida, você também criará um novo banco de dados MySQL e um usuário para o Redmine.

Faça login no MySQL via o comando mysql abaixo.

sudo mysql

Agora, altere a senha root do MySQL via a seguinte consulta. E certifique-se de alterar a senha pela sua senha. Em seguida, digite quit para sair do shell do MySQL.

ALTER USER root@localhost IDENTIFIED WITH mysql_native_password BY 'password';  
quit

Em seguida, execute o seguinte comando para começar a proteger a implantação do servidor MySQL.

sudo mysql_secure_installation

Quando solicitado pela senha root do MySQL, insira sua senha correta.

Então, você será questionado sobre outras configurações do MySQL, como desabilitar o login remoto para o usuário root, remover o usuário anônimo, remover o banco de dados padrão de teste e recarregar todos os privilégios das tabelas. Para todas essas configurações do servidor MySQL, insira Y para confirmar a configuração.

Após proteger a implantação do MySQL, é hora de configurar um novo banco de dados e usuário para o Redmine.

Faça login no shell do MySQL via o comando mysql abaixo. Você será solicitado pela senha root do MySQL, insira a senha correta para o seu usuário root do MySQL e pressione ENTER.

sudo mysql -u root -p

Agora execute as seguintes consultas para criar um novo banco de dados MySQL e um usuário para o Redmine. Neste exemplo, você criará um novo banco de dados e usuário redmine com a senha ‘secretPassword‘. Você pode substituir a senha do banco de dados pela sua senha.

CREATE DATABASE redmine CHARACTER SET utf8mb4;  
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'secretPassword';  
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';  
FLUSH PRIVILEGES;

Em seguida, execute as seguintes consultas para verificar os privilégios do usuário MySQL redmine. Certifique-se de que o usuário MySQL redmine tenha privilégios sobre o banco de dados redmine.

SHOW GRANTS FOR redmine@localhost;  
quit

Abaixo você pode ver o usuário MySQL redmine@localhost com privilégios sobre o banco de dados redmine.

Por fim, digite quit para sair do shell do MySQL.

Com todas as dependências instaladas e o banco de dados e usuário MySQL criados, você está pronto para instalar a ferramenta de gerenciamento de projetos Redmine em seu servidor Ubuntu.

Instalando o Redmine

Neste passo, você instalará a versão mais recente do Redmine. No momento da redação deste documento, a versão mais recente do Redmine é a v5.0.2.

Você fará o download do código-fonte do Redmine, configurará o banco de dados, instalará as dependências do Ruby via build, configurará o token secreto do Redmine e migrará o banco de dados.

Neste exemplo, você instalará o Redmine dentro do diretório /opt/redmine.

Mova para o diretório /opt.

cd /opt/

Agora, faça o download do código-fonte do Redmine com o comando wget abaixo. Uma vez baixado, você verá o arquivo redmine-5.0.2.tar.gz no seu diretório /opt.

wget https://www.redmine.org/releases/redmine-5.0.2.tar.gz

Em seguida, execute o seguinte comando para extrair o código-fonte do Redmine redmine-5.0.2.tar.gz e criar um novo link simbólico para o diretório do Redmine em /opt/redmine.

tar -xvzf redmine-5.0.2.tar.gz  
sudo ln -s redmine-5.0.2 redmine

O diretório principal de instalação do Redmine será /opt/redmine.

Mova para o diretório /opt/redmine.

cd /opt/redmine/

Copie a configuração padrão do banco de dados ‘config/database.yml.example’ para ‘config/database.yml’. Em seguida, abra o arquivo de configuração do banco de dados ‘config/database.yml’ usando o editor nano.

cp config/database.yml.example config/database.yml  
nano config/database.yml

Na seção ‘produção’, altere os detalhes do banco de dados MySQL e do usuário. Certifique-se de usar o usuário e a senha corretos do banco de dados para o Redmine.

production:  
  adapter: mysql2  
  database: redmine  
  host: localhost  
  username: redmine  
  password: "secretPassword"   
  # Use "utf8" em vez de "utfmb4" para MySQL anterior a 5.7.7  
  encoding: utf8mb4

Salve o arquivo e saia do editor quando terminar.

Em seguida, execute o seguinte comando do bundler para instalar as dependências do Ruby para a aplicação Redmine.

bundle config set --local without 'development test'  
bundle install

Você verá a saída semelhante à seguinte:

Uma vez que as dependências do Redmine estejam instaladas, execute o seguinte comando para gerar o token secreto do Redmine e migrar o banco de dados.

bundle exec rake generate_secret_token  
RAILS_ENV=production bundle exec rake db:migrate

Na captura de tela a seguir, você pode ver que o token secreto do Redmine foi gerado e o processo de migração do banco de dados do Redmine.

Por fim, carregue os dados padrão para sua instalação do Redmine com o seguinte comando. Quando solicitado a escolher o idioma, insira en para Inglês.

RAILS_ENV=production bundle exec rake redmine:load_default_data

Quando os dados padrão do Redmine forem carregados, você verá a mensagem de saída como