使用自动化决策

流程

1. 登录到 Ansible Automation Platform 仪表板。
2. 在导航面板中，选择 Automation Decisions → Infrastructure → Credentials。
3. 点 Create credential。

4. 插入以下内容：

   名称

   插入名称。

   描述

   此字段是可选的。

   机构（Organization）

   单击列表以选择一个机构，或选择 Default。

   凭证类型

   单击列表以选择您的凭据类型。

   注意

   当您选择凭证类型时，Type Details 部分会显示适用于您选择的凭证类型的字段。

5. 完成适用于您选择的凭证类型的字段。
6. 点 Create credential。

流程

1. 使用以下方法之一编辑凭证：

   • 在 Credentials 列表视图中，点所需凭证旁的 Edit credential 图标。
   • 从 Credentials 列表视图中，选择凭据的名称，单击 Edit credential。
2. 编辑正确详情并点 Save credential。

流程

1. 在 Credentials 列表页面中，点您要重复的凭证的名称。这会进入凭证的 Details 选项卡。

2. 点 Details 选项卡右上角的 Duplicate credential。

   注意

   您还可以点 Credentials 列表页面中所需凭证旁的 Duplicate credential 图标。

   此时会显示一条信息，确认您选择的凭证已被重复："<Name of credential> duplicated"。

3. 单击 Back to credentials 选项卡，以查看您刚才重复的凭证。

   显示重复的凭证名称与原始凭证的名称相同，后跟一个 24 小时格式的时间戳（例如，< Name of credential> @ 17:26:30）。

4. 编辑您喜欢重复凭证的详情。
5. 单击 Save credential。

流程

1. 使用以下方法之一删除凭证：

   • 在 Credentials 列表视图中，点击所需凭证旁的 More Actions 图标 HEKETI，然后点 Delete credential。
   • 在 Credentials 列表视图中，选择凭证名称，点 Edit credential 旁边的 More Actions 图标 identityProvider，然后点 Delete credential。

2. 在弹出窗口中，选择 Yes，我确认我要删除此凭据。

   注意

   如果您的凭证仍然被您机构中其他资源使用，则会显示警告信息，以便您知道无法删除凭证。另外，如果您的凭证在事件流中使用，则无法删除它，直到事件流被删除或附加到其他凭证为止。通常，避免删除正在使用的凭证，因为它可能会导致激活中断。

3. 单击 Delete credential。

流程

1. 登录到 Ansible Automation Platform 仪表板。
2. 在导航面板中，选择 Automation Decisions → Infrastructure → Credential Types。
3. 单击 Create credential type。

4. 插入以下内容：

   名称

   插入名称。

   描述

   此字段是可选的。

5. 在 Input Configuration 字段中，指定一个输入模式，为该类型定义一组排序字段。格式可以是 YAML 或 JSON：

   YAML

   fields:
     - type: string
       id: username
       label: Username
     - type: string
       id: password
       label: Password
       secret: true
   required:
     - username
     - password

   在 YAML 页面 查看更多 YAML 示例。

   JSON

   {
   "fields": [
     {
     "type": "string",
     "id": "username",
     "label": "Username"
     },
     {
     "secret": true,
     "type": "string",
     "id": "password",
     "label": "Password"
      }
     ],
    "required": ["username", "password"]
   }

   请参阅 JSON 网站 查看更多 JSON 示例。

6. 在 Injector Configuration 字段中输入环境变量或额外变量，用于指定凭证类型可注入的值。格式可以是 YAML 或 JSON （请参阅上一步中的示例）。

   以下 JSON 格式的配置显示了每个字段以及它们的使用方式：

   {
       "extra_vars": {
         "some_extra_var": "{{ username }}:{{ password }}"
     }
   }

7. 单击 Create credential type。

   您新创建的凭证类型显示在凭证类型列表中。

8. 点 Edit credential type 图标修改凭证类型选项。

流程

1. 登录到 Ansible Automation Platform 仪表板。
2. 导航到 Automation Decisions → Projects。
3. 单击 Create project。

