這篇文章主要介紹了在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方法:
?
1 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已經啟動並在運行當中):
?
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 "
給腳本加上執行權限:
?
1 $ 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 [email protected] &" &
# 在推送前先確認該 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。所以每次我們輸入命令運行的時候。
?
1 $ rake docker:deploy所有的腳本都會按照順序執行。
測試
現在我們來看看是否一切正常,你只需要在app的代碼裡做一個小改動:
?
1 $ rake docker:deploy接下來就是見證奇跡的時刻了。一旦鏡像文件被上傳(第一次可能花費較長的時間),你就可以ssh登錄產品服務器,並且(通過SSH管道)把docker鏡像拉取到服務器並運行了。多麼簡單!
也許你需要一段時間來習慣,但是一旦成功,它幾乎與用Heroku部署一樣簡單。
備注:像往常一樣,請讓我了解到你的意見。我不敢保證這種方法是最好,最快,或者最安全的Docker開發的方法,但是這東西對我們確實奏效。