ansible.builtin.systemd – Ejemplo de administración de servicios

Nota

Este módulo es parte de ansible-base e incluido en todas las instalaciones de Ansible. En la mayoría de los casos, puede utilizar el nombre corto del módulo systemd incluso sin especificar el collections: palabra clave. A pesar de eso, le recomendamos que utilice el FQCN para facilitar la vinculación a la documentación del módulo y evitar conflictos con otras colecciones que puedan tener el mismo nombre de módulo.

Nuevo en la versión 2.2: de ansible.builtin

• Sinopsis
• Requisitos
• Parámetros
• Notas
• Ejemplos de
• Valores devueltos

Sinopsis

• Controla los servicios de systemd en hosts remotos.

Requisitos

Los siguientes requisitos son necesarios en el host que ejecuta este módulo.

• Un sistema gestionado por systemd.

Parámetros

Notas

Nota

• Desde 2.4, se requiere una de las siguientes opciones ‘state’, ‘enabled’, ‘masked’, ‘daemon_reload’, (‘daemon_reexec’ desde 2.8), y todas excepto ‘daemon_reload’ (y ‘daemon_reexec’ desde 2.8) también requieren ‘nombre’.
• Antes de 2.4, siempre requería ‘nombre’.
• Globs no son compatibles con el nombre, es decir postgres*.service.
• Apoyos check_mode.

Ejemplos de

- name: Make sure a service is running
  ansible.builtin.systemd:
    state: started
    name: httpd

- name: Stop service cron on debian, if running
  ansible.builtin.systemd:
    name: cron
    state: stopped

- name: Restart service cron on centos, in all cases, also issue daemon-reload to pick up config changes
  ansible.builtin.systemd:
    state: restarted
    daemon_reload: yes
    name: crond

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

- name: Enable service httpd and ensure it is not masked
  ansible.builtin.systemd:
    name: httpd
    enabled: yes
    masked: no

- name: Enable a timer for dnf-automatic
  ansible.builtin.systemd:
    name: dnf-automatic.timer
    state: started
    enabled: yes

- name: Just force systemd to reread configs (2.4 and above)
  ansible.builtin.systemd:
    daemon_reload: yes

- name: Just force systemd to re-execute itself (2.8 and above)
  ansible.builtin.systemd:
    daemon_reexec: yes

- name: Run a user service when XDG_RUNTIME_DIR is not set on remote login
  ansible.builtin.systemd:
    name: myservice
    state: started
    scope: user
  environment:
    XDG_RUNTIME_DIR: "/run/user/{{ myuid }}"

Valores devueltos

Los valores de retorno comunes están documentados aquí, los siguientes son los campos exclusivos de este módulo:

Autores

• Equipo principal de Ansible