第 8 章 规则手册激活
规则手册是一组条件规则,即 Event-Driven Ansible 用来在事件驱动的自动化模型中执行 IT 操作。规则手册是用户告诉 Event-Driven Ansible 哪个源检查某个事件,并在满足特定条件时该事件发生什么时。
规则手册指定触发规则时要执行的操作。当事件与规则条件匹配时,会触发规则。目前支持以下操作:
-
run_playbook
(仅支持 ansible-rulebook CLI) -
run_module
-
run_job_template
-
run_workflow_template
-
set_fact
-
post_event
-
retract_fact
-
print_event
-
shutdown
-
debug
-
none
要查看更多详细信息,请参阅 Actions。
规则手册激活是由执行特定规则手册的决策环境定义的后台运行的进程。您可以按照设置规则手册激活 来设置规则手册激活。
红帽不推荐使用带有 1 postgres 数据库的不支持的源插件。这可能会给您使用 Ansible Automation Platform 带来潜在的风险。
为满足高可用性需求,Event-Driven Ansible 控制器通过 Ansible Automation Platform UI 共享集中式 Redis (REmote DIctionary Server)。当 Redis 不可用时,以下功能将不可用:
-
如果
is_enabled
为 True,则创建激活 - 删除激活
- 启用激活(如果还没有启用)
- 禁用激活(如果还没有禁用)
- 重启激活
8.1. 设置规则手册激活
先决条件
- 以 Content Consumer 用户身份登录 Ansible Automation Platform Dashboard。
- 您已设置了一个项目。
- 您已设置了决策环境。
流程
- 登录到 Ansible Automation Platform。
-
导航到
。 - 点 。
插入以下内容:
- 名称
- 插入名称。
- 描述
- 此字段是可选的。
- 机构(Organization)
- 输入您的机构名称,或者从列表中选择 Default。
- 项目
- 项目是规则手册的逻辑集合。此字段是可选的。
- 规则手册
- 规则手册会根据所选的项目显示。
- 凭证
为此规则手册激活选择 0 或更多凭证。此字段是可选的。
注意- 此字段中显示的凭证根据您的规则激活自定义,仅包含以下凭证类型:Vault、Red Hat Ansible Automation Platform 或您创建的任何自定义凭证类型。有关凭证的更多信息,请参阅 凭证。
- 如果您计划使用 Red Hat Ansible Automation Platform 凭证,则只能为 规则手册激活选择 1 Red Hat Ansible Automation Platform 凭证类型。
- 决策环境
决策环境是一个容器镜像,用于运行 Ansible 规则手册。
注意在 Event-Driven Ansible 控制器中,您无法自定义决策环境的拉取策略。默认情况下,它遵循 always 策略的行为。每次启动激活时,系统会尝试拉取镜像的最新版本。
- 重启策略
这是决定在运行源插件的容器进程结束后激活应如何重启的策略。
策略:
- Always :这会立即重新启动规则手册激活,无论它是否成功结束,并且不会超过 5 次。
- Never :当容器进程结束时,这永远不会重启规则手册激活。
- 失败时,这会默认在 60 秒后重启规则手册激活,只有在容器进程失败时,才会发生超过 5 次。
- 日志级别
此字段定义您记录的事件中的严重性和类型。
levels:
- 错误: 包含激活 History 选项卡中显示的错误消息的日志。
- info :包含有关规则手册激活的有用信息的日志,如成功或失败、触发的操作名称及其关联的操作事件以及错误。
- debug :包含仅在 debug 阶段有用的信息的日志,在生产期间可能只有较少的值。 此日志级别包括 error 和 log level data。
- 服务名称
- 这定义了 Kubernetes 的服务名称,以便在激活公开端口时配置入站连接。此字段是可选的。
- 启用规则手册激活?
- 这会自动启用规则手册激活来运行。
- 变量
-
规则手册的变量采用 JSON 或 YAML 格式。内容等同于通过 ansible-rulebook 命令的
--vars
标志传递的文件。 - 选项
- 如果您不想在 Rule Audit 中看到您的 事件,请检查 Skip audit 选项。
- 点 。
现在,您的规则手册激活已创建,可以在 Rulebook Activations 页面上管理。
保存新的 rulebook 激活后,会显示 rulebook 激活的详情页面,并显示 Pending、Running 或 Failed 状态。从 there 或 Rulebook Activations 列表视图中,您可以重启或删除它。
有时,当源插件关闭时,它会导致规则手册在一定时间后安全退出。当规则手册激活关闭时,任何等待执行的任务都会被取消,并将信息级别消息发送到激活日志。如需更多信息,请参阅 规则手册。