自動化部署基於 Docker 的 Rails 應用
[TL;DR] 這是系列文章的第三篇,講述了我的公司是如何將基礎設施從PaaS移植到Docker上的。
在系列文章的最後一篇里,我們將用一個實例來學習如何自動化整個部署過程。
基本的Rails應用程序
現在讓我們啟動一個基本的Rails應用。為了更好的展示,我使用Ruby 2.2.0和Rails 4.1.1
在終端運行:
$ rvm use 2.2.0
$ rails new && cd docker-test
創建一個基本的控制器:
$ rails g controller welcome index
……,然後編輯 routes.rb
,以便讓該項目的根指向我們新創建的welcome#index方法:
root '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已經啟動並在運行當中):
$ docker build -t localhost:5000/your_username/docker-test .
然後,如果一切正常,長長的日誌輸出的最後一行應該類似於:
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
讓我們運行一下容器試試!
$ 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 "<none>" | awk '{print $3}' | xargs docker rmi
給腳本加上執行許可權:
$ chmod +x clean.sh
構建
構建的過程基本上和之前我們所做的(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文件,把下列內容粘貼進去。
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。所以每次我們輸入命令運行的時候。
$ rake docker:deploy
所有的腳本都會按照順序執行。
測試
現在我們來看看是否一切正常,你只需要在app的代碼里做一個小改動:
$ rake docker:deploy
接下來就是見證奇蹟的時刻了。一旦鏡像文件被上傳(第一次可能花費較長的時間),你就可以ssh登錄產品伺服器,並且(通過SSH管道)把docker鏡像拉取到伺服器並運行了。多麼簡單!
也許你需要一段時間來習慣,但是一旦成功,它幾乎與用Heroku部署一樣簡單。
備註:像往常一樣,請讓我了解到你的意見。我不敢保證這種方法是最好,最快,或者最安全的Docker開發的方法,但是這東西對我們確實奏效。
via: http://cocoahunter.com/2015/01/23/docker-3/
作者:Michelangelo Chasseur 譯者:DongShuaike 校對:wxy
本文轉載來自 Linux 中國: https://github.com/Linux-CN/archive