Instalar o redmine em um ambiente Ruby on Rails

Precisa instalar o RedMine na KingHost? Preparamos um tutorial para ajudar você.

O RedMine é uma aplicação web gratuita para gerenciamento de projetos que roda em um ambiente Ruby on Rails. Portanto, você precisará de uma estrutura específica para instalar o redmine e utilizá-lo. Na KingHost, caso você ainda não esteja na estrutura Rails, você pode entrar em contato com nosso suporte para que possamos migrar seu site para um ambiente com essas tecnologias.

Visite o site oficial da plataforma: https://www.redmine.org/.
Visite também o repositório de gems: https://rubygems.org/?locale=pt-BR.

Importante: O uso de ambiente Ruby on Rails exige um conhecimento técnico sobre a linguagem e o framework.

Habilitar estrutura de FTP do Ruby

Acesse o Painel de Controle da KingHost. Nele, encontre a seção Ruby on Rails e clique em Gerenciar aplicações.

Na nova página, escolha se você quer ter apenas uma aplicação na raíz do site (www) ou se prefere ter duas em subdiretórios diferentes. Dê um nome para a sua aplicação e defina qual será o banco de dados utilizado.

Depois disso, serão criadas as seguintes pastas em seu FTP:
apps_rails – Onde devem ficar suas aplicações Rails.
.gems – (Pasta oculta) As gems funcionam como plugins adicionando funcionalidades à aplicação.

Instalar o RedMine

Faça o download da versão mais recente do RedMine em https://www.redmine.org/projects/redmine/wiki/Download.

Você precisará ter certo conhecimento em manipulação de arquivos via FTP e/ou terminal SSH. Temos alguns materiais que podem te ajudar: Obter dados de acesso ao FTP; Acessar FTP via terminal SSH.

Descompacte o arquivo e envie para o FTP do seu site via FileZilla ou então baixe o arquivo compactado diretamente via terminal SSH (por wget). A pasta da aplicação RedMine deve ficar dentro do diretório apps_rails.

wget http://www.redmine.org/releases/redmine-3.4.5.zip

Para descompactar:

unzip redmine-3.4.5.zip

Agora renomeie a pasta redmine para o nome do projeto que você criou via Painel de Controle no passo anterior.

Conexão ao banco de dados

Crie uma nova base de dados MySQL através do Painel de controle.
Para saber mais detalhes acesse o artigo: Como criar um banco de dados MySQL.

No terminal SSH, acesse a pasta config.

cd config

Copie o conteúdo do arquivo database.yml.example para um novo chamado database.yml .

cp database.yml.example database.yml

Substitua os dados da base o item production de acordo com as credenciais de acesso ao seu banco de dados.

Você também pode utilizar bases Postgre e SQL Server para se conectar ao seu projeto.

Instalar dependências

Para gerenciar as dependências de gems o redmine utiliza o Bundler. Instale-o com o seguinte comando:

gem install bundler

Execute também:

bundle install

Gerar o secret token

Agora, vamos gerar o secret token necessário para as sessões:

bundle exec rake secret token

Dependências do banco de dados

Agora é necessário criar a estrutura do banco de dados. Para isso, usamos o seguinte comando:

RAILS_ENV=production bundle exec rake db:migrate

Inserir dados de configuração padrão no banco:

RAILS_ENV=production bundle exec rake redmine:load_default_data

Reinicie a aplicação

Para o restart da aplicação, basta rodar o seguinte comando:

touch tmp/restart.txt

Se todo o passo a passo foi seguido como descrito, o acesso estará normalizado:

Você pode consultar a documentação de instalação no site oficial: http://www.redmine.org/projects/redmine/wiki/redmineinstall.