這篇文章主要介紹了在Docker中部署Ruby on Rails的教程,Docker是當下最火的虛擬機器,而本文所介紹的Ruby on Rails的部署則充分利用了Ruby中的rake這一炫酷的實現自動化的方法,需要的朋友可以參考下
基本的Rails應用程式
現在讓我們啟動一個基本的Rails應用。為了更好的展示,我使用Ruby 2.2.0和Rails 4.1.1
在終端運行:
?
1 2 |
$ rvm use 2.2.0 $ rails new && cd docker-test |
建立一個基本的控制器:
?
1 |
$ rails g controller welcome index |
……,然後編輯 routes.rb ,以便讓該項目的根指向我們新建立的welcome#index方法:
?
在終端運行 rails s ,然後開啟瀏覽器,登入http://localhost:3000,你會進入到索引介面當中。我們不準備給應用加上多麼神奇的東西,這隻是一個基礎的執行個體,當我們將要建立並部署容器的時候,用它來驗證一切是否運行正常。
安裝webserver
我們打算使用Unicorn當做我們的webserver。在Gemfile中添加 gem 'unicorn'和 gem 'foreman'然後將它bundle起來(運行 bundle install命令)。
啟動Rails應用時,需要先配置好Unicorn,所以我們將一個unicorn.rb檔案放在config目錄下。這裡有一個Unicorn設定檔的例子,你可以直接複製粘貼Gist的內容。
接下來,在項目的根目錄下添加一個Procfile,以便可以使用foreman啟動應用,內容為下:
代碼如下:
web: bundle exec unicorn -p $PORT -c ./config/unicorn.rb
現在運行foreman start命令啟動應用,一切都將正常運行,並且你將能夠在http://localhost:5000上看到一個正在啟動並執行應用。
構建一個Docker鏡像
現在我們構建一個鏡像來運行我們的應用。在這個Rails項目的根目錄下,建立一個名為Dockerfile的檔案,然後粘貼進以下內容:
代碼如下:
# 基於鏡像 ruby 2.2.0
FROM ruby:2.2.0
# 安裝所需的庫和依賴
RUN apt-get update && apt-get install -qy nodejs postgresql-client sqlite3 --no-install-recommends && rm -rf /var/lib/apt/lists/*
# 設定 Rails 版本
ENV RAILS_VERSION 4.1.1
# 安裝 Rails
RUN gem install rails --version "$RAILS_VERSION"
# 建立代碼所啟動並執行目錄
RUN mkdir -p /usr/src/app
WORKDIR /usr/src/app
# 使 webserver 可以在容器外面訪問
EXPOSE 3000
# 設定環境變數
ENV PORT=3000
# 啟動 web 應用
CMD ["foreman","start"]
# 安裝所需的 gems
ADD Gemfile /usr/src/app/Gemfile
ADD Gemfile.lock /usr/src/app/Gemfile.lock
RUN bundle install --without development test
# 將 rails 項目(和 Dockerfile 同一個目錄)添加到項目目錄
ADD ./ /usr/src/app
# 運行 rake 任務
RUN RAILS_ENV=production rake db:create db:migrate
使用上述Dockerfile,執行下列命令建立一個鏡像(確保boot2docker已經啟動並在運行當中):
?
1 |
$ docker build -t localhost:5000/your_username/docker-test . |
然後,如果一切正常,長長的日誌輸出的最後一行應該類似於:
?
1 2 3 4 |
Successfully built 82e48769506c $ docker images REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE localhost:5000/your_username/docker-test latest 82e48769506c About a minute ago 884.2 MB |
讓我們運行一下容器試試!
?
1 |
$ docker run -d -p 3000:3000 --name docker-test localhost:5000/your_username/docker-test |
通過你的boot2docker虛擬機器的3000號連接埠(我的是http://192.168.59.103:3000),你可以觀察你的Rails應用。(如果不清楚你的boot2docker虛擬位址,輸入$ boot2docker ip命令查看。)
使用shell指令碼進行自動化部署
前面的文章(指文章1和文章2)已經告訴了你如何將新建立的鏡像推送到私人registry中,並將其部署在伺服器上,所以我們跳過這一部分直接開始自動化進程。
我們將要定義3個shell指令碼,然後最後使用rake將它們捆綁在一起。
清除
每當我們建立鏡像的時候,
停止並重啟boot2docker;
去除Docker孤兒鏡像(那些沒有標籤,並且不再被容器所使用的鏡像們)。
在你的工程根目錄下的clean.sh檔案中輸入下列命令。
代碼如下:
echo Restarting boot2docker...
boot2docker down
boot2docker up
echo Exporting Docker variables...
sleep 1
export DOCKER_HOST=tcp://192.168.59.103:2376
export DOCKER_CERT_PATH=/Users/user/.boot2docker/certs/boot2docker-vm
export DOCKER_TLS_VERIFY=1
sleep 1
echo Removing orphaned images without tags...
docker images | grep "" | awk '{print $3}' | xargs docker rmi
給指令碼加上執行許可權:
?
構建
構建的過程基本上和之前我們所做的(docker build)內容相似。在工程的根目錄下建立一個build.sh指令碼,填寫如下內容:
代碼如下:
docker build -t localhost:5000/your_username/docker-test .
記得給指令碼執行許可權。
部署
最後,建立一個deploy.sh指令碼,在裡面填進如下內容:
代碼如下:
# 開啟 boot2docker 到私人註冊庫的 SSH 串連
boot2docker ssh "ssh -o 'StrictHostKeyChecking no' -i /Users/username/.ssh/id_boot2docker -N -L 5000:localhost:5000 root@your-registry.com &" &
# 在推送前先確認該 SSH 通道是開放的。
echo Waiting 5 seconds before pushing image.
echo 5...
sleep 1
echo 4...
sleep 1
echo 3...
sleep 1
echo 2...
sleep 1
echo 1...
sleep 1
# Push image onto remote registry / repo
echo Starting push!
docker push localhost:5000/username/docker-test
如果你不理解這其中的含義,請先仔細閱讀這部分第二部分。
給指令碼加上執行許可權。
使用rake將以上所有綁定
現在的情況是,每次你想要部署你的應用時,你都需要單獨運行這三個指令碼。
clean
build
deploy / push
這一點都不費工夫,可是事實上開發人員比你想象的要懶得多!那麼咱們就索性再懶一點!
我們最後再把工作好好整理一番,我們現在要將三個指令碼通過rake捆綁在一起。
為了更簡單一點,你可以在工程根目錄下已經存在的Rakefile中添加幾行代碼,開啟Rakefile檔案,把下列內容粘貼進去。
?
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
namespace :docker do desc "Remove docker container" task :clean do sh './clean.sh' end desc "Build Docker image" task :build => [:clean] do sh './build.sh' end desc "Deploy Docker image" task :deploy => [:build] do sh './deploy.sh' end end |
即使你不清楚rake的文法(其實你真應該去瞭解一下,這玩意太酷了!),上面的內容也是很顯然的吧。我們在一個命名空間(docker)裡聲明了三個任務。
三個任務是:
rake docker:clean
rake docker:build
rake docker:deploy
Deploy獨立於build,build獨立於clean。所以每次我們輸入命令啟動並執行時候。
?
所有的指令碼都會按照順序執行。
測試
現在我們來看看是否一切正常,你只需要在app的代碼裡做一個小改動:
?
接下來就是見證奇蹟的時刻了。一旦鏡像檔案被上傳(第一次可能花費較長的時間),你就可以ssh登入產品伺服器,並且(通過SSH管道)把docker鏡像拉取到伺服器並運行了。多麼簡單!
也許你需要一段時間來習慣,但是一旦成功,它幾乎與用Heroku部署一樣簡單。
備忘:像往常一樣,請讓我瞭解到你的意見。我不敢保證這種方法是最好,最快,或者最安全的Docker開發的方法,但是這東西對我們確實奏效。