community.general.svc 模块 – 管理 daemontools 服务

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.svc。

概要

  • 使用 svc 实用程序控制远程主机上的 daemontools 服务。

参数

参数

注释

downed

布尔值

是否应该存在“down”文件，如果存在，则禁用自动启动。默认为否。“Downed”并不意味着已停止。

选择

  • false

  • true

enabled

布尔值

服务是否已启用，如果禁用，则也意味着已停止。请注意，服务可以启用并被“downed”（不自动重启）。

选择

  • false

  • true

name

字符串 / 必需

要管理的服务名称。

service_dir

字符串

svscan 监视服务的目录

默认值： "/service"

service_src

字符串

定义服务的目录，指向 service_dir 的符号链接的源。

默认值： "/etc/service"

state

字符串

started/stopped 是幂等操作，除非必要，否则不会运行命令。restarted 将始终重启 svc (svc -t)，killed 将始终重启 svc (svc -k)。reloaded 将发送 sigusr1 (svc -1)。once 将运行一次正常 “downed” 的 svc (svc -o)，不是真正的幂等操作。

选择

  • "killed"

  • "once"

  • "reloaded"

  • "restarted"

  • "started"

  • "stopped"

属性

属性

支持

描述

check_mode

支持： 完全

可以在 check_mode 中运行，并在不修改目标的情况下返回更改状态预测。

diff_mode

支持： 无

当处于差异模式时，将返回有关已更改（或可能需要在 check_mode 中更改）的详细信息。

示例

- name: Start svc dnscache, if not running
  community.general.svc:
    name: dnscache
    state: started

- name: Stop svc dnscache, if running
  community.general.svc:
    name: dnscache
    state: stopped

- name: Kill svc dnscache, in all cases
  community.general.svc:
    name: dnscache
    state: killed

- name: Restart svc dnscache, in all cases
  community.general.svc:
    name: dnscache
    state: restarted

- name: Reload svc dnscache, in all cases
  community.general.svc:
    name: dnscache
    state: reloaded

- name: Using alternative svc directory location
  community.general.svc:
    name: dnscache
    state: reloaded
    service_dir: /var/service

作者

  • Brian Coca (@bcoca)