ansible.builtin.systemd_service 模块 – 管理 systemd 单元
注意
此模块是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，即使不指定 collections 关键字，您也可以使用简短的模块名称 systemd_service。但是，我们建议您使用 完整限定集合名称 (FQCN) ansible.builtin.systemd_service 以便轻松链接到模块文档并避免与可能具有相同模块名称的其他集合发生冲突。
摘要
控制远程主机上的 systemd 单元（服务、定时器等）。
ansible.builtin.systemd 重命名为 ansible.builtin.systemd_service 以更好地反映模块的范围。ansible.builtin.systemd 保留为向后兼容的别名。
别名：systemd
需求
执行此模块的主机需要以下需求。
由 systemd 管理的系统。
参数
参数 |
注释 |
|---|---|
在执行任何其他操作之前运行 daemon_reexec 命令，systemd 管理器将序列化管理器状态。 选项
|
|
在执行任何其他操作之前运行 当设置为 选项
|
|
是否覆盖现有的符号链接。 选项
|
|
单元的名称。此参数采用要使用的单元的精确名称。 如果未给出扩展名，则默认为 在 chroot 环境中使用时，始终需要使用扩展名指定单元的名称。例如， |
|
不要同步等待请求的操作完成。排队的作业将继续，而 Ansible 不会阻塞其完成。 选项
|
|
在给定的服务管理器作用域内运行 要使 systemd 与 用户 dbus 进程通常在正常登录期间启动，但在 Ansible 任务运行期间不会启动。否则，您可能会收到“无法连接到总线：没有这样的文件或目录”错误。 用户必须具有访问权限，通常通过设置 选项
|
|
如果设置，则需要 选项
|
属性
属性 |
支持 |
描述 |
|---|---|---|
支持：完全支持 |
可以在 check_mode 中运行并返回更改状态预测，而无需修改目标，如果不支持，则会跳过该操作。 |
|
支持：不支持 |
在差异模式下时，将返回有关已更改内容（或可能需要在 check_mode 中更改的内容）的详细信息 |
|
平台： posix |
可以对其进行操作的目标操作系统/系列 |
备注
示例
- name: Make sure a service unit is running
ansible.builtin.systemd_service:
state: started
name: httpd
- name: Stop service cron on debian, if running
ansible.builtin.systemd_service:
name: cron
state: stopped
- name: Restart service cron on centos, in all cases, also issue daemon-reload to pick up config changes
ansible.builtin.systemd_service:
state: restarted
daemon_reload: true
name: crond
- name: Reload service httpd, in all cases
ansible.builtin.systemd_service:
name: httpd.service
state: reloaded
- name: Enable service httpd and ensure it is not masked
ansible.builtin.systemd_service:
name: httpd
enabled: true
masked: no
- name: Enable a timer unit for dnf-automatic
ansible.builtin.systemd_service:
name: dnf-automatic.timer
state: started
enabled: true
- name: Just force systemd to reread configs (2.4 and above)
ansible.builtin.systemd_service:
daemon_reload: true
- name: Just force systemd to re-execute itself (2.8 and above)
ansible.builtin.systemd_service:
daemon_reexec: true
- name: Run a user service when XDG_RUNTIME_DIR is not set on remote login
ansible.builtin.systemd_service:
name: myservice
state: started
scope: user
environment:
XDG_RUNTIME_DIR: "/run/user/{{ myuid }}"
返回值
常见返回值已在此处记录 此处，以下是此模块特有的字段
键 |
描述 |
|---|---|
包含 返回：成功 示例： |