Cloud Foundry buildpack開發部署實例解析

基本原理

CF運行應用的基本過程是將用戶發佈的應用程序包解壓開，而後將本身的全部buildpack拿來，按照指定順序與程序包進行匹配，直到找到第一個可以運行這些代碼的buildpack，而後將buildpack也解開，與這些應用代碼打成一個包（即droplet），在按照指定的運行環境參數生成容器，將droplet扔進去，按照buildpack指定的啓動命令，啓動應用。在上面的過程當中，buildpack實現了三步功能： 
第一步，detect：檢查當前應用程序包是否可以用本buildpack支持運行，好比，java buildpack發現WEB-INF路徑就認爲本身可以運行它。 
第二步，compile：將應用程序包與buildpack包水乳交融一下，好比將java程序包放到tomcat的應用目錄下，而後替換某些參數，好比將當前dea裏的隨機端口賦予這個tomcat實例。 
第三部，release：將droplet啓動，好比運行tomcat的startup.sh。 
任何一個buildpack都有一個bin路徑，放着三個指定名字（detect、compile、release）的腳本（任何dea的os能執行的腳本均可以），而後具體的實現邏輯就從這裏觸發了。下面將以java buildpack爲例，經過三個實際需求，介紹buildpack的開發和使用。

自定義buildpack

更新java應用的默認時區和編碼

需求

國際軟件都使用格林尼治時間做爲系統中的默認時間，因此我們寫出的日誌或者使用程序代碼獲取的系統時間（其實都是dea的系統時間）都是+0000的，而咱們須要+0800的，固然，能夠從代碼裏自行處理。可是個人用戶們不爽，他們說我這程序還要本地測視呢，太亂了，你得給我處理。 
tomcat裏的默認編碼應該都是utf8，但是，在某些場景下，好比tomcat上運行的rest服務，其報文中包含中文，是沒法被正常接收的。CF的java buildpack裏包含的就是默認的tomcat，因此爲了解決這個問題，可使用下面的命令進行設置，可是畢竟不大爽，仍是直接改掉buildpack比較友好。

cf set-env appname CATALINA_OPTS "$CATALINA_OPTS -Dfile.encoding=UTF-8"

解決方案

java buildpack是ruby寫的，因此若是不是原則性的上的變更，大能夠經過將壓縮包打開，修改ruby代碼，而後再壓縮上的辦法。不過，winrar彷佛有些莫名其妙的問題，若是是解壓開再壓縮會有問題，可是若是直接將修改後的同名文件拖動到winrar的窗口中進行替換，就能夠工做。爲了達到時區和編碼這兩個需求，須要作的文件修改以下：

在java-buildpack-offline-v#.#.#\lib\java_buildpack\component\java_opts.rb 
中增長兩個方法：

# @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調用

@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

修改後，將這兩個文件替換到原來的離線buildpack包裏，而後將其發佈到CF中，查看當前buildpack狀況：

cf buidlpacks

而後，建立新的buildpack，其中最後一個參數決定了cf查看buildpack符合應用的順序，須要根據實際狀況調整。

cf create-buildpack java_buildpack_with_gmt0800_offline d:\somedir\java-buildpack-with-gmt0800-offline-v2.4.zip 1

若是是更新的話，使用cf update-buildpack。

使用應用程序包的tomcat

需求

有些應用，尤爲是作產品的公司作的，會對tomcat進行必定的剪裁，這樣的應用遷移到cf上時，很是痛苦。簡單的辦法就是，本身作個buildpack，提供的只是jre。

解決方案

假定這個產品的標識是LiveBOS，在程序包的第一層路徑下就有一個LiveBOS文件夾：

在java-buildpack-with-livebos-offline-v#.#\lib\java_buildpack\container\裏添加一個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"

後面就是打包發佈了。

更換buildpack中的jre

需求

有些應用只能使用特定版本的jre，若是這jre比較新還好辦，可是若是是舊的，好比1.6，那如今cf中能找到的buildpack就全不支持了。另外，也有可能應用要求使用oracle jre（cf中默認是open jre）。

解決方案

開始以前，建議你們不要在windows上嘗試這個編譯過程，基本沒有成功的可能，隨便找個能上網能運行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，將下面這行裏的內容更新爲一個本地tomcat的地址：

repository_root: http://localhost:8080/myapp

在本地的myapp下放一個index.yml文件，其中放上相似下列內容的oracle jre下載地址，若是oracle網站上已經找不到了，就也放在本地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

最後，固然仍是發佈到cf上。