cchurch.win-iis

Win-IIS

Управление базовой конфигурацией IIS (Службы интернет-информации) на Windows Server. Функция Web-Server будет установлена, если отсутствует.

Переменные роли

Используйте следующие переменные для создания или обновления пула приложений, используемого сайтом:

iis_app_pool_name: Имя пула приложений для создания или обновления и связывания с сайтом; по умолчанию 'DefaultAppPool'.
iis_app_pool_attributes: Дополнительные атрибуты для настройки пула приложений; по умолчанию '', что не указывает никакие дополнительные атрибуты.

Используйте следующие переменные для настройки основных параметров сайта IIS:

iis_site_name: Имя сайта IIS; по умолчанию 'Default Web Site'.
iis_site_id: Числовой идентификатор сайта, может быть указан только при создании нового сайта; по умолчанию '', что исключает идентификатор сайта.
iis_site_ip: IP-адрес для прослушивания соединений; по умолчанию '*', что прослушивает на всех адресах.
iis_site_port: Порт для прослушивания соединений; по умолчанию 80.
iis_site_ssl: Включить сайт для обработки SSL-трафика; по умолчанию false. Используйте параметры привязки ниже для указания имени хоста, протокола и информации о сертификате для SSL-сайта.
iis_site_hostname: Основное имя хоста для сайта, по умолчанию '', что будет отвечать на любое имя хоста, не настроенное для другого сайта на том же IP и порту.
iis_site_path: Каталог, содержащий файлы, обслуживаемые этим сайтом, будет создан, если он еще не существует. По умолчанию 'C:\inetpub\wwwroot', что является обычным путём по умолчанию при установке IIS.
iis_site_parameters: Дополнительные параметры для конфигурации сайта; по умолчанию '', что не указывает никаких дополнительных параметров.
iis_site_state: Состояние сайта; по умолчанию 'started'. 'absent' может быть использовано для удаления сайта.
iis_site_web_config: Локальный путь к шаблону Jinja, который будет использован для создания файла web.config в iis_site_path. По умолчанию "", что не создаёт файл web.config.
iis_site_web_config_force: Всегда записывать файл web.config, даже если он уже существует; по умолчанию true.

Используйте следующие переменные для указания дополнительных имен хостов, адресов или портов, на которых сайт должен обслуживаться. Переменные iis_binding_* обеспечивают значения по умолчанию для всех привязок, которые могут быть переопределены для каждого элемента в iis_bindings.

iis_binding_host_header: Дополнительное имя хоста для привязок, по умолчанию ''.
iis_binding_ip: Дополнительный IP-адрес для прослушивания соединений; по умолчанию '*'.
iis_binding_port: Дополнительный порт для прослушивания соединений; по умолчанию 80.
iis_binding_protocol: Протокол, используемый для соединений; по умолчанию 'http'. Поддерживаемые значения: 'http', 'https' и 'ftp'.
iis_binding_state: Состояние привязки; по умолчанию 'present'. Используйте 'absent' для удаления привязки.
iis_binding_certificate_store_name: Название хранилища сертификатов, содержащего SSL сертификат; по умолчанию 'My'.
iis_binding_certificate_hash: Хэш сертификата SSL; по умолчанию '', что не указывает сертификат.
iis_bindings: Список элементов, указывающих привязки сайта, где каждый элемент может использовать любые из следующих ключей для переопределения значений по умолчанию:
- host_header
- ip
- port
- protocol
- state
- certificate_store_name
- certificate_hash

Используйте следующие переменные, чтобы переопределить права файловой системы, установленные на путь к сайту:

iis_acl_path: Путь для обновления ACL, по умолчанию iis_site_path. Укажите "" (пустую строку), чтобы пропустить обновления ACL.
iis_acl_user: Группа пользователей IIS; по умолчанию 'IIS_IUSRS'.
iis_acl_rights: Права, которые следует предоставить пользователю или группе; по умолчанию 'FullControl'.
iis_acl_type: Тип ACL; по умолчанию 'allow'.
iis_acl_state: Состояние ACL; по умолчанию 'present'.
iis_acl_inherit: Опции наследования ACL; по умолчанию 'ContainerInherit, ObjectInherit'.
iis_acl_propagation: Опции распространения ACL; по умолчанию 'None'.

Пример плейбука

Следующий пример плейбука удаляет сайт по умолчанию IIS, затем добавляет новый сайт, который обслуживается на порту 8080 в дополнение к порту 80:

- hosts: windows
  roles:
    - role: cchurch.win-iis
      iis_site_name: 'Default Web Site'
      iis_site_state: absent        
    - role: cchurch.win-iis
      iis_site_name: 'My New Site'
      iis_site_path: 'C:\www\mynewsite'
      iis_bindings:
        - port: 8080