4. 插入以下内容：

   名称

   输入项目名称。

   描述

   此字段是可选的。

   源控制类型

   Git 是唯一可供使用的源控制类型。此字段是可选的。

   源控制 URL

   输入 Git、SSH 或 HTTP[S] 协议地址，如 GitHub 或 GitLab。此必填字段可编辑。请参阅 编辑项目 来查看如何编辑此字段会影响规则手册激活。

   注意

   此字段接受 SSH 私钥或私钥短语。若要启用这些私钥的使用，您的项目 URL 必须以 git@ 开头。

   Proxy

   这用于访问 HTTP 或 HTTPS 服务器。此字段是可选的，可编辑。请参阅 编辑项目 来查看如何编辑此字段会影响规则手册激活。

   源控制分支/标签/提交

   这是要检查的分支。除了分支外，您还可以输入标签、提交散列和任意 refs。除非您还提供了自定义 refspec，否则某些提交散列和 refs 可能不可用。此字段是可选的，可编辑。请参阅 编辑项目 来查看如何编辑此字段会影响规则手册激活。

   源控制 refspec

   要获取的 refspec （传递至 Ansible git 模块）。此参数允许通过分支字段访问原本不可用的引用。此字段是可选的，可编辑。请参阅 编辑项目 来查看如何编辑此字段会影响规则手册激活。如需更多信息，请参阅 示例。

   源控制凭证

   这是用于通过提供的 Source 控制 URL 进行身份验证的可选凭证。

   内容签名验证凭证

   启用内容签名以验证内容在项目同步时是否保持安全。如果内容已被篡改，则该作业将不会运行。此字段是可选的。

   选项

   Verify SSL 选项默认为启用。启用此选项会在导入项目时验证 SSL 使用 HTTPS。

   注意

   如果您有使用自签名证书的本地存储库，您可以禁用这个选项。

5. 选择 Create project。

流程

1. 在 Projects 列表视图中，选择所需项目旁边的More Actions icon ⋮ 图标。此时会显示 Edit 页面。

2. 编辑所需字段。

   重要

   当您更新项目的 Source control URL 时，Source control branch/tag/commit，或 Source control refspec，Event-Driven Ansible 会自动触发项目重新同步。此过程更新 Event-Driven Ansible 控制器中可用的规则手册，并可能会影响现有的规则手册激活：

   • 规则手册内容更新 ：当规则手册的内容 更改时，运行激活将继续使用旧内容。要应用较新的内容，您必须重启受影响的规则手册激活。如果您更新的 rulebook 内容附加到使用事件流的激活中，您必须在应用更新后将事件流重新附加到该激活，然后重启激活。
   • 新的 Rulebooks ：在同步后，添加到存储库的任何新规则手册都会在数据库中可用。
   • 已删除规则手册 ：在同步时从数据库中删除已删除的规则手册。然而，其关联的激活会继续运行，可以重启。检查和更新从源规则手册中分离的任何激活。
3. 选择 Save project。

流程

1. 要删除项目，请完成以下任一操作：

   • 在 Projects 列表视图中，选择所需项目旁边的复选框，然后从页面菜单中点 More Actions 图标 WWN。
   • 在 Projects 列表视图中，点所需项目旁的 More Actions 图标。
2. 选择 Delete project。
3. 在 永久删除项目 窗口中，选择 Yes，确认我要删除此项目。
4. 选择 Delete project。

流程

1. 登录到 Ansible Automation Platform。
2. 导航到 Automation Decisions → Decision Environments。
3. 点 Create decision environment。

4. 插入以下内容：

   名称

   插入名称。

   描述

   此字段是可选的。

   机构（Organization）

   选择要与决策环境关联的机构。

   Image

   这是完整的镜像位置，包括容器 registry表、镜像名称和版本标签。

   凭证

   此字段是可选的。这是使用决策环境镜像所需的凭证。

5. 选择 Create decision environment。

流程

1. 登录到 Ansible Automation Platform 仪表板。
2. 在导航面板中，选择 Automation Decisions → Infrastructure → Credentials。
3. 点 Create credential。

4. 插入以下内容：

   名称

   插入名称。

   描述

   此字段是可选的。

   机构（Organization）

   单击列表以选择一个机构，或选择 Default。

   凭证类型

   点列表并选择 Red Hat Ansible Automation Platform。

   注意

   当您选择凭证类型时，Type Details 部分会显示适用于您选择的凭证类型的字段。

   警告

   如果您计划使用备份和恢复操作将 Ansible Automation Platform 实例迁移到不同的集群或一组新的主机名，Red Hat Ansible Automation Platform 凭证将中断，您的规则手册激活将失败。在恢复操作完成后，您必须手动编辑和更新自动化控制器 URL 和关联的凭证，以恢复连接。

5. 在所需的 Red Hat Ansible Automation Platform 字段中，输入您的自动化控制器 URL。

   注意

   对于带有自动化控制器 2.4 的 Event-Driven Ansible 控制器 2.5，请使用以下示例： https://<your_controller_host>

   对于 Ansible Automation Platform 2.5，请使用以下示例： https://<your_gateway_host>/api/controller/

6. 输入有效的 Username 和 Password，或输入 Oauth Token。
7. 点 Create credential。

流程

1. 登录到 Ansible Automation Platform。
2. 导航到 Automation Decisions → Rulebook Activations。
3. 点 Create rulebook activation。

4. 插入以下内容：

   名称

   插入名称。

   描述

   此字段是可选的。

   机构（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 策略的行为。每次启动激活时，系统会尝试拉取镜像的最新版本。

   重启策略

   这是决定在运行源插件的容器进程结束后激活应如何重启的策略。

   • 策略：

     1. Always ：这会立即重新启动规则手册激活，无论它是否成功结束，并且不会超过 5 次。
     2. Never ：当容器进程结束时，这永远不会重启规则手册激活。
     3. 失败时，这会默认在 60 秒后重启规则手册激活，只有在容器进程失败时，才会发生超过 5 次。

   日志级别

   此字段定义您记录的事件中的严重性和类型。

   • levels:

     1. 错误: 包含激活 History 选项卡中显示的错误消息的日志。
     2. info ：包含有关规则手册激活的有用信息的日志，如成功或失败、触发的操作名称及其关联的操作事件以及错误。
     3. debug ：包含仅在 debug 阶段有用的信息的日志，在生产期间可能只有较少的值。 此日志级别包括 error 和 log level data。

   服务名称

   这定义了 Kubernetes 的服务名称，以便在激活公开端口时配置入站连接。此字段是可选的。

   启用规则手册激活？

   这会自动启用规则手册激活来运行。

   变量

   规则手册的变量采用 JSON 或 YAML 格式。内容等同于通过 ansible-rulebook 命令的 --vars 标志传递的文件。

   注意

   在自动化控制器和 Event-Driven Ansible 控制器的上下文中，您可以使用 extra_vars 和凭证来存储各种信息。但是，凭证是存储密码或 API 密钥等敏感信息的首选方法，因为它们提供更好的安全性和集中管理，而 extra_vars 更适合传递动态的、非敏感数据。

   选项

   如果您不想在 Rule Audit 中看到您的 事件，请检查 Skip audit 选项。

5. 点 Create rulebook activation。

流程

1. 选择行级的切换，以启用或禁用您选择的规则手册。
2. 在 窗口中，选择 Yes，确认我要启用/禁用这些 X 规则手册激活。
3. 选择 Enable/Disable rulebook activation。

流程

1. 选择 Rulebook Activation enabled/disabled 切换开关旁边的 More Actions 图标 ⋮。
2. 选择 Restart rulebook 激活。
3. 在 窗口中，选择 Yes，确认我要重新启动这些 X 规则手册激活。
4. 选择 Restart rulebook 激活。

流程

1. 在 Rulebook Activations 页面上，在您要编辑的激活旁边，首先将 Rulebook 激活按钮切换为 off 位置，以禁用激活。

   此时会显示 Disable rulebook activations 信息，要求您确认要禁用激活。

2. 选择 Yes, I 确认我要禁用这些 <1> 规则手册激活 复选框，然后单击 Disable rulebook activations。

3. 在 rulebook 激活旁，点 Edit 图标。这会进入 Edit 表单。

   注意

   您还可以单击 Rulebook Activations 页面上的 rulebook 激活来访问 Edit 功能，将 Rulebook 激活按钮切换为 off 位置，确认您要禁用激活，然后单击页面右上角的 Edit rulebook 激活按钮来访问 Edit 表单。

4. 编辑所需字段。

   注意

   如果您希望立即运行激活，您可以将 规则手册激活 按钮切换到位置，然后保存您的更改。

5. 点 Save rulebook activation。

流程

1. 在 Rulebook Activations 页面中，点您要重复的激活行中的 More Actions 图标 &&。 此时会显示 More Actions 列表，它有三个选项：

   • 重启规则手册激活
   • 重复规则手册激活
   • 删除规则手册激活

2. 选择 Duplicate rulebook 激活。

   此时会显示一条信息："<Name of rulebook activation 1> duplicated."最初，新重复的激活显示在 Rulebook Activations 页面上，其名称与原始激活的名称相同，后跟 24 小时格式的时间戳（例如，<Name of rulebook activation 1> @ 18:43:27）。

   重要

   原始规则手册激活会在复制后继续运行。如果您试图启用重复的激活，但没有编辑字段（包括 Name 字段）来区分它，则会显示一条信息，提醒您规则手册激活与原始数据重复，并启用可能会失败，或导致重复的作业和其他复杂情况。

3. 在运行重复的规则手册激活前，请完成以下内容来编辑字段：

   1. 在重复的规则手册激活旁边，点 Edit 图标。这会进入 Edit 表单。

   2. 编辑所需字段。

      注意

      确保您已为新重复激活一个有意义的名称 ， 以便将其与原始激活区分开。

4. 将 Enable rulebook 激活按钮切换为位置。
5. 确认所有编辑完成后，单击 Save rulebook activation。

流程

1. 选择 Rulebook Activation enabled/disabled 切换开关旁的 More Actions 图标 ⋮。
2. 选择 Create rulebook 激活。
3. 在 窗口中，选择 Yes，我确认我要删除这些 X 规则手册激活。
4. 选择 Delete rulebook 激活。

流程

1. 创建一个路由（在 OpenShift Container Platform 中）以公开服务。以下是 ansible-rulebook 源的 Route 示例，它要求 POST 在决策环境 pod 的端口 5000 上：

   kind: Route
   apiVersion: route.openshift.io/v1
   metadata:
     name: test-sync-bug
     namespace: dynatrace
     labels:
       app: eda
       job-name: activation-job-1-5000
   spec:
     host: test-sync-bug-dynatrace.apps.aap-dt.ocp4.testing.ansible.com
     to:
       kind: Service
       name: activation-job-1-5000
       weight: 100
     port:
       targetPort: 5000
     tls:
       termination: edge
       insecureEdgeTerminationPolicy: Redirect
     wildcardPolicy: None

2. 在创建路由时，使用 到 Route URL 的 Post 进行测试 ：

   注意

   您不需要端口，因为它在 Route (targetPort) 上指定。

   curl -H "Content-Type: application/json" -X POST
   test-sync-bug-dynatrace.apps.aap-dt.ocp4.testing.ansible.com -d
   '{}'

流程

1. 运行以下命令，为给定服务公开集群中的端口：

   kubectl port-forward svc/<ACTIVATION_SVC_NAME> 5000:5000

2. 对 localhost:5000 发出 HTTP 请求，以触发规则手册：

   curl -H "Content-Type: application/json" -X POST test-sync-bug-dynatrace.apps.aap-dt.ocp4.testing.ansible.com -d '{}'

流程

1. 确认是否有其他正在运行的激活，并且您已达到限制（如内存或 CPU 限值）。

   1. 如果其他激活正在运行，请终止一个或多个激活（如果可能）。

   2. 如果没有，请检查默认 worker、Redis 和激活 worker 是否都在运行。如果所有系统都按预期工作，请检查 worker、调度程序、API 和 nginx 容器和服务中的 eda-server 内部日志，以查看是否可以确定问题。

      注意

      这些日志显示问题来源，如代码引发的异常、网络问题的运行时错误，或者规则规则代码出现错误。如果您的内部日志没有提供导致解决的信息，请向红帽支持报告问题。

   3. 如果您需要调整，请参阅 修改同时规则手册激活的数量。

      注意

      要在 OpenShift Container Platform 部署中调整 Ansible Automation Platform Operator 的最大同时激活数量，请参阅 在 OpenShift Container Platform 上安装 期间或之后修改同时规则激活的数量。

流程

1. 登录到 Ansible Automation Platform。
2. 在导航面板中，选择 Automation Decisions → Rulebook Activations。
3. 在 Rulebook Activations 页面中，选择您继续重启的列表中的激活。此时会显示 Details 页面。
4. 单击 History 选项卡以了解更多信息，然后选择继续重新启动的 rulebook 激活。此时会显示 Details 选项卡，并显示输出信息。

5. 检查您的激活的 Restart policy 字段。

   可用的选择有三个： 在失败时（在 容器进程失败时重启规则手册激活），Always （无论没有超过 5 个重启的成功或失败）或 Never （容器进程结束时会重启）或 Never （容器进程结束时会重启）。

   1. 确认您的 rulebook 激活重启策略已设置为 On failure。这表明问题导致了失败。
   2. 要可能诊断问题，请检查规则手册激活的 YAML 代码和实例日志以查找错误。
   3. 如果无法使用 restart 策略值找到解决方案，请继续执行与 Log level 相关的后续步骤。

6. 检查您的激活的日志级别。

   1. 如果您的默认日志级别为 Error，请返回到 Rulebook Activation 页面，并在 设置规则手册激活过程中重新创建您的激活。
   2. 将日志 级别更改为 Debug。
   3. 再次运行激活，然后从激活详情页面导航到 History 选项卡。
   4. 在 History 页面中，单击您最近的激活之一并查看 Output。

流程

1. 检查规则手册源： 查看规则手册 YAML 中定义的源插件（如 ansible.eda.webhook、ansible.eda.kafka）。
2. 验证事件输入： 确认您要发送到 Event-Driven Ansible 控制器的事件是否与规则手册中定义的源插件兼容。如果 rulebook 需要 Kafka 信息，则无法处理通用 Webhook 事件。
3. 确认激活映射 ： 如果您使用事件流，请确保在激活设置过程中将正确的事件流映射到规则手册中。此处不匹配将导致激活没有接收数据。

流程

1. 检查规则条件： 查看规则手册 YAML，以确认条件( when 语句)已准确编写，并且与传入事件有效负载的结构和值完全匹配。
2. 验证缩进和语法： 确保所有规则手册语法和缩进都正确，因为简单的错误可能会阻止容器引擎评估条件。
3. 验证操作： 确认指定的操作是一个可识别且正确配置的操作（例如，带有正确参数的 run_job_template ）。

流程

1. 为了帮助解决这个问题，请确认您已设置了 Red Hat Ansible Automation Platform 凭证，并获取了正确的自动化控制器 URL。

   1. 如果您还没有设置 Red Hat Ansible Automation Platform 凭证，请按照 设置 Red Hat Ansible Automation Platform 凭证 的步骤进行操作。确保此凭证的主机设置为以下 URL 格式： https://<your_gateway>/api/controller
   2. 完成此过程后，尝试再次设置您的规则手册激活。

流程

1. 在导航面板中，选择 Automation Decisions → Rule Audit。
2. 选择所需的规则，这将进入 Details 选项卡。

流程

1. 在导航面板中，选择 Automation Decisions → Rule Audit。
2. 选择所需的规则，这将进入 Details 选项卡。要查看触发某个操作的所有事件，请选择 Events 选项卡。这表明您触发了操作的事件。
3. 选择一个事件来查看 事件日志，以及 Source type 和 Timestamp。

流程

1. 在导航面板中，选择 Automation Decisions → Rule Audit。
2. 选择所需规则，然后选择 Actions 选项卡。

流程

1. 登录到 Ansible Automation Platform 仪表板。
2. 在导航面板中，选择 Automation Decisions → Infrastructure → Credentials。
3. 点 Create credential。

4. 插入以下内容：

   名称

   插入名称。

   描述

   此字段是可选的。

   机构（Organization）

   单击列表以选择一个机构，或选择 Default。

   凭证类型

   单击列表以选择您的凭据类型。

   注意

   当您选择凭证类型时，Type Details 部分会显示适用于您选择的凭证类型的字段。

   类型详情

   为您选择的凭证类型添加请求的信息。例如，如果您选择了 GitHub Event Stream 凭证类型，则需要在 Event-Driven Ansible 控制器和远程服务器之间添加 HMAC Secret (symmetrical shared secret)。

5. 点 Create credential。

流程

1. 登录到 Ansible Automation Platform。
2. 在导航面板中，选择 Automation Decisions → Event Streams。
3. 点 Create event stream。

4. 插入以下内容：

   名称

   插入名称。

   机构（Organization）

   单击列表以选择一个机构，或选择 Default。

   事件流类型

   选择您首选的事件流类型。

   注意

   此列表至少显示 10 个默认事件流类型，可用于验证来自远程服务器的连接。

   凭证

   从列表中选择一个凭证，最好是您为事件流创建的凭证。

   Headers

   输入 HTTP 标头密钥，用逗号分开，您要包含在事件有效负载中。

   重要

   如果您的自动化依赖于事件有效负载中存在的 HTTP 标头，您必须明确定义它们以避免意外公开敏感信息。有关 HTTP 标头以及如何安全地配置它们的更多信息，请参阅为事件流安全地配置 HTTP 标头。https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.6/html/using_automation_decisions/simplified-event-routing#eda-http-headers

   将事件转发到规则手册激活

   使用这个选项启用或禁用将事件转发到规则手册激活的功能。

   注意

   在诊断连接和评估传入的数据时，可以禁用事件流的事件转发以进行测试。禁用 Forward 事件到 rulebook 激活 选项后，您可以测试与远程系统的事件流连接，分析标头和有效负载，并诊断凭证问题。这样可确保事件不会被转发到规则手册激活，从而导致在测试模式中意外触发规则和条件。有些企业可能会有策略定期更改 secret 和密码。您可以在创建事件流后随时启用/禁用这个选项。

5. 点 Create event stream。

1. 登录到您的 GitHub 存储库。

2. 点击您的个人资料名称 →您的仓库。

   注意

   如果您没有存储库，请单击 New 以创建新存储库，选择所有者，添加 Repository 名称，然后单击 Create repository。

3. 进入 Settings (tool bar)。
4. 在 General 导航窗格中，选择 Webhooks。
5. 点 Add webhook。
6. 在 Payload URL 字段中，粘贴您在创建事件流时保存的 URL。
7. 在 Content type 列表中选择 application/json。
8. 输入您的 Secret。
9. 点 Add webhook。

1. 登录到 Ansible Automation Platform。
2. 在导航面板中，选择 Automation Decisions → Event Streams。
3. 选择您创建的事件流以验证连接，并确保事件流将数据发送到规则手册激活。

4. 验证这些事件是否已收到。接收的事件数量 以及包含事件详情的标头一起显示。

   

   如果在 UI 中向下滚动，您还可以查看有效负载的正文，其中包含有关 Webhook 的更多信息。

   事件流的 Header 和 Body 部分显示在 Details 页面中。它们根据发送事件的供应商而有所不同。标头和正文可用于检查事件有效负载中的属性，这有助于在规则手册中编写条件。

5. 将 Forward 事件切换到 rulebook 激活 选项，以便您可以将事件推送到规则手册激活。

1. 事件流只能在 rulebook 源交换中使用一次。如果您在规则手册中有多个源，则只能替换每个源一次。
2. 源映射仅在当前规则手册激活中发生。您必须使用同一规则手册对任何其他激活重复这个过程。
3. 只有在规则手册未修改时，源映射才有效。如果在源映射过程中修改了规则手册，则源映射将失败，且必须重复。
4. 如果在源映射创建后修改了规则手册，并且发生 重启，则规则手册激活会失败。

流程

1. 登录到 Ansible Automation Platform。
2. 在导航面板中，选择 Automation Decisions → Rulebook Activations。
3. 点 Create rulebook activation。

4. 插入以下内容：

   名称

   插入名称。

   描述

   此字段是可选的。

   机构（Organization）

   输入您的机构名称，或者从列表中选择 Default。

   项目

   项目是规则手册的逻辑集合。此字段是可选的。

   注意

   虽然此字段是可选的，但选择一个项目有助于优化您的规则手册选择列表。

   规则手册

   规则手册根据所选的项目显示。选择规则手册。

   注意

   选择了规则手册后，启用 Event stream 字段。您可以点齿轮图标来显示事件流映射表单。

   事件流

   此时会显示所有可用的事件流，并设置为将事件转发到规则处理器。如果您还没有创建任何事件流，此字段会被禁用。

   点 gear 图标显示事件流映射 UI。

   

   完成以下字段：

   规则手册源

   规则手册可以包含多个规则集之间的源。您可以在多个激活中将同一规则手册映射到多个事件流。在管理事件流时，未命名的源会被分配临时名称(__SOURCE {n})来进行识别。

   从列表中选择 __SOURCE_1。

   事件流

   从列表中选择您的事件流名称。

   点击 Save。

   事件流可以替换规则中的匹配源，是可以把各种事件源连接到规则手册激活的服务器端 Webhook。可替换为事件源 ansible.eda.pg_listener 类型的源源的源类型包括 ansible.eda.webhook 和其他兼容的 webhook 源插件。替换所选源只会影响这个激活，并修改 rulebook 的源类型、源名称和参数。过滤器、规则、条件和操作都不受影响。

   您可以选择要替换为单个事件流的源。如果您的规则手册中有多个源，您可以选择将每个源替换为事件流，但您不需要替换每个源。下图显示了可以替换哪些源。

   

   pink 中的项目演示了可以替换的源： source type、source name 和 parameters。剩余的项目(filters、规则和操作)没有被替换。

   凭证

   为此规则手册激活选择 0 或更多凭证。此字段是可选的。

   注意

   此字段中显示的凭证根据您的规则激活自定义，仅包含以下凭证类型：Vault、Red Hat Ansible Automation Platform 或您创建的任何自定义凭证类型。如需有关凭据的更多信息，请参阅 凭证。

   决策环境

   决策环境是用于运行 Ansible 规则手册的容器镜像。

   注意

   在 Event-Driven Ansible 控制器中，您无法自定义决策环境的拉取策略。默认情况下，它遵循 always 策略的行为。每次启动激活时，系统会尝试拉取镜像的最新版本。

   重启策略

   这是决定在运行源插件的容器进程结束后激活应如何重启的策略。

   • 策略：

     1. Always ：这会立即重新启动规则手册激活，无论它是否成功结束，并且不会超过 5 次。
     2. Never ：当容器进程结束时，这永远不会重启规则手册激活。
     3. 失败时，这会默认在 60 秒后重启规则手册激活，只有在容器进程失败时，才会发生超过 5 次。

   日志级别

   此字段定义您记录的事件中的严重性和类型。

   • levels:

     1. 错误: 包含激活 History 选项卡中显示的错误消息的日志。
     2. info ：包含有关规则手册激活的有用信息的日志，如成功或失败、触发的操作名称及其关联的操作事件以及错误。
     3. debug ：包含仅在 debug 阶段有用的信息的日志，在生产期间可能只有较少的值。 此日志级别包括 error 和 log level data。

   服务名称

   这定义了 Kubernetes 的服务名称，以便在激活公开端口时配置入站连接。此字段是可选的。

   启用规则手册激活？

   这会自动启用规则手册激活来运行。

   变量

   规则手册的变量采用 JSON 或 YAML 格式。内容等同于通过 ansible-rulebook 命令的 --vars 标志传递的文件。

   选项

   如果您不想在 Rule Audit 中看到您的 事件，请检查 Skip audit 选项。

5. 点 Create rulebook activation。

流程

1. 返回到 GitHub Webhook / Manage webhook 页面。
2. 单击 最近交付选项卡。
3. 单击 省略。
4. 单击 Redeliver。通过发送消息显示 Redeliver payload? 窗口。
5. 单击 Yes, redeliver this payload。
6. 返回到 Ansible Automation Platform，以检查您的规则审计。

流程

1. 登录到 Ansible Automation Platform。
2. 在导航面板中，选择 Automation Decisions → Rule Audit。

1. 同步规则手册激活数量
2. Event-Driven Ansible 控制器收到的事件数

流程

1. 执行以下步骤修改您的规则手册激活的 默认内存限值 ：

   1. 导航到设置清单文件。
   2. 在 [all:vars] 部分添加 automationedacontroller_podman_mem_limit。例如，Automationedacontroller_podman_mem_limit='400m'。
   3. 运行设置。

2. 在安装后，执行以下步骤修改规则手册激活的默认内存限值：

   1. 导航到 /etc/ansible-automation-platform/eda/settings.yaml 的环境文件。
   2. 修改默认容器内存限值。例如，PODMAN_MEM_LIMIT = '300m'。
   3. 使用 automation-eda-controller-service 重启，重启 Event-Driven Ansible 控制器服务。