28.4. 使用 systemd RHEL 系统角色部署 systemd 用户单元

流程

1. 使用自定义 systemd 单元文件内容创建一个 Jinja2 模板。例如，使用服务的内容创建 ~/example.service.j2 文件：

   {{ ansible_managed | comment }}
   [Unit]
   Description=Example systemd service unit file
   
   [Service]
   ExecStart=/bin/true
   RemainAfterExit=yes
   
   [Install]
   WantedBy=multi-user.target

   对文件名使用 <name>.<unit_type>.j2 约定。例如，要创建 example.service 单元，您必须将文件命名为 example.service.j2。将文件与 playbook 放在同一个目录中。

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

   ---
   - name: Managing systemd services
     hosts: managed-node-01.example.com
     tasks:
       - name: Deploy, enable, and start a custom systemd service for a user
         ansible.builtin.include_role:
           name: rhel-system-roles.systemd
         vars:
           systemd_unit_file_templates:
             - item: example.service.j2
               user: <username>
           systemd_enabled_units:
             - item: example.service
               user: <username>
           systemd_started_units:
             - item: example.service
               user: <username>

   重要

   systemd RHEL 系统角色不会创建新用户，如果您在 playbook 中指定了一个不存在的用户，则它会返回一个错误。

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

3. 验证 playbook 语法：

   $ ansible-playbook --syntax-check ~/playbook.yml

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

4. 运行 playbook：

   $ ansible-playbook ~/playbook.yml