Spec-Zone.ru › Ansible 2.8

win_nssm – Установка службы с помощью NSSM

Новое в версии 2.0.

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • См. также
  • Примеры
  • Статус

Обзор

  • Установка службы Windows с помощью оболочки NSSM.
  • NSSM — вспомогательная программа для служб, которая не ужасна. Для получения дополнительной информации посетите https://nssm.cc/.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

  • nssm >= 2.24.0 # (установка через win_chocolatey) win_chocolatey: name=nssm

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
app_parameters
строка
Строка, представляющая словарь параметров, передаваемых приложению при запуске.
УСТЕРЕЖДЁН с версии 2.8, используйте вместо этого arguments.
Взаимоисключающее с arguments.
application
путь
Исполняемый файл приложения, который нужно запустить как службу.
Требуется, когда state — present, started, stopped, или restarted.
arguments
строка
добавлено в 2.3
Параметры, передаваемые приложению при запуске.
Может быть простой строкой или списком.
Этот параметр был переименован из app_parameters_free_form в версии 2.8.
Взаимоисключающее с app_parameters.

псевдонимы: app_parameters_free_form
dependencies
список
Зависимости службы, которые должны быть запущены для запуска, разделенные запятыми.
УСТЕРЕЖДЁН с версии 2.8, используйте вместо этого модуль win_service.
description
строка
добавлено в 2.8.0
Описание, которое нужно установить для службы.
display_name
строка
добавлено в 2.8.0
Отображаемое имя, которое нужно установить для службы.
executable
путь
добавлено в 2.8.0
По умолчанию:
"nssm.exe"
Расположение утилиты NSSM (в случае, если она не находится в вашей переменной среды PATH).
name
строка / обязательно
Имя службы, с которой нужно работать.
password
строка
Пароль, используемый для запуска службы.
УСТЕРЕЖДЁН с версии 2.8, используйте вместо этого модуль win_service.
start_mode
строка
    Варианты:
  • auto ←
  • delayed
  • disabled
  • manual
Если выбрано auto, служба будет запускаться при загрузке.
delayed вызывает отложенный, но автоматический запуск после загрузки (добавлено в версии 2.5).
manual означает, что служба будет запущена только тогда, когда это потребуется другой службе.
disabled означает, что служба будет оставаться выключенной, независимо от того, нужна она или нет.
УСТЕРЕЖДЁН с версии 2.8, используйте вместо этого модуль win_service.
state
строка
    Варианты:
  • absent
  • present ←
  • started
  • stopped
  • restarted
Состояние службы в системе.
Значения started, stopped, и restarted устарели с версии 2.8, используйте вместо этого модуль win_service для запуска, остановки или перезапуска службы.
stderr_file
путь
Путь для получения вывода ошибок.
stdout_file
путь
Путь для получения вывода.
user
строка
Пользователь, который будет использоваться для запуска службы.
УСТЕРЕЖДЁН с версии 2.8, используйте вместо этого модуль win_service.
working_directory
путь
добавлено в 2.8.0
Рабочая директория для запуска исполняемого файла службы (по умолчанию — директория, содержащая исполняемый файл приложения).

псевдонимы: app_directory, chdir

Примечания

Примечание

  • Служба НЕ будет запущена после ее создания, если state=present.
  • После создания службы вы можете использовать модуль win_service для ее запуска или настройки дополнительных свойств, таких как тип запуска, зависимости, учетная запись службы и т. д.

См. также

См. также

win_service – Управление и запросы служб Windows
Официальная документация модуля win_service.

Примеры

- name: Install the foo service
  win_nssm:
    name: foo
    application: C:\windows\foo.exe

# This will yield the following command: C:\windows\foo.exe bar "true"
- name: Install the Consul service with a list of parameters
  win_nssm:
    name: Consul
    application: C:\consul\consul.exe
    arguments:
      - agent
      - -config-dir=C:\consul\config

# This is strictly equivalent to the previous example
- name: Install the Consul service with an arbitrary string of parameters
  win_nssm:
    name: Consul
    application: C:\consul\consul.exe
    arguments: agent -config-dir=C:\consul\config


# Install the foo service, and then configure and start it with win_service
- name: Install the foo service, redirecting stdout and stderr to the same file
  win_nssm:
    name: foo
    application: C:\windows\foo.exe
    stdout_file: C:\windows\foo.log
    stderr_file: C:\windows\foo.log

- name: Configure and start the foo service using win_service
  win_service:
    name: foo
    dependencies: [ adf, tcpip ]
    user: foouser
    password: secret
    start_mode: manual
    state: started

- name: Remove the foo service
  win_nssm:
    name: foo
    state: absent

Статус

  • Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
  • Этот модуль поддерживается сообществом Ansible. [community]

Авторы

  • Adam Keech (@smadam813)
  • George Frank (@georgefrank)
  • Hans-Joachim Kliemeck (@h0nIg)
  • Michael Wild (@themiwi)
  • Kevin Subileau (@ksubileau)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/win_nssm_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API