Ansible内置模块之systemd（ansible模块介绍）
ansible.builtin.systemd 模块是 Ansible 的内置模块之一，用于管理 systemd 服务。在基于 systemd 的 Linux 系统上，它允许你启动、停止、重启和重新加载服务，管理服务的启用和禁用，以及其他 systemd 相关操作。
1. 选 项 说 明
选项 | 必须 | 类型 | 默认值 | 说明 |
name | 是 | str | 无 | 要管理的 systemd 服务单元的名称 |
state | 否 | str | 无 | 服务的目标状态。可为 started,stopped,restarted,reloaded |
enabled | 否 | bool | 无 | 是否启用服务开机自启。可以是 yes 或 no |
masked | 否 | bool | 无 | 是否掩盖（mask）服务。可以是 yes 或 no |
daemon_reload | 否 | bool | no | 是否在执行其他操作之前重新加载系统管理器配置 |
scope | 否 | str | 无 | 限制单元的作用域。可以是 system 或 user |
no_block | 否 | bool | 无 | 是否以非阻塞模式启动服务。默认是 no |
force | 否 | bool | no | 存在 state=restarted 或 state=reloaded 时，是否强制重启或重载 |
user | 否 | bool | no | 是否在用户作用域而不是系统作用域中操作服务 |
2. 用 例
# 启动并启用服务
- name: Start the Apache service
ansible.builtin.systemd:
name: httpd
state: started
enabled: yes
# 停止服务
- name: Stop the Apache service
ansible.builtin.systemd:
name: httpd
state: stopped
# 重启服务
- name: Restart the Apache service
ansible.builtin.systemd:
name: httpd
state: restarted
# 重新加载服务
- name: Reload the Apache service
ansible.builtin.systemd:
name: httpd
state: reloaded
# 启用服务开机自启
- name: Ensure the Apache service is enabled at boot
ansible.builtin.systemd:
name: httpd
enabled: yes
# 禁用服务开机自启
- name: Ensure the Apache service is disabled at boot
ansible.builtin.systemd:
name: httpd
enabled: no
# 掩盖（mask）服务
- name: Mask the Apache service
ansible.builtin.systemd:
name: httpd
masked: yes
# 在执行其他操作之前重新加载系统管理器配置
- name: Reload systemd manager configuration before restarting the Apache service
ansible.builtin.systemd:
name: httpd
state: restarted
daemon_reload: yes
# 使用非阻塞模式启动服务
- name: Start the Apache service in non-blocking mode
ansible.builtin.systemd:
name: httpd
state: started
no_block: yes
# 在用户作用域中操作服务
- name: Start a user-scoped service
ansible.builtin.systemd:
name: my_user_service
state: started
user: yes
