BootAgent 实现

简介

用来管理上述列表中最基本的 Agent，提供基本的功能。通过最简单的方式与服务端进行通讯，也就是利用 HTTP/1.2 短链接与服务端通讯，只提供简单的 PUSH 机制，由 BootAgent 主动发起。

实现功能

其中主要功能点包括了。

1. 任务管理。
   1.1 子Agent安装。
   1.2 修改配置。
2. 子进程管理。
   2.1 子Agent退出自动拉起。
   2.2 子Agent资源限制。
3. 事件上报机制。
   3.1 子进程异常。

如果任务执行失败，只能等待下次 BootAgent 上报数据时处理。

其它

BootAgent 在启动时通过判断是否存在 MetaFile 来决定是否为第一次启动。

开发调试

编译工程

$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DBOOT_SERVER_ADDR="booter.cargo.com:8080,192.168.9.1:9090"

打包

在源码目录下可以直接通过如下命令进行打包，其中入参是版本号。

$ ./contrib/package.sh BootAgent 1.2.1-1

REST-API 接口

启动注册接口

----- POST /agent/register
{
	"hostname": "127.0.0.1",
	"agentsn": "bfdcc18c-b6b9-4725-9c47-37fd93dba5b6"
}

----- 返回信息
{
	"status": 0,
	"agentsn": "dcb886e9-04ed-41bb-9c12-4d2de12cd59b",  # 如果上层判断有冲突，则返回合法的AgentSN
	"tags": "svc=ecs,cmpt=DB",
}

当第一次启动时会向服务端注册，此时服务端可以根据配置返回一些配置信息，Agent 会尝试持久化到配置文件中。

如果 Agent 因为某些原因失败，会尝试下次重试，此时上报的 AgentSN 可能会被修改，因此，只有当上报收到状态信息之后，才会被认为是合法的。

状态上报接口

----- POST /agent/status 上报当前Agent状态
{
	"hostname": "127.0.0.1",                                # 主机名
	"agentsn": "33c5b8b4-5a2c-43c5-ab90-96721451b4ec",      # AgentSN
	"version": "bootagent-1.2.4-x86_64",                    # BootAgent的版本号
	"uptime": 1234,                                         # 进程已经启动时间，单位秒
	"timestamp": 1232,                                      # 上报时的时间戳
	"step": 600,                                            # 上报的时间间隔，可以做修改，默认10min
	"agents": [{                                            # 当前主机Agent信息
		"name": "BasicAgent",                           # Agent名称，需要保证唯一
		"version": "1.2.3",                             # Agent当前版本号
		"status": "stoped",                             # Agent的状态
		"uptime": 123,                                  # 已经运行时间
	}],
	"jobs": [{                                              # 任务执行状态
		"id": "ddc8a9b9-55bd-4ddd-b53d-47095ee19466",   # 任务ID
		"errcode": 0,                                   # 统一错误码信息
		"message": "success"                            # 返回信息
	}],
}

----- 返回信息，可以包含请求
{
	"status": 2,                                           # 返回状态，0表示正常，目前直接忽略返回值
	"jobs": [{
		"id": "ddc8a9b9-55bd-4ddd-b53d-47095ee19466",  # 任务ID信息，由服务端指定，客户端上报执行结果时会带上
		"action": "install",                           # 指定任务操作，也开始是"upgrade" "uninstall" "restart" "stop"等
		"name": "BasicAgent",                          # 需要操作的子Agent名称
		"url": "ftp://server:port/BasicAgent/BasicAgent-0.1.0-0.x86_64.rpm",
		"checksum": "SHA256:4a34b8d7d3009bb9ef9475fbf33e7bbe4a1e8db003aefc578a241c2f51c2c2f2",
		"envs": {                                      # 运行时的环境变量，一般在初次安装时配置，可以每次更新
			"PATH": "/usr/bin;/usr/local/bin"
		},
		"limits": {                                    # 资源使用限制
			"CPU": "10%",
			"memory": "20M"
		}
	}, {
		"id": "ddc8a9b9-55bd-4ddd-b53d-47095ee19466",
		"action": "config",                            # 修改BootAgent的相关配置
		"svrlist": "192.168.9.1:1234,",                # 服务端列表，不会修改默认的列表
		"step": 1200,                                  # 状态上报时间间隔
	}]
}

备注:
    Agent状态
      * stoped 主动停止
      * running 正在运行
      * fatal 多次重试后失败
      * killed 资源超限等原因被强制杀死

TODO

1. 安全通讯。

测试用例

FAQ

命令行参数

-T
    用于测试当前的配置，而非真正运行，为了防止覆盖老日志，可以同时使用 -L 参数。

服务器地址

总共有三种方式指定服务器的地址，可以在列表中指定多个，其格式为 SVR1IP:PORT,SVR2IP 。

  1. 编译时通过 -DBOOT_SERVER_ADDR="booter.cargo.com,127.0.0.1:8090" 参数指定，该地址会编译到可执行文件中，会一直存在。
  2. 首次启动时通过 -S 指定(以后直接忽略)，该参数会持久化到 metafile 中，以后启动则忽略入参并直接使用 metafile 中的配置。
  3. 可以通过服务端进行修改，最终同样会持久化到 metafile 中。

所以，在实践中，应该尽量保证 <1> 中的服务器可用，可以是 HAProxy、LVS 之类的负载均衡地址，如果要修改只能通过升级完成。

注意，如果有重复的地址，是不会去重的。

Agent 重启策略

每隔 60s 检查一次，如果进程异常退出在 3min 内不会重启，如果在 15min 内异常则标记一次异常事件，当连续异常超过 3 次后则认为程序异常，不再尝试重启。

临时目录

为了保证配置文件的完整性，会先将文件写入到临时目录下的临时文件，然后通过 rename 操作保证原子性。

在编译时，需要保证配置文件的目录与临时目录在同一个挂载点，否则会报 Invalid cross-device link 的错误。

This Site was built by Rimond, generated with Jekyll, and hosted on GitHub Pages
©2013-2018 – Rimond