win_nssm – NSSM - the Non-Sucking Service Manager
New in version 2.0.
Обзор
- nssm — это помощник для служб, который не тормозит. Дополнительную информацию см. на https://nssm.cc/.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- nssm >= 2.24.0 # (установка через win_chocolatey)
win_chocolatey: name=nssm
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| app_parameters - | Строка, представляющая словарь параметров, которые будут переданы при запуске приложения. Используйте либо этот параметр, либо app_parameters_free_form, но не оба одновременно. | |
| app_parameters_free_form - добавлен в 2.3.0 | Одна строка параметров, которые будут переданы службе. Используйте либо этот параметр, либо app_parameters, но не оба одновременно. | |
| application - | Исполняемый файл приложения, который нужно запустить как службу Укажите этот параметр, когда необходимо установить службу (состояние: присутствует, запущена, остановлена, перезапущена) Обратите внимание, что имя приложения должно выглядеть следующим образом, если в каталоге есть пробелы: nssm install service "C:\\Program Files\\app.exe\\" "C:\\Path with spaces\\" Для получения дополнительной информации см. коммит 0b386fc1984ab74ee59b7bed14b7e8f57212c22b в проекте nssm.git: https://git.nssm.cc/?p=nssm.git;a=commit;h=0b386fc1984ab74ee59b7bed14b7e8f57212c22b
| |
| dependencies - | Зависимости службы, которые должны быть запущены, чтобы запустить ее, разделенные запятыми. | |
| name - / обязательно | Имя службы, на которой нужно выполнить операцию. | |
| password - | Пароль, который необходимо использовать для запуска службы. | |
| start_mode - |
| Если выбран auto, служба будет запускаться при загрузке.delayed вызывает отложенный, но автоматический запуск после загрузки (добавлен в версии 2.5).manual означает, что служба будет запускаться только тогда, когда ей потребуется другая служба.disabled означает, что служба останется выключенной, независимо от того, нужна она или нет. |
| state - |
| Состояние службы в системе. Обратите внимание, что такие действия NSSM, как «пауза», «продолжить», «поворот» не подходят для декларативного стиля Ansible, поэтому их следует реализовать с помощью модуля команды ansible. |
| stderr_file - | Путь для приема выходных данных об ошибках. | |
| stdout_file - | Путь для приема выходных данных. | |
| user - | Пользователь, который будет использоваться для запуска службы. |
Примеры
# Install and start the foo service
- win_nssm:
name: foo
application: C:\windows\foo.exe
# Install and start the foo service with a key-value pair argument
# This will yield the following command: C:\windows\foo.exe -bar true
- win_nssm:
name: foo
application: C:\windows\foo.exe
app_parameters: -bar=true
# Install and start the foo service with a single parameter
# This will yield the following command: C:\windows\\foo.exe bar
- win_nssm:
name: foo
application: C:\windows\foo.exe
app_parameters: _=bar
# Install and start the foo service with a mix of single params, and key value pairs
# This will yield the following command: C:\windows\\foo.exe bar -file output.bat -foo false
- win_nssm:
name: foo
application: C:\windows\foo.exe
app_parameters: _=bar; -file=output.bat; -foo=false
# Use the single line parameters option to specify an arbitrary string of parameters
# for the service executable
- name: Make sure the Consul service runs
win_nssm:
name: consul
application: C:\consul\consul.exe
app_parameters_free_form: agent -config-dir=C:\consul\config
stdout_file: C:\consul\log.txt
stderr_file: C:\consul\error.txt
# Install and start 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
# Install and start the foo service, but wait for dependencies tcpip and adf
- win_nssm:
name: foo
application: C:\windows\foo.exe
dependencies: 'adf,tcpip'
# Install and start the foo service with dedicated user
- win_nssm:
name: foo
application: C:\windows\foo.exe
user: foouser
password: secret
# Install the foo service but do not start it automatically
- win_nssm:
name: foo
application: C:\windows\foo.exe
state: present
start_mode: manual
# Remove the foo service
- win_nssm:
name: foo
state: absent
Статус
- Данному модулю не гарантируется обратная совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Adam Keech (@smadam813)
- George Frank (@georgefrank)
- Hans-Joachim Kliemeck (@h0nIg)
- Michael Wild (@themiwi)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/win_nssm_module.html