18.2. 使用 metrics RHEL 系统角色，配置带有身份验证的 Performance Co-Pilot

流程

1. 将您的敏感变量存储在一个加密文件中：

   1. 创建 vault ：

      $ ansible-vault create vault.yml
      New Vault password: <vault_password>
      Confirm New Vault password: <vault_password>

   2. 在 ansible-vault create 命令打开编辑器后，以 <key>: <value> 格式输入敏感数据：

      metrics_usr: <username>
      metrics_pwd: <password>

   3. 保存更改，并关闭编辑器。Ansible 加密 vault 中的数据。

2. 创建一个包含以下内容的 playbook 文件，如 ~/playbook.yml ：

   ---
   - name: Monitoring performance metrics
     hosts: managed-node-01.example.com
     tasks:
       - name: Configure Performance Co-Pilot
         ansible.builtin.include_role:
           name: rhel-system-roles.metrics
         vars:
           metrics_retention_days: 14
           metrics_manage_firewall: true
           metrics_manage_selinux: true
   	metrics_username: "{{ metrics_usr }}"
           metrics_password: "{{ metrics_pwd }}"

   示例 playbook 中指定的设置包括以下内容：

   metrics_retention_days: <number>

   设置多少天后 pmlogger_daily systemd 计时器删除旧的 PCP 归档。

   metrics_manage_firewall: <true|false>

   定义角色是否应该在 firewalld 服务中打开所需的端口。如果要远程访问受管节点上的 PCP，请将此变量设置为 true。

   metrics_username: <username>

   角色在受管节点本地创建此用户，将凭据添加到 /etc/pcp/passwd.db Simple Authentication and Security Layer(SASL)数据库中，并在 PCP 中配置身份验证。另外，如果您在 playbook 中设置了 metrics_from_bpftrace: true，则 PCP 使用此帐户注册 bpftrace 脚本。

   有关 playbook 中使用的所有变量的详情，请查看控制节点上的 /usr/share/ansible/roles/rhel-system-roles.metrics/README.md 文件。

3. 验证 playbook 语法：

   $ ansible-playbook --ask-vault-pass --syntax-check ~/playbook.yml

   请注意，这个命令只验证语法，不会防止错误但有效的配置。

4. 运行 playbook：

   $ ansible-playbook --ask-vault-pass ~/playbook.yml