Ruby on Rails 學習筆記

安裝 Redmine

Redmine 是一個網頁界面的專案管理與缺陷跟蹤管理系統的自由及開放原代碼的軟體工具。它整合了專案管理所需的各項功能：日曆和甘特圖以協助視覺化表現專案與時間限制，事件追蹤和版本控制。此外，Redmine也可以同時處理多個項目。

資料來源 : Redmine - 維基百科，自由的百科全書

環境

Redmine : 2.5.1

Ruby : 1.9.3

Passenger : 4.0.45

建立 Redmine 在 MySQL需要的帳號密碼

$ mysql -u root -p
Enter password:

mysql>CREATE DATABASE redmine CHARACTER SET utf8;
mysql>CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
mysql>GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
mysql>flush privileges;
mysql>exit;

下載 Redmine

看看你們安裝的時候，到Redmine官方網站看可下載板本為何，在自己調整下載指令

$ wget http://www.redmine.org/releases/redmine-2.5.1.tar.gz
$ tar -xzvf redmine-2.5.1.tar.gz

移動 Redmine 相關檔案

$ sudo mv redmine-2.5.1 /usr/share

設定 Redmine 資料夾連結

將/usr/share/redmine連結到/usr/share/redmine-2.5.1

$ sudo ln -s /usr/share/redmine-2.5.1 /usr/share/redmine

複製並設定 Redmine 資料庫設定檔

$ cp /usr/share/redmine/config/database.yml.example /usr/share/redmine/config/database.yml

$ vim /usr/share/redmine/config/database.yml

將 MySQL 資料庫的帳號密碼設定到設定檔中

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

複製並設定 Redmine 相關設定

$ cp /usr/share/redmine/config/configuration.yml.example /usr/share/redmine/config/configuration.yml

$ vim /usr/share/redmine/config/configuration.yml

使用 Gmail SMTP 伺服器作寄送的服務

production:
  email_delivery:
  delivery_method: :smtp
  smtp_settings:
    #tls: true
    enable_starttls_auto: true
    address: "smtp.gmail.com"
    port: 587
    domain: "smtp.gmail.com" # 'your.domain.com' for GoogleApps
    authentication: :plain
    user_name: "your_email@gmail.com"
    password: "your_password"

記得要將tls: true這一行拿掉，否則會發生 SSL error。

安裝及設定 Bundler

$ gem install bundler --no-rdoc --no-ri
$ sudo apt-get install libmagickwand-dev libmysql-ruby libmysqlclient-dev
$ gem install mysql2
$ cd /usr/share/redmine
$ bundle install --without development test postgresql sqlite

產生 session store secret

$ rake generate_secret_token

如果發生 mysql 錯誤，需要再安裝 gem 的mysql2

產生並建立 Redmine 資料庫

$ cd /usr/share/redmine
$ RAILS_ENV=production rake db:migrate

產生 Redmine 預設的組態資料

$ cd /usr/share/redmine
$ RAILS_ENV=production rake redmine:load_default_data

Select language: ar, az, bg, bs, ca, cs, da, de, el, en, en-GB, es, 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] zh-TW
====================================
Default configuration data loaded.

命令列會提示預設語言，按ENTER使用預設的英語。或輸入zh-TW設定使用繁體中文的語言

設定 Redmine 帳號

$ cd /usr/share/redmine
$ mkdir public/plugin_assets
//記得將user-account換成自已的帳號
$ sudo chown -R user-account:www-data files log tmp public/plugin_assets config.ru
$ sudo chmod -R 775 files log tmp public/plugin_assets

測試 Redmine

// 使用ruby 3.1以上和rails 4.0以上版本，請用以下指令
$ ruby script/rails server webrick -e production

打開ubuntu中的firefox，網址打入0.0.0.0:3000，有看到redmine的首頁就表示安裝成功了！

測試 Redmine 在 Apache 是否可以正常運作

依照之前設定的虛擬主機設定

名稱 : dev.redmine
目錄 : /usr/share/redmine/public

<VirtualHost *:80>
  ServerName dev.redmine
  # !!! Be sure to point DocumentRoot to 'public'!
  DocumentRoot /usr/share/redmine/public
  <Directory /usr/share/redmine/public>
     # This relaxes Apache security settings.
     AllowOverride all
     # MultiViews must be turned off.
     Options -MultiViews
     # Uncomment this if you're on Apache >= 2.4:
     #Require all granted
  </Directory>
</VirtualHost>

修改 hosts 檔案

因為這個主機名稱是我們自訂的，可以修改hosts檔案，指定dev.redmine導向到本地主機127.0.0.1

$ sudo vim /etc/hosts

在hosts檔案中加入

127.0.0.1    dev.redmine

測試 Redmine 在 Apache 執行

http://dev.redmine/

登入 Redmine

預設的管理者帳密為

帳號 : admin

密碼 : admin