如何在Puppet Apply中通过Biemond OraWLS模块返回自定义退出码并按需重启WebLogic？

针对你使用biemond/orawls模块遇到的两个问题，我整理了实用的解决思路：

一、只在必要时重启WebLogic Server #

当前每次变更就重启的做法确实没必要，WebLogic只有特定配置（比如修改监听端口、调整JVM参数、更改数据源核心配置等）才需要重启。你可以通过以下方式实现精准重启：

1. 利用模块内置状态标识 #

先检查biemond/orawls模块是否提供了内置的重启判断机制：

• 部分版本的模块会在资源变更后，生成自定义事实（比如orawls_requires_restart），标记哪些配置变更触发了重启需求。你可以在Puppet代码中通过$facts['orawls_requires_restart']获取这个状态，作为重启操作的前置条件。

2. 自定义WLST脚本判断重启需求 #

如果模块没有内置支持，写一个简单的WLST脚本调用WebLogic API检查挂起变更：

# check_restart_needed.py
connect('admin_user', 'admin_pass', 't3://admin-server:7001')
domainRuntime()
restart_required = cmo.isRestartRequired()
disconnect()
exit(0 if restart_required else 1)

然后在Puppet的重启资源中用onlyif调用这个脚本：

exec { 'restart_weblogic':
  command     => '/opt/oracle/wls/bin/stopWebLogic.sh && /opt/oracle/wls/bin/startWebLogic.sh',
  onlyif      => '/usr/bin/java -jar /opt/oracle/wls/wlserver/server/lib/weblogic.jar /path/to/check_restart_needed.py',
  refreshonly => true,
  subscribe   => OraWls::Domain['my_weblogic_domain'],
}

这样只有当WLST检测到确实需要重启时，才会触发重启操作。

3. 监控关键配置文件的变更 #

WebLogic的核心配置（比如$DOMAIN_HOME/config/config.xml）变更通常需要重启，你可以对比文件修改时间和上次重启时间来判断：

file { '/var/run/weblogic_last_restart':
  ensure  => file,
  content => "${timestamp}",
  require => Exec['restart_weblogic'],
}

exec { 'restart_weblogic':
  command     => '/path/to/restart_script.sh && touch /var/run/weblogic_last_restart',
  onlyif      => 'test /opt/oracle/domains/my_domain/config/config.xml -nt /var/run/weblogic_last_restart',
  refreshonly => true,
  subscribe   => OraWls::All_config_resources['*'],
}

二、在Puppet Apply中返回自定义退出码 #

Puppet默认的退出码规则是：

• 0：执行成功，无任何变更
• 1：执行失败
• 2：执行成功，有变更

要返回自定义退出码，你可以通过以下两种方式实现：

1. 使用exec资源返回自定义码 #

在Puppet代码中添加一个exec资源，当特定条件满足时返回自定义退出码，同时用returns参数允许该码作为成功状态：

# 示例：当需要重启时返回退出码42
exec { 'return_custom_restart_code':
  command     => 'exit 42',
  onlyif      => '/usr/bin/java -jar /opt/oracle/wls/wlserver/server/lib/weblogic.jar /path/to/check_restart_needed.py',
  returns     => [0, 42], # 允许0和42作为合法的成功退出码
  refreshonly => true,
  subscribe   => OraWls::Domain['my_weblogic_domain'],
}

执行Puppet Apply后，你可以通过$?环境变量获取这个exec的退出码（如果触发的话）。

2. 修改模块Provider（进阶方案） #

如果你有权限修改biemond/orawls模块的Ruby代码，可以在资源的flush方法中，当特定变更发生时直接设置自定义退出码。比如在模块的provider文件中添加：

def flush
  # 保留原有业务逻辑...
  if @property_hash[:ensure] == :present && change_requires_restart?
    Puppet.exit(42) # 返回自定义退出码42
  end
end

这种方式更直接，但需要你熟悉Puppet的Ruby开发规范。

内容的提问来源于stack exchange，提问作者Indra Yadav