4 资源代理结构
一个典型的（基于shell的）资源代理有一些标准的结构元素。本章将按顺序说明。在说明里将描述资源代理每一个支持的行为的细节内容。本章将以一个假想的foobar函数为例子。
4.1 资源代理解释器
每个资源代理都以标准的“shebang”（#!）抬头
#!/bin/sh
如果资源代理使用shell编写，最好是指定通用的shell解释器（#!/bin/sh），但也不强求。使用/bin/sh 兼容的资源代理一定不要使用某种特别shell的方言（如bash中的 ${!variable}），建议对资源代理使用检查器检查一下，如checkbashisms。
有人考虑使用一个patch来使得之前的sh兼容的资源代理只用于bash、ksh或者其他的非通用shell。然而，对于新完成的资源代理，最好显式的定义一个指定的shell解释器，比如/bin/bash。
4.2 作者和授权信息
资源代理应该包含一段注释，来说明作者和版权信息，并说明资源代理的授权信息，如：
如果资源代理的使用的授权有不同版本，缺省可假设是当前版本。
4.3 初始化
任何 shell 资源代理都应该 运行 .ocf_shellfuncs 函数库。按下面的语法，如$OCF_FUNCTION_DIR，这里是为了测试和写文档，这个变量也许重复定义了。
4.4 资源行为的函数实现
下面将说明的是资源代理公布的行为的函数实现。每个行为的细节将在第五章描述。
4.5 执行块
下面是一个资源代理实际执行时的部分代码。通常遵循如下的标准结构：
有人考虑使用一个patch来使得之前的sh兼容的资源代理只用于bash、ksh或者其他的非通用shell。然而，对于新完成的资源代理，最好显式的定义一个指定的shell解释器，比如/bin/bash。
4.2 作者和授权信息
资源代理应该包含一段注释，来说明作者和版权信息，并说明资源代理的授权信息，如：
# # Resource Agent for managing foobar resources. # # License: GNU General Public License (GPL) # (c) 2008-2010 John Doe, Jane Roe, # and Linux-HA contributors
如果资源代理的使用的授权有不同版本，缺省可假设是当前版本。
4.3 初始化
任何 shell 资源代理都应该 运行 .ocf_shellfuncs 函数库。按下面的语法，如$OCF_FUNCTION_DIR，这里是为了测试和写文档，这个变量也许重复定义了。
# Initialization:
: ${OCF_FUNCTIONS_DIR=${OCF_ROOT}/lib/heartbeat}
. ${OCF_FUNCTIONS_DIR}/ocf-shellfuncs
4.4 资源行为的函数实现
下面将说明的是资源代理公布的行为的函数实现。每个行为的细节将在第五章描述。
4.5 执行块
下面是一个资源代理实际执行时的部分代码。通常遵循如下的标准结构：
# Make sure meta-data and usage always succeed
case $__OCF_ACTION in
meta-data) foobar_meta_data
exit $OCF_SUCCESS
;;
usage|help) foobar_usage
exit $OCF_SUCCESS
;;
esac
# Anything other than meta-data and usage must pass validation
foobar_validate_all || exit $?
# Translate each action into the appropriate function call
case $__OCF_ACTION in
start) foobar_start;;
stop) foobar_stop;;
status|monitor) foobar_monitor;;
promote) foobar_promote;;
demote) foobar_demote;;
reload) ocf_log info "Reloading..."
foobar_start
;;
validate-all) ;;
*) foobar_usage
exit $OCF_ERR_UNIMPLEMENTED
;;
esac
rc=$?
# The resource agent may optionally log a debug message
ocf_log debug "${OCF_RESOURCE_INSTANCE} $__OCF_ACTION returned $rc"
exit $rc
