`
jamie.wang
  • 浏览: 347622 次
  • 性别: Icon_minigender_1
  • 来自: 成都
社区版块
存档分类
最新评论

java-buildpack源码分析之Detect

阅读更多

Detect

该buildpack的探测的内容包含:容器,JRE,框架。具体内容在components.yml中可以看到:

# Configuration for components to use in the buildpack
---
containers:
- "JavaBuildpack::Container::DistZip"
- "JavaBuildpack::Container::Groovy"
- "JavaBuildpack::Container::JavaMain"
- "JavaBuildpack::Container::PlayFramework"
- "JavaBuildpack::Container::Ratpack"
- "JavaBuildpack::Container::SpringBoot"
- "JavaBuildpack::Container::SpringBootCLI"
- "JavaBuildpack::Container::Tomcat"
# In order to use Oracle JREs instead of OpenJDK, you must comment out the OpenJDK line and uncomment the Oracle line.
# Please see the documentation for more detail.
jres:
- "JavaBuildpack::Jre::OpenJdkJRE"
# - "JavaBuildpack::Jre::OracleJRE"
frameworks:
- "JavaBuildpack::Framework::AppDynamicsAgent"
- "JavaBuildpack::Framework::JavaOpts"
- "JavaBuildpack::Framework::MariaDbJDBC"
- "JavaBuildpack::Framework::NewRelicAgent"
- "JavaBuildpack::Framework::PlayFrameworkAutoReconfiguration"
- "JavaBuildpack::Framework::PlayFrameworkJPAPlugin"
- "JavaBuildpack::Framework::PostgresqlJDBC"
- "JavaBuildpack::Framework::SpringAutoReconfiguration"
- "JavaBuildpack::Framework::SpringInsight"

 由该文件可以知道该buidpack支持的容器,JRE和框架。当然你可以自己添加。

detect的入口是bin/detect,该脚本非常简单,调用JavaBuildpack的with_buildpack静态方法创建实例,然后在代码块里调用JavaBuildpack.detect方法。最后将detect的结果组成一个字符串输出,如果探测不对,则什么也不输出。

components = JavaBuildpack::Buildpack.with_buildpack(build_dir, 'Detect failed with exception %s') do |buildpack| # 这里with_buildpack创建了一个JavaBuildpack::Buildpack的实例,查看buildpack.rb可以看到
  buildpack.detect
end.compact

 接下来看JavaBuildpack::Buildpack类,在buildpack.rb中。

with_buildpack方法

是在class << self中的,因此它是一个静态方法,在看方法定义:
def with_buildpack(app_dir, message)
    app_dir = Pathname.new(File.expand_path(app_dir))  # app_dir变成一个Pathname实例
    application = Component::Application.new(app_dir)  # 创建application实例
    Logging::LoggerFactory.instance.setup app_dir # 初始化日志
    yield new(app_dir, application) if block_given? # **创建一个对象,并且调用外部给的代码块**
  rescue => e
    handle_error(e, message)
end
 特别注意其中注释加**的那句,语法比较绕

detect方法

detect方法分别对应用使用的容器,JRE,框架探测

def detect
  tags = tag_detection('container', @containers, true)
  tags.concat tag_detection('JRE', @jres, true) unless tags.empty? # 如果不为空则连接tags
  tags.concat tag_detection('framework', @frameworks, false) unless tags.empty?
  tags << "java-buildpack=#{@buildpack_version.to_s false}" unless tags.empty? # 加上buildpack版本
  tags = tags.flatten.compact.sort
  @logger.debug { "Detection Tags: #{tags}" }
  tags
end

 

detection方法

调用每个组件的detect方法,这些其实是子组件(如:容器大项中的tomcat子项),并将结果集合返回。

def detection(type, components, unique)
  detected = []
  tags = []
  components.each do |component|
    result = component.detect
    next unless result # 如果结果不为空则跳出循环
    detected << component
    tags << result
  end
  fail "Application can be run by more than one #{type}: #{names detected}" if unique && detected.size > 1
  [detected, tags]
end

 

具体项目的detect方法

这里重点关注下tomcat的detect方法,tomcat.rb

tomcat的类定义:

class Tomcat < JavaBuildpack::Component::ModularComponent

初始化方法

def initialize(context, &version_validator)
  super(context, &version_validator)
  @sub_components = supports? ? sub_components(context) : [] # tomcat支持吗?,如果支持,初始化子项目,注意:这里两个问号,前一个是方法support?后一个是问号表达式
end

 可以知道Tomcat是继承自ModularComponent,detect方法是在ModularComponent中定义的,

def detect
  supports? ? @sub_components.map(&:detect).flatten.compact : nil # 如果支持探测子项目
end

 

tomcat的support?方法

def supports?
  web_inf? && !JavaBuildpack::Util::JavaMainUtils.main_class(@application) # WEB-INF目录存在,且不存在Main方法
end
private
def web_inf?
  (@application.root + 'WEB-INF').exist? # 其实检查的是,WEB-INF目录是否存在
end

 再看子项目有哪些?

def sub_components(context)
  [
  TomcatInstance.new(sub_configuration_context(context, 'tomcat')),
  TomcatLifecycleSupport.new(sub_configuration_context(context, 'lifecycle_support')),
  TomcatLoggingSupport.new(sub_configuration_context(context, 'logging_support')),
  TomcatAccessLoggingSupport.new(sub_configuration_context(context, 'access_logging_support')),
  TomcatRedisStore.new(sub_configuration_context(context, 'redis_store')),
  TomcatInsightSupport.new(context)
  ]
end

 

TomcatInstance的detect

先从配置文件config/tomcat.yml中找到tomcat的版本及下载路径

tomcat:
version: 8.0.+
repository_root: "{default.repository.root}/tomcat"

 然后从repository_root(默认是:https://download.run.pivotal.io/) 下载tomcat/index.yml,该文件包含了所有版本的tomcat的下载路径,找到具体的版本,如:8.0+指,8.0以上的版本,找到了8.0.14。

需要说明的是:

tomcat支持之后,TomcatInstance是默认支持的,因为tomcat instance就是基本的tomcat包, TomcatLifecycleSupport,TomcatLoggingSupport,TomcatAccessLoggingSupport也是默认支持的。

如果需要会话共享,复制,设置了service环境变量,TomcatRedisStore则是支持的。

而TomcatInsightSupport尚不支持

分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics