基础设施即代码 / 系统课时
管理 systemd 服务
管理 systemd 服务
Linux 配置自动化不能止于修改文件,还要保证服务处于正确的运行状态。本课使用 Ansible 管理 systemd 服务的启动、自启动与重载,并通过 Handler 把“配置确实发生变化”和“服务需要执行动作”连接起来。
学习目标
- 使用
ansible.builtin.systemd_service管理服务运行状态和开机自启动 - 区分
started、restarted、reloaded与daemon_reload的作用 - 使用
notify与 Handler 让服务动作只在配置变化时发生
用 systemd_service 声明目标状态
对于由 systemd 管理的服务,优先使用 ansible.builtin.systemd_service,而不是通过 shell 执行 systemctl。模块会读取当前状态,只在实际需要时执行变更,从而保持幂等性。
下面的片段示例确保 Nginx 已启动,并设置为开机自动启动:
- name: Ensure nginx is enabled and running
ansible.builtin.systemd_service:
name: nginx
enabled: true
state: startedenabled: true 管理是否随系统启动,state: started 管理当前是否正在运行。这两个维度彼此独立:一个服务完全可能已经启动,但没有设置为开机自启动。
常见的 state 值中,started 和 stopped 具有幂等性;restarted 会要求执行一次重启;reloaded 则要求 systemd 调用服务定义的 reload 动作,适合支持无中断重载的守护进程。
用 Handler 连接配置变化与服务重载
服务配置通常遵循“修改配置 → 配置发生变化时通知 → 最后执行重载”的链路。Handler 正适合表达这种条件关系:只有任务返回 changed 并触发 notify 时,对应 Handler 才会运行。

下面给出一个可以直接保存为 nginx-service.yml 的完整 Playbook。它先安装并启动 Nginx,再管理一个独立配置文件;只有该文件发生变化时才通知 Handler 重载服务。
---
- name: Manage nginx service
hosts: web
become: true
tasks:
- name: Install nginx
ansible.builtin.package:
name: nginx
state: present
- name: Ensure nginx is enabled and running
ansible.builtin.systemd_service:
name: nginx
enabled: true
state: started
- name: Configure nginx connection settings
ansible.builtin.copy:
dest: /etc/nginx/conf.d/ansible-managed.conf
owner: root
group: root
mode: "0644"
content: |
keepalive_timeout 65;
keepalive_requests 1000;
notify: Reload nginx
handlers:
- name: Reload nginx
ansible.builtin.systemd_service:
name: nginx
state: reloaded执行 Playbook:
ansible-playbook -i inventory.ini nginx-service.yml预期输出首次运行会包含安装、启动或写配置产生的 changed,并在末尾执行 Handler;不同系统的任务数量可能不同:
PLAY [Manage nginx service] ****************************************************
TASK [Install nginx] **********************************************************
changed: [<HOST>]
TASK [Ensure nginx is enabled and running] ************************************
ok: [<HOST>]
TASK [Configure nginx connection settings] ************************************
changed: [<HOST>]
RUNNING HANDLER [Reload nginx] ************************************************
changed: [<HOST>]
PLAY RECAP ********************************************************************
<HOST> : ok=<VALUE> changed=<VALUE> unreachable=0 failed=0再次执行且配置没有变化时,配置任务应返回 ok,Reload nginx Handler 不会出现。这正是“只在需要时重载”的闭环。
正确处理 unit 文件变化
修改 /etc/systemd/system/*.service 或 drop-in 文件后,systemd 自身需要重新读取 unit 定义。这与重载业务服务不是同一件事,应使用 daemon_reload: true。
下面是片段示例,假设前一个任务已经修改了某个 unit 文件并通知该 Handler:
handlers:
- name: Reload systemd units
ansible.builtin.systemd_service:
daemon_reload: true
- name: Restart myapp
ansible.builtin.systemd_service:
name: myapp
state: restarteddaemon_reload 对应 systemctl daemon-reload,让 systemd 重新解析 unit;state: reloaded 则针对某个具体服务执行 reload。两者名称相近,但解决的是不同问题。
验证运行状态与自启动
自动化结束后,可以直接读取 systemd 的两个关键属性进行验收:当前是否运行,以及是否已启用自启动。
ansible web -i inventory.ini -b -m ansible.builtin.shell -a 'systemctl is-active nginx && systemctl is-enabled nginx'预期输出:
<HOST> | CHANGED | rc=0 >>
active
enabled验证命令使用 shell 是为了串联两个只读检查;真正修改服务状态仍应使用 ansible.builtin.systemd_service。在标准化主机配置中,把文件变更交给普通任务,把必要的重载或重启交给 Handler,可以同时获得正确状态、幂等执行和更小的服务扰动。