Hazel Wu | 22'mm

幫 Rails 建立一個 Docker Container吧

2018-04-08

幫 Rails 建立一個 Docker Container吧

為什麼你要使用Docker?

Docker最重要的價值是:有效解決環境配置、衝突的問題
可以在一台機器上跑,就可以在所有的機器上跑。
如果有問題的話,就會是大家的問題,大家一起解決XD

docker是建立一個container新的環境,有助於不會因為不同作業系統(Mac, Linux)導致無法在本端跑環境
你不用因為不小心升級了npm的webpack等等……..架不起來環境
最後電腦整個砍掉重灌之類的……….相信我你會很想死一千遍QQ。

Mac 教學

請先安裝 Docker,在Mac環境下安裝Docker非常簡單,只要安裝UI軟體即可XD。
Mac 安裝 Docker = >請點我下載

安裝完後,我們先以建立一個新專案來跑Docker

建立新專案

首先建立一個新的資料夾,並且先手動建立四個檔案

1
2
3
4
5
6
7
cd desktop
mkdir docker
cd mkdir
touch Gemfile.lock
touch Gemfile
touch docker-compose.yml
touch Dockerfile

手動填上設定

docker_1可以手動改成自己的專案名稱,ruby版本可以自由更改,撰寫此篇文章時是Ruby 2.5.0版本

1
2
3
4
5
6
7
8
9
# Dockerfile
FROM ruby:2.5.0
RUN apt-get update -qq && apt-get install -y build-essential libpq-dev nodejs
RUN mkdir /docker_1
WORKDIR /docker_1
ADD Gemfile /docker_1/Gemfile
ADD Gemfile.lock /docker_1/Gemfile.lock
RUN bundle install
ADD . /docker_1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# Docker-compose.yml
version: '2'
services:
db:
image: postgres
web:
build: .
command: bundle exec rails s -p 3000 -b '0.0.0.0'
volumes:
- .:/docker_1
ports:
- "3000:3000"
depends_on:
- db

Gemfile最簡單,只要輸入兩行即可

1
2
3
# Gemfile
source 'https://rubygems.org'
gem 'rails', '~> 5.1.6'

docker-compose.yml 用途

docker-compose.yml的用途

  1. web container
  2. database constainer

設定完成,跑指令!

設置好檔案後,開始跑指令吧

1
docker-compose run web rails new --force --database=postgresql

這個指令輸入後,會自動建立一個容器,裝著新的rails 專案,
Dockerfile會將專案內的Gemfile複製到docker container上,並且自動執行bundle install。
還記得我們剛剛在新增Gemfile添加內容時,只安裝了Rails的Gem

database的username則設定為:postgresql

完整跑完指令後,會發現專案資料夾已經設置好Rails框架了,像是db, assets等等

設置database的username

接著來database.yml檔,因為剛剛輸入的指令設定database username是postgresql
因此資料庫的yml檔必須也添加上去,添加usernamepasswordhost

1
2
3
4
5
6
7
8
9
default: &default
adapter: postgresql
encoding: unicode
# For details on connection pooling, see Rails configuration guide
# http://guides.rubyonrails.org/configuring.html#database-pooling
pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
username: postgres
password:
host: db

架設環境吧!

docker-compose up 的指令等同於 rails s,只是是遠端操作docker,那port設定是在3000

1
docker-compose up

如果設置檔案過程都順利、正常的話,輸入localhost:3000即會看到Rails 架設成功的畫面惹。

恭喜你,看到這個畫面時,也代表進入Docker的大坑了(誤)

Docker 指令介紹

當你在Gemfile 有變動時,都要重跑bundle,那在docker上則是輸入docker-compose build

1
docker-compose build

跑任何Rails指令前都必須加上docker-compose run web
例如:想要跑rails db:migrate 遷移資料庫指令時前面也要加上此行

1
docker-compose run web rails db:migrate
  • 開啟伺服器 localhost:3000
    docker-compose up

  • 關閉伺服器
    docker-compose down

  • 進入Docker rails console
    docker-compose rails c

    Docker 一次滿足你三個願望

    不管你想要安裝Yarn, Node.js還是 Webpacker, 前端Framework都沒有問題唷

想在Docker上安裝yarn、Node.js?沒問題

1
2
3
4
5
6
RUN apt-get update && apt-get install -y curl apt-transport-https wget && \
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add - && \
echo "deb https://dl.yarnpkg.com/debian/ stable main" | tee /etc/apt/sources.list.d/yarn.list && \
apt-get update && apt-get install -y yarn
RUN curl -sL https://deb.nodesource.com/setup_7.x | bash - && \
apt-get install nodejs

Docker 安裝 Webpacker?沒問題

Docker container上加入webpacker?沒問題啊!
在Gemfile上添加webpacker

1
gem 'webpacker', '~> 3.4'

接著重新Run一次以下指令

1
2
docker-compose run web bundle update
docker-compose build

Docker上導入React framework?沒問題!

docker-compose run web rails webpack:install:react
你有發現到嗎?其實安裝webpacker指令在rails上也是輸入rails webpack:install
只是前面多加了docker-compose run web而已
不要被長長的指令嚇到了Q_Q

用 Alias 縮短docker指令

覺得每次都要輸入這史上超長的指令,很浪費人生、手指力氣吧
你想想看,我今天想在docker上新增一個container,我要這樣子輸入
docker-compose run web rails controller -g home
超級無敵霹靂有夠長的好不好!

1
2
3
4
5
vim ~/.bashrc
alias dc-web='docker-compose run web'
alias dc-migrate='docker-compose run web rails db:migrate'
alias dc-rspec='docker-compose run web rspec'
alias dc='docker-compose'

以後在終端機上就可以簡單輸入dc-web這些囉
也可以自行設定你常用的指令。

閱讀量