Como instalar e configurar o redmine no ubuntu 18.04

O Redmine é uma das ferramentas de software de gerenciamento de projetos de código aberto mais populares e de rastreamento de problemas. É multiplataforma e multi-banco de dados e construído sobre a estrutura do Ruby on Rails.

O Redmine inclui suporte para vários projetos, wikis, sistema de rastreamento de problemas, fóruns, calendários, notificações por email e muito mais.

Este tutorial descreve como instalar e configurar a versão mais recente do Redmine em um servidor Ubuntu 18.04 usando o MySQL como back-end do banco de dados e o Passenger + Nginx como um servidor de aplicativos Ruby.

Pré-requisitos

Verifique se você atendeu aos seguintes pré-requisitos antes de continuar com este tutorial:

• Você tem um nome de domínio apontando para o IP público do servidor. Neste tutorial, usaremos example.com . Você está logado como usuário com privilégios de sudo. Você tem o Nginx instalado seguindo estas instruções. Você tem um certificado SSL instalado para o seu domínio. Você pode instalar um certificado SSL Let's Encrypt criptografado gratuitamente, seguindo estas instruções.

Criando banco de dados MySQL

O Redmine suporta MySQL / MariaDB, Microsoft SQL Server, SQLite 3 e PostgreSQL. Neste tutorial, usaremos o MySQL como um back-end de banco de dados.

Entre no shell do MySQL digitando o seguinte comando:

sudo mysql

No shell do MySQL, execute a seguinte instrução SQL para criar um novo banco de dados:

CREATE DATABASE redmine CHARACTER SET utf8mb4;

Em seguida, crie uma conta de usuário MySQL e conceda acesso ao banco de dados:

GRANT ALL ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'change-with-strong-password'; Certifique-se de alterar a change-with-strong-password forte.

Quando terminar, saia do console do mysql digitando:

EXIT;

Instalando o Ruby

A maneira mais fácil de instalar o Ruby no seu sistema Ubuntu é através do gerenciador de pacotes apt . No momento da redação deste artigo, a versão nos repositórios do Ubuntu é 2.5.1, que é a versão estável mais recente do Ruby.

Instale o Ruby digitando:

sudo apt install ruby-full

Instalando o Passenger e o Nginx

O Passenger é um servidor de aplicativos da web rápido e leve para Ruby, Node.js e Python que pode ser integrado ao Apache e Nginx. Instalaremos o Passenger como um módulo Nginx.

Verifique se você seguiu os pré-requisitos e instalou o Nginx antes de continuar com as etapas a seguir.

Comece instalando os pacotes necessários:

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

Importe a chave GPG do repositório e ative o repositório 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'

Depois que o repositório apt estiver ativado, atualize a lista de pacotes e instale o módulo Passenger Nginx com:

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

Instalando o Redmine no Ubuntu

Começaremos instalando as dependências necessárias para construir o Redmine:

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

No momento da redação deste artigo, a versão estável mais recente do Redmine é a versão 4.0.0.

Antes de continuar com a próxima etapa, verifique a página de download do Redmine para ver se uma versão mais recente está disponível.

1. Baixando o Redmine

Faça o download do archive do Redmine com o seguinte comando curl:

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

Após a conclusão do download, extraia o archive e mova-o para o diretório /opt :

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

2. Configurando o Redmine Database

Comece copiando o arquivo de configuração de exemplo do Redmine:

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

Abra o arquivo com seu editor de texto:

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

Procure a seção de production e insira o banco de dados MySQL e as informações do usuário que criamos anteriormente:

/opt/redmine/config/database.yml

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

Uma vez feito, salve o arquivo e saia do editor.

3. Instalando dependências do Ruby

Navegue para o diretório redmine e instale o bundler e outras dependências do Ruby:

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

4. Gere chaves e migre o banco de dados

Execute o seguinte comando para gerar chaves e migrar o banco de dados:

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

5. Defina as permissões corretas

O Nginx é executado como usuário e grupo de www-data . Defina as permissões corretas emitindo o seguinte comando chown:

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

Configurar Nginx

Até agora, você já deve ter o Nginx com certificado SSL instalado em seu sistema, caso contrário, verifique os pré-requisitos para este tutorial.

Abra seu editor de texto e crie o seguinte arquivo de bloqueio do 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; } Não se esqueça de substituir example.com pelo seu domínio Redmine e defina o caminho correto para os arquivos de certificado SSL. Todas as solicitações HTTP serão redirecionadas para HTTPS. Os trechos usados ​​nesta configuração são criados neste guia.

Ative o bloco do servidor criando um link simbólico para o diretório sites-enabled para sites-enabled :

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

Antes de reiniciar o serviço Nginx, faça um teste para garantir que não haja erros de sintaxe:

sudo nginx -t

Se não houver erros, a saída deve ser assim:

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

Por fim, reinicie o serviço Nginx digitando:

sudo systemctl restart nginx

Acessando o Redmine

Abra seu navegador, digite seu domínio e, assumindo que a instalação foi bem-sucedida, uma tela semelhante à seguinte será exibida:

Depois de alterar a senha, você será redirecionado para a página da conta de usuário.

Conclusão

Você instalou o Redmine com sucesso no seu sistema Ubuntu. Agora você deve verificar a documentação do Redmine e aprender mais sobre como configurar e usar o Redmine.

ubuntu redmine ruby ​​mysql nginx