CloudFoundry buildpack開發(fā)部署詳解
與service broker相比，buildpack的實(shí)務(wù)操作就容易多了，單就通用概念來(lái)說(shuō)，其實(shí)用不著單寫一篇，但是處女座強(qiáng)迫癥發(fā)作，所以還是寫一下，使CF這個(gè)框架對(duì)外擴(kuò)展的兩個(gè)維度(代碼使用的服務(wù)和代碼運(yùn)行的環(huán)境)是完整的。這篇主要會(huì)寫buildpack的基本實(shí)現(xiàn)邏輯，然后舉三個(gè)需要修改 buildpack的需求，進(jìn)行實(shí)際操作描述 。
基本原理
CF運(yùn)行應(yīng)用的基本過(guò)程是將用戶發(fā)布的應(yīng)用程序包解壓開，然后將自己的所有buildpack拿來(lái)，按照指定順序與程序包進(jìn)行匹配，直到找到第一個(gè)能夠運(yùn)行這些代碼的buildpack，然后將buildpack也解開，與這些應(yīng)用代碼打成一個(gè)包(即droplet)，在按照指定的運(yùn)行環(huán)境參數(shù)生成容器，將droplet扔進(jìn)去，按照buildpack指定的啟動(dòng)命令，啟動(dòng)應(yīng)用。在上面的過(guò)程中，buildpack實(shí)現(xiàn)了三步功能：
第一步，detect：檢查當(dāng)前應(yīng)用程序包是否能夠用本buildpack支持運(yùn)行，比如，java buildpack發(fā)現(xiàn)WEB-INF路徑就認(rèn)為自己能夠運(yùn)行它。
第二步，compile：將應(yīng)用程序包與buildpack包水乳交融一下，比如將java程序包放到tomcat的應(yīng)用目錄下，然后替換某些參數(shù)，比如將當(dāng)前dea里的隨機(jī)端口賦予這個(gè)tomcat實(shí)例。
第三部，release：將droplet啟動(dòng)，比如運(yùn)行tomcat的startup.sh。
任何一個(gè)buildpack都有一個(gè)bin路徑，放著三個(gè)指定名字(detect、compile、release)的腳本(任何dea的os能執(zhí)行的腳本都可以)，然后具體的實(shí)現(xiàn)邏輯就從這里觸發(fā)了。下面將以java buildpack為例，通過(guò)三個(gè)實(shí)際需求，介紹buildpack的開發(fā)和使用。
自定義buildpack
更新java應(yīng)用的默認(rèn)時(shí)區(qū)和編碼
需求
國(guó)際軟件都使用格林尼治時(shí)間作為系統(tǒng)中的默認(rèn)時(shí)間，所以咱們寫出的日志或者使用程序代碼獲取的系統(tǒng)時(shí)間(其實(shí)都是dea的系統(tǒng)時(shí)間)都是+0000 的，而我們需要+0800的，當(dāng)然，可以從代碼里自行處理。但是我的用戶們不爽，他們說(shuō)我這程序還要本地測(cè)視呢，太亂了，你得給我處理。
tomcat里的默認(rèn)編碼應(yīng)該都是utf8，可是，在某些場(chǎng)景下，比如tomcat上運(yùn)行的rest服務(wù)，其報(bào)文中包含中文，是無(wú)法被正常接收的。CF的 java buildpack里包含的就是默認(rèn)的tomcat，所以為了解決這個(gè)問(wèn)題，可以使用下面的命令進(jìn)行設(shè)置，但是畢竟不大爽，還是直接改掉 buildpack比較友好。
- cf set-env appname CATALINA_OPTS "$CATALINA_OPTS -Dfile.encoding=UTF-8"
解決方案
java buildpack是ruby寫的，所以如果不是原則性的上的變動(dòng)，大可以通過(guò)將壓縮包打開，修改ruby代碼，然后再壓縮上的辦法。不過(guò)，winrar 似乎有些莫名其妙的問(wèn)題，如果是解壓開再壓縮會(huì)有問(wèn)題，但是如果直接將修改后的同名文件拖動(dòng)到winrar的窗口中進(jìn)行替換，就可以工作。為了達(dá)到時(shí)區(qū)和編碼這兩個(gè)需求，需要做的文件修改如下：
在java-buildpack-offline-v#.#.#\lib\java_buildpack\component\java_opts.rb中增加兩個(gè)方法：
- # @return [JavaOpts] +self+-Duser.timezone
- def add_timezone(value)
- self << "-Duser.timezone=#{value}"
- self
- end
- # @return [JavaOpts] +self+-Dfile.encoding
- def add_fileencode(value)
- self << "-Dfile.encoding=#{value}"
- self
- end
在java-buildpack-offline-v#.#.#\lib\java_buildpack\jre\open_jdk_like.rb中，修改release方法，增加add_timezone和add_fileencode調(diào)用
- @droplet.java_opts
- .add_system_property('java.io.tmpdir', '$TMPDIR')
- .add_option('-XX:OnOutOfMemoryError', killjava)
- .add_timezone('GMT+08')
- .add_fileencode('UTF-8')
- .concat memory
修改后，將這兩個(gè)文件替換到原來(lái)的離線buildpack包里，然后將其發(fā)布到CF中，查看當(dāng)前buildpack情況：
- cf buidlpacks
然后，創(chuàng)建新的buildpack，其中最后一個(gè)參數(shù)決定了cf查看buildpack符合應(yīng)用的順序，需要根據(jù)實(shí)際情況調(diào)整。
- cf create-buildpack java_buildpack_with_gmt0800_offline d:\somedir\java-buildpack-with-gmt0800-offline-v2.4.zip 1
如果是更新的話，使用cf update-buildpack。
#p#
使用應(yīng)用程序包的tomcat
需求
有些應(yīng)用，尤其是做產(chǎn)品的公司做的，會(huì)對(duì)tomcat進(jìn)行一定的剪裁，這樣的應(yīng)用遷移到cf上時(shí)，非常痛苦。簡(jiǎn)單的辦法就是，自己做個(gè)buildpack，提供的只是jre。
解決方案
假定這個(gè)產(chǎn)品的標(biāo)識(shí)是LiveBOS，在程序包的第一層路徑下就有一個(gè)LiveBOS文件夾：
在java-buildpack-with-livebos-offline-v#.#\lib\java_buildpack\container\里添加一個(gè)libe_bos.rb：
- # Encoding: utf-8
- # Cloud Foundry Java Buildpack
- # Copyright 2013 the original author or authors.
- #
- # Licensed under the Apache License, Version 2.0 (the "License");
- # you may not use this file except in compliance with the License.
- # You may obtain a copy of the License at
- #
- # http://www.apache.org/licenses/LICENSE-2.0
- #
- # Unless required by applicable law or agreed to in writing, software
- # distributed under the License is distributed on an "AS IS" BASIS,
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- # See the License for the specific language governing permissions and
- # limitations under the License.
- require 'java_buildpack/container'
- require 'java_buildpack/container/dist_zip_like'
- require 'java_buildpack/util/dash_case'
- module JavaBuildpack
- module Container
- # Encapsulates the detect, compile, and release functionality for +LiveBOS+ style applications.
- class LiveBOS < JavaBuildpack::Container::DistZipLike
- # Creates an instance
- #
- # @param [Hash] context a collection of utilities used the component
- def initialize(context)
- super(context)
- end
- # (see JavaBuildpack::Component::BaseComponent#compile)
- def compile
- startup.chmod 0755
- end
- # (see JavaBuildpack::Component::BaseComponent#release)
- def release
- @droplet.java_opts.add_system_property 'http.port', '$PORT'
- [
- @droplet.java_home.as_env_var,
- @droplet.java_opts.as_env_var,
- qualify_path(catalina, @droplet.root),
- 'run'
- ].flatten.compact.join(' ')
- end
- protected
- # (see JavaBuildpack::Container::DistZipLike#id)
- def id
- LiveBOS.to_s.dash_case
- end
- # (see JavaBuildpack::Container::DistZipLike#supports?)
- def supports?
- livebos? && catalina.exist?
- end
- private
- def startup
- candidates = (root + 'bin/startup.sh').glob
- candidates.size == 1 ? candidates.first : nil
- end
- def catalina
- candidates = (root + 'bin/catalina.sh').glob
- candidates.size == 1 ? candidates.first : nil
- end
- def livebos?
- (root + 'LiveBos').exist?
- end
- end
- end
- end
在java-buildpack-with-livebos-offline-v2.4\config\components.yml的containers下面添加：
- - "JavaBuildpack::Container::LiveBOS"
后面就是打包發(fā)布了。
更換buildpack中的jre
需求
有些應(yīng)用只能使用特定版本的jre，如果這jre比較新還好辦，但是如果是舊的，比如1.6，那現(xiàn)在cf中能找到的buildpack就全不支持了。另外，也有可能應(yīng)用要求使用oracle jre(cf中默認(rèn)是open jre)。
解決方案
開始之前，建議大家不要在windows上嘗試這個(gè)編譯過(guò)程，基本沒有成功的可能，隨便找個(gè)能上網(wǎng)能運(yùn)行ruby的linux吧。
修改java-buildpack-offline-v2.4\config\components.yml，將不使用的jre注釋掉：
- - "JavaBuildpack::Jre::OpenJdkJRE"
- - "JavaBuildpack::Jre::OracleJRE"
修改java-buildpack-offline-v2.4\config\oracle_jre.yml，將下面這行里的內(nèi)容更新為一個(gè)本地tomcat的地址：
- repository_root: http://localhost:8080/myapp
在本地的myapp下放一個(gè)index.yml文件，其中放上類似下列內(nèi)容的oracle jre下載地址，如果oracle網(wǎng)站上已經(jīng)找不到了，就也放在本地tomcat上吧。
- ---
- 1.7.0_01: http://download.run.pivotal.io/openjdk/centos6/x86_64/openjdk-1.7.0_01.tar.gz
- ......
- 1.8.0_M6: http://download.run.pivotal.io/openjdk/centos6/x86_64/openjdk-1.8.0_M6.tar.gz
然后，就可以編譯打包了。
- bundle install
- bundle exec rake package OFFLINE=true
- ...
- Creating build/java-buildpack-offline-cfd6b17.zip
最后，當(dāng)然還是發(fā)布到cf上。
博文出處：http://blog.csdn.net/cloudguru/article/details/45026873
