win_iis_webapppool - настройка пула веб-приложений IIS
Новая версия 2.0.
Обзор
- Создает, удаляет и настраивает пул веб-приложений IIS.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| attributes | Начиная с Ansible 2.4, это поле может принимать записи словаря для настройки атрибутов пула приложений. Эти атрибуты основаны на стандартной схеме именования по адресу https://www.iis.net/configreference/system.applicationhost/applicationpools/add#005, см. раздел «Примеры» для получения более подробной информации о способе настройки. Также можно настраивать атрибуты дочерних элементов, таких как cpu и processModel, см. примеры для ознакомления с этим. Хотя вы можете использовать числовые значения для перечислений, рекомендуется использовать само имя перечисления, например, используйте SpecificUser вместо 3 для processModel.identityType. managedPipelineMode может быть либо "Integrated", либо "Classic". startMode может быть либо "OnDemand", либо "AlwaysRunning". Используйте параметр модуля state для изменения состояния пула приложений.При попытке установить 'processModel.password' и получении ошибки 'Значение не входит в ожидаемый диапазон', у вас поврежденный хранилище ключей. Следуйте инструкциям по адресу http://structuredsight.com/2014/10/26/im-out-of-range-youre-out-of-range/, чтобы исправить проблему. УСТАНОВЛЕНО В СТАДИИ ПРЕДВАРИТЕЛЬНОГО ПРОСМОТРА. Начиная с Ansible 2.4, это поле должно задаваться с использованием формы словаря, в более старых версиях Ansible это поле использовалось как строка. Эта строка содержит атрибуты, разделенные символом '|' и имена/значения атрибутов, разделенные двоеточием ':'. Пример: "startMode:OnDemand|managedPipelineMode:Classic". | |
| name обязательно | Имя пула приложений. | |
| state |
| Состояние пула приложений. Если present гарантирует, что пул приложений настроен и существует.Если absent гарантирует, что пул приложений будет удален.Если stopped гарантирует, что пул приложений существует и остановлен.Если started гарантирует, что пул приложений существует и запущен.Если restarted гарантирует, что пул приложений существует и будет перезапущен. Это никогда не является идемпотентным. |
Примеры
- name: return information about an existing application pool
win_iis_webapppool:
name: DefaultAppPool
state: present
- name: create a new application pool in 'Started' state
win_iis_webapppool:
name: AppPool
state: started
- name: stop an application pool
win_iis_webapppool:
name: AppPool
state: stopped
- name: restart an application pool (non-idempotent)
win_iis_webapppool:
name: AppPool
state: restart
- name: change application pool attributes using new dict style
win_iis_webapppool:
name: AppPool
attributes:
managedRuntimeVersion: v4.0
autoStart: false
# Note this format style has been deprecated, please use the newer dict style instead
- name: change application pool attributes using older string style
win_iis_webapppool:
name: AppPool
attributes: 'managedRuntimeVersion:v4.0|autoStart:false'
# This is the preferred style to use when setting attributes
- name: creates an application pool, sets attributes and starts it
win_iis_webapppool:
name: AnotherAppPool
state: started
attributes:
managedRuntimeVersion: v4.0
autoStart: false
# In the below example we are setting attributes in child element processModel
# https://www.iis.net/configreference/system.applicationhost/applicationpools/add/processmodel
- name: manage child element and set identity of application pool
win_iis_webapppool:
name: IdentitiyAppPool
state: started
attributes:
managedPipelineMode: Classic
processModel.identityType: SpecificUser
processModel.userName: '{{ansible_user}}'
processModel.password: '{{ansible_password}}'
processModel.loadUserProfile: True
- name: manage a timespan attribute
win_iis_webapppool:
name: TimespanAppPool
state: started
attributes:
# Timespan with full string "day:hour:minute:second.millisecond"
recycling.periodicRestart.time: "00:00:05:00.000000"
recycling.periodicRestart.schedule: ["00:10:00", "05:30:00"]
# Shortened timespan "hour:minute:second"
processModel.pingResponseTime: "00:03:00"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| attributes словарь | success | Атрибуты пула приложений, которые были установлены и обработаны этим вызовом модуля. Пример: {'managedPipelineMode': 'Classic', 'enable32BitAppOnWin64': 'true', 'managedRuntimeVersion': 'v4.0'} | |
| info сложный | success | Информация о текущем состоянии пула приложений. См. https://www.iis.net/configreference/system.applicationhost/applicationpools/add#005 для получения полного списка атрибутов возврата, в зависимости от вашей версии IIS. | |
| failure словарь | success | Ключевые пары, показывающие текущие атрибуты сбоя пула приложений. Пример: {'autoShutdownExe': '', 'orphanActionExe': '', 'rapidFailProtextionInterval': {'Hours': 0, 'Days': 0}} | |
| state строка | success | Текущее состояние выполнения пула в момент завершения модуля. Пример: Запущен | |
| name строка | success | Имя пула приложений, который был обработан этим вызовом модуля. Пример: DefaultAppPool | |
| attributes словарь | success | Ключевые пары, показывающие текущие атрибуты пула приложений. Пример: {'managedRuntimeLoader': 'webengine4.dll', 'applicationPoolSid': 'S-1-5-82-1352790163-598702362-1775843902-1923651883-1762956711', 'managedPipelineMode': 'Classic', 'enable32BitAppOnWin64': True, 'name': 'DefaultAppPool', 'passAnonymousToken': True, 'CLRConfigFile': '', 'queueLength': 1000, 'state': 'Started', 'enableConfigurationOverride': True, 'autoStart': True, 'startMode': 'OnDemand', 'managedRuntimeVersion': 'v4.0'} | |
| processModel словарь | success | Ключевые пары, показывающие текущие атрибуты processModel пула приложений. Пример: {'logonType': 'LogonBatch', 'identityType': 'ApplicationPoolIdentity', 'pingInterval': {'Hours': 0, 'Days': 0}} | |
| recycling словарь | success | Ключевые пары, показывающие текущие атрибуты перезапуска пула приложений. Пример: {'disallowOverlappingRotation': False, 'disallowRotationOnConfigChange': False, 'logEventOnRecycle': 'Time,Requests,Schedule,Memory,IsapiUnhealthy,OnDemand,ConfigChange,PrivateMemory'} | |
| cpu словарь | success | Ключевые пары, показывающие текущие атрибуты cpu пула приложений. Пример: {'action': 'NoAction', 'limit': 0, 'resetInterval': {'Hours': 0, 'Days': 0}} | |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.
Автор
- Henrik Wallström (@henrikwallstrom)
- Jordan Borean (@jborean93)
Подсказка
Если вы заметите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ для улучшения.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/win_iis_webapppool_module.html
