基础设施即代码 / 系统课时

管理 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 已启动,并设置为开机自动启动:

yaml
- name: Ensure nginx is enabled and running
  ansible.builtin.systemd_service:
    name: nginx
    enabled: true
    state: started

enabled: true 管理是否随系统启动,state: started 管理当前是否正在运行。这两个维度彼此独立:一个服务完全可能已经启动,但没有设置为开机自启动。

常见的 state 值中,started 和 stopped 具有幂等性;restarted 会要求执行一次重启;reloaded 则要求 systemd 调用服务定义的 reload 动作,适合支持无中断重载的守护进程。

用 Handler 连接配置变化与服务重载

服务配置通常遵循“修改配置 → 配置发生变化时通知 → 最后执行重载”的链路。Handler 正适合表达这种条件关系:只有任务返回 changed 并触发 notify 时,对应 Handler 才会运行。

配置变化触发 systemd Handler 的执行链路

下面给出一个可以直接保存为 nginx-service.yml 的完整 Playbook。它先安装并启动 Nginx,再管理一个独立配置文件;只有该文件发生变化时才通知 Handler 重载服务。

yaml
---
- 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:

bash
ansible-playbook -i inventory.ini nginx-service.yml

预期输出首次运行会包含安装、启动或写配置产生的 changed,并在末尾执行 Handler;不同系统的任务数量可能不同:

text
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:

yaml
handlers:
  - name: Reload systemd units
    ansible.builtin.systemd_service:
      daemon_reload: true

  - name: Restart myapp
    ansible.builtin.systemd_service:
      name: myapp
      state: restarted

daemon_reload 对应 systemctl daemon-reload,让 systemd 重新解析 unit;state: reloaded 则针对某个具体服务执行 reload。两者名称相近,但解决的是不同问题。

验证运行状态与自启动

自动化结束后,可以直接读取 systemd 的两个关键属性进行验收:当前是否运行,以及是否已启用自启动。

bash
ansible web -i inventory.ini -b -m ansible.builtin.shell -a 'systemctl is-active nginx && systemctl is-enabled nginx'

预期输出:

text
<HOST> | CHANGED | rc=0 >>
active
enabled

验证命令使用 shell 是为了串联两个只读检查;真正修改服务状态仍应使用 ansible.builtin.systemd_service。在标准化主机配置中,把文件变更交给普通任务,把必要的重载或重启交给 Handler,可以同时获得正确状态、幂等执行和更小的服务扰动。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

管理 systemd 服务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通