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 вызывает отложенный, но автоматический запуск после загрузки (добавлено в версии 2.5).manual означает, что служба будет запущена только тогда, когда это потребуется другой службе.disabled означает, что служба будет оставаться выключенной, независимо от того, нужна она или нет.УСТЕРЕЖДЁН с версии 2.8, используйте вместо этого модуль win_service. |
| state строка |
| Состояние службы в системе. Значения 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