Event-Driven Ansible 控制器用户指南

流程

1. 登录 Event-Driven Ansible 控制器仪表板。
2. 在导航面板中，选择 Resources → Credentials。
3. 点 Create credential。

4. 插入以下内容：

   名称

   插入名称。

   描述

   此字段是可选的。

   凭证类型

   可用的选项包括 GitHub 个人访问令牌、GitLab 个人访问令牌或容器 registry。

   用户名

   插入用户名。

   令牌

   插入允许您向目的地进行身份验证的令牌。

   注意

   如果使用容器 registry，则 token 字段可以是令牌或密码，具体取决于 registry 供应商。如果使用 Ansible Automation Platform hub registry，请在 token 字段中插入该密码。

5. 点 Create credential。

流程

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

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

流程

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

   • 在 Credentials 列表视图中，点所需凭证旁的 More Actions 图标，然后点 Delete credential。
   • 在 Credentials 列表视图中，选择凭证的名称，点 Edit credential 旁边的 More Actions 图标 Castle，然后点 Delete credential。
2. 在弹出窗口中，选择 Yes，我确认我要删除此凭据。
3. 单击 Delete credentials。

流程

1. 登录 Event-Driven Ansible 控制器仪表板。
2. 在导航面板中，选择 Projects → Create project。

3. 插入以下内容：

   名称

   输入项目名称。

   描述

   此字段是可选的。

   SCM 类型

   Git 是可供使用的 SCM 类型。

   SCM URL

   HTTP[S] 存储库的协议地址，如 GitHub 或 GitLab。

   注意

   您无法在创建项目后编辑 SCM URL。

   凭证

   此字段是可选的。这是利用 SCM URL 所需的令牌。

   选项

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

   注意

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

4. 选择 Create project。

流程

1. 在 Projects 列表视图中，选择所需项目旁边的More Actions icon ⋮ 图标。
2. 选择 Edit project。
3. 输入所需的更改，然后选择 Save project。

流程

1. 在 Projects 列表视图中，选择所需项目旁边的More Actions icon ⋮ 图标。
2. 选择 Delete project。
3. 在弹出窗口中，选择 Yes, I confirm that I want to delete this project。
4. 选择 Delete project。

流程

1. 进入到 Event-Driven Ansible 控制器仪表板。
2. 从导航面板中，选择 Decision Environments。

3. 插入以下内容：

   名称

   插入名称。

   描述

   此字段是可选的。

   Image

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

   凭证

   此字段是可选的。这是利用决策环境镜像所需的令牌。

4. 选择 Create decision environment。

流程

1. 进入 Event-Driven Ansible 控制器仪表板。
2. 在顶部导航面板中选择您的个人资料。
3. 进入用户详情。
4. 选择 Controller Tokens → Create controller 令牌。

5. 插入以下内容：

   名称

   插入名称。

   描述

   此字段是可选的。

   令牌

   在自动化控制器中创建令牌。有关创建令牌的更多信息，请参阅自动化控制器用户指南中的 用户 - Tokens 部分。

   注意

   您的令牌必须处于 write-scope 状态，并且如果您被分配了的用户，则必须有执行任务和工作流模板的权限。

6. 选择 Create controller token。

流程

1. 进入到 Event-Driven Ansible 控制器仪表板。
2. 在导航面板中，选择 Rulebook Activations。

3. 插入以下内容：

   名称

   插入名称。

   描述

   此字段是可选的。

   项目

   项目是规则手册的逻辑集合。

   规则手册

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

   决策环境

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

   注意

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

   重启策略

   这是一个策略，用于决定何时重启规则手册。

   • 策略：

     1. Always ：当规则手册完成时重启
     2. Never ：在规则手册完成后重启一个规则手册
     3. On failure：只在失败时重启

   启用规则手册激活？

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

   变量

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

4. 点 Create rulebook 激活。

1. 选择行级的切换，以启用或禁用您选择的规则手册。
2. 在弹出窗口中，选择 Yes, I confirm that I want to enable/disable these X rulebook activations。
3. 选择 Enable/Disable rulebook activation。

1. 选择 Rulebook Activation enabled/disabled 切换开关旁边的 More Actions 图标 ⋮。
2. 选择 Restart rulebook 激活。
3. 在弹出窗口中，选择 Yes, I confirm that I want to restart these X rulebook activations。
4. 选择 Restart rulebook 激活。

1. 选择 Rulebook Activation enabled/disabled 切换开关旁的 More Actions 图标 ⋮。
2. 选择 Create rulebook 激活。
3. 在弹出窗口中，选择 Yes, I confirm that I want to delete these X rulebook activations。
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 进行测试 ：

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

   注意

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

流程

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. 在导航面板中，选择 Rule Audit。
2. 选择所需的规则，这将进入 Details 选项卡。

流程

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

流程

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

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