/ilms

Primary LanguageRuby

Build Production Environment

以下建立環境是假設Ruby & Rails通通都還沒有裝，而且非常乾淨的環境。以下方法目前確定能夠運作的環境是在ubuntu 16.04 & memory 1.5GB 的環境下，如果memory太小記得要去mount一個1GB的swap。Deployment方法是基於Ruby on Rails 實戰聖經的說明，不過有一些差異，此說明包括設定email功能。

Before Deployment

  1. 先把環境基礎建設處理好

    sudo apt-get update
sudo apt-get upgrade -y
sudo dpkg-reconfigure tzdata

    之後會要你選時區，選asia-->Taipei

    sudo apt-get install -y build-essential git-core bison openssl libreadline6-dev curl zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-0 libsqlite3-dev sqlite3  autoconf libc6-dev libpcre3-dev curl libcurl4-nss-dev libxml2-dev libxslt-dev imagemagick nodejs libffi-dev

  2. 安裝ruby

    sudo apt-get install software-properties-common
sudo apt-add-repository ppa:brightbox/ruby-ng
sudo apt-get update
sudo apt-get install ruby2.3 ruby2.3-dev
ruby -v

    ruby -v有 ruby 2.3.1p112 (2016-04-26) [x86_64-linux-gnu] 跑出來代表裝好了 安裝ruby套件工具bundler

    sudo gem install bundler

    安裝Rails

    sudo gem install rails --no-ri --no-rdoc

  3. 安裝MySQL

    sudo apt-get install mysql-common mysql-client libmysqlclient-dev mysql-server

    安裝到一半會要你輸入root password，輸入完記住密碼，安裝完後進入mysql的console

    mysql -u root -p

    之後會要你輸入剛剛安裝的時候打的密碼，輸入後進到console，然後建立一個table給Sprout LMS用

    CREATE DATABASE sprout CHARACTER SET utf8mb4;

  4. 安裝 Nginx + Passenger：用來Deploy用的Tool

    sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 561F9B9CAC40B2F7

sudo apt-get install -y apt-transport-https ca-certificates

# Add our APT repository
sudo sh -c 'echo deb https://oss-binaries.phusionpassenger.com/apt/passenger xenial main > /etc/apt/sources.list.d/passenger.list'

sudo apt-get update

# Install Passenger + Nginx
sudo apt-get install -y nginx-extras passenger

    然後以下是開啟與關閉nginx的方法

    sudo service nginx start
sudo service nginx stop
sudo service nginx restart

Deployment

  1. Clone SproutLMS Project

    cd ~
git clone https://github.com/ChihMin/ilms
cd ilms
bundle install

  2. Database setting

    編輯 config/database.yml ，production那裡設定使用 MySQL:

    production:
  adapter: mysql2
  encoding: utf8mb4
  database: sprout
  host: localhost
  username: root
  password: "這裡打你剛剛安裝ＭySQL時設定的密碼"

  3. 新增email設定檔，新增 config/email.yml 檔案，並加入以下內容：

    production:
  address: "這裡放SMTP的Address"
  port: "25"
  authentication: "plain"
  user_name: "這裡放email address"
  password: "這裡放email address的密碼"
  enable_starttls_auto: true

  4. 編輯 config/secrets.yml (在機器上用 rake secret 可以隨機產生一個新的 key)：

    production:
		secret_key_base: 放剛剛產生的key

  5. Migrate Datebase schema to mysql2 & precompile assets

    RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake assets:precompile

  6. 設定Nginx

    編輯 /etc/nginx/nginx.conf，打開以下一行(把這行的註解#拔掉)：

    include /etc/nginx/passenger.conf;

    在 /etc/nginx/nginx.conf最上方新增一行：

    env PATH;

    新增 /etc/nginx/sites-enabled/sprout_lms.conf

    server {
  listen 80;
  server_name your_domain.com;

  root /home/deploy/your_project_name/public;

  passenger_enabled on;
  client_max_body_size 60m;
  passenger_min_instances 5;

  location ~ ^/assets/ {
	    expires 1y;
	    add_header Cache-Control public;
	    add_header ETag "";
 	break;
   }
}
    • root 那裡擺clone下來的project的絕對路徑下的public資料夾，比方說clone 下來在 /home/chihmin/ilms，那麼就把這個絕對路徑指向/home/chihmin/ilms/public
    • server_name 如果沒有 domain name，就先打這台電腦的IP passenger_min_instances 數量就看電腦有多強，代表可以開的process 個數，設定完重新啟動nginx : sudo service nginx restart
    • client_max_body_size 這個是用來設定，檔案上傳時的最大大小

  7. 開啟email worker thread 這個是用來處理非同步寄信功能用的機制，以下設定方法，安裝 screen，因為這個需要掛在背景執行，所以用screen把城市掛起來

    sudo apt-get install screen
screen -S email_worker
RAILS_ENV=production bundle exec rake jobs:work

    之後 ctrl + a + d 就可以把screen 掛在背景執行了

  8. 建立初始 admin 帳號：

    RAILS_ENV=production bundle exec rake db:seed

  9. 開啟瀏覽器，直接輸入server IP 就好了，最初始預設講師帳號密碼：

    teacher@gmail.com
123456789

    登入之後可以點選個人資料更改密碼