ansible.builtin.service 模块 – 管理服务

注意

此模块是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，即使没有指定 集合关键字，您也可以使用简短的模块名称 service。但是，我们建议您使用 完全限定的集合名称 (FQCN) ansible.builtin.service，以便轻松链接到模块文档并避免与可能具有相同模块名称的其他集合发生冲突。

摘要

  • 控制远程主机上的服务。支持的 init 系统包括 BSD init、OpenRC、SysV、Solaris SMF、systemd、upstart。

  • 此模块充当底层服务管理器模块的代理。虽然所有参数都将传递到底层模块，但并非所有模块都支持相同的参数。本文档仅涵盖所有服务管理器模块支持的模块参数的最小交集。

  • 此模块是多个更具体的服务管理器模块（例如 ansible.builtin.systemd 和 ansible.builtin.sysvinit）的代理。这允许管理异构环境的机器，而无需为每个服务管理器创建特定任务。要执行的模块由 use 选项确定，该选项默认为 ansible.builtin.setup 发现的服务管理器。如果 ansible.builtin.setup 尚未运行，此模块可能会运行它。

  • 对于 Windows 目标，请改用 ansible.windows.win_service 模块。

注意

此模块具有相应的 操作插件。

参数

参数

注释

arguments

别名：args

字符串

命令行上提供的附加参数。

使用具有 systemd 的远程主机时，此设置将被忽略。

默认值： ""

enabled

布尔值

服务是否应该在启动时启动。

至少需要 state 和 enabled 之一。

选项

  • false

  • true

name

字符串 / 必需

服务的名称。

pattern

字符串

如果服务没有响应状态命令，请指定一个子字符串作为 ps 命令输出中找到的字符串，作为状态结果的替代。

如果找到字符串，则假定服务已启动。

使用具有 systemd 的远程主机时，此设置将被忽略。

runlevel

字符串

仅适用于 OpenRC init 脚本（例如 Gentoo）。

此服务所属的运行级别。

使用具有 systemd 的远程主机时，此设置将被忽略。

默认值： "default"

sleep

整数

如果服务正在 restarted，则在停止和启动命令之间休眠这么多秒。

这有助于解决行为不端的 init 脚本的问题，这些脚本在向进程发出停止信号后立即退出。

并非所有服务管理器都支持休眠，即使用 systemd 时，此设置将被忽略。

state

字符串

started/stopped 是幂等操作，除非必要，否则不会运行命令。

restarted 将始终使服务重启。

reloaded 将始终重新加载。

至少需要 state 和 enabled 之一。

请注意，即使您选择的服务管理器通常不会，reloaded 也会启动服务（如果尚未启动）。

选项

  • "reloaded"

  • "restarted"

  • "started"

  • "stopped"

use

字符串

服务模块实际上使用系统特定的模块，通常通过自动检测，此设置可以强制使用特定模块。

通常，它使用 ansible_service_mgr 事实的 value，如果找不到匹配项，则回退到 ansible.legacy.service 模块。

“旧服务模块”仍然使用自动检测，它与 service 命令没有任何关系。

默认值： "auto"

属性

属性

支持

描述

action

支持：完整

表示它具有相应的操作插件，因此可以在控制器上执行选项的某些部分

async

支持：完整

支持与 async 关键字一起使用

bypass_host_loop

支持：无

强制执行不按主机执行的“全局”任务，这将绕过按主机进行的模板化以及串行、节流和其他循环考虑因素

条件语句的行为就像使用 run_once 一样，使用的变量将来自第一个可用的主机

此操作在锁步策略之外通常不起作用

check_mode

支持： N/A

支持取决于调用的底层插件

可以在 check_mode 下运行并返回已更改状态预测，而无需修改目标，如果不受支持，则操作将被跳过。

diff_mode

支持： N/A

支持取决于调用的底层插件

将在 diff 模式下返回有关更改内容（或可能需要在 check_mode 下更改的内容）的详细信息

platform

平台： 全部

支持取决于每个平台上特定插件的可用性，以及事实收集是否能够检测到它

可以操作的目标操作系统/系列

注意

注意

  • 对于 AIX，可以使用组子系统名称。

  • service 命令行实用程序不属于任何服务管理器系统，而是一个便利工具。它在不同系统上没有标准实现，此操作不能直接使用它。虽然它可能在某些情况下被使用（如果被找到），但通常首选检测到的系统服务管理器。

另请参阅

另请参阅

ansible.windows.win_service

ansible.windows.win_service 模块的官方文档。

示例

- name: Start service httpd, if not started
  ansible.builtin.service:
    name: httpd
    state: started

- name: Stop service httpd, if started
  ansible.builtin.service:
    name: httpd
    state: stopped

- name: Restart service httpd, in all cases
  ansible.builtin.service:
    name: httpd
    state: restarted

- name: Reload service httpd, in all cases
  ansible.builtin.service:
    name: httpd
    state: reloaded

- name: Enable service httpd, and not touch the state
  ansible.builtin.service:
    name: httpd
    enabled: yes

- name: Start service foo, based on running process /usr/bin/foo
  ansible.builtin.service:
    name: foo
    pattern: /usr/bin/foo
    state: started

- name: Restart network service for interface eth0
  ansible.builtin.service:
    name: network
    state: restarted
    args: eth0

作者

  • Ansible 核心团队

  • Michael DeHaan