Win-IIS

Zarządzaj podstawową konfiguracją IIS (Internet Information Services) na serwerze Windows. Funkcja Web-Server zostanie zainstalowana, jeśli nie jest obecna.

Zmienne roli

Użyj następujących zmiennych, aby utworzyć lub zaktualizować pulę aplikacji używaną przez witrynę:

• iis_app_pool_name: Nazwa puli aplikacji do utworzenia lub aktualizacji i powiązania z witryną; domyślna wartość to 'DefaultAppPool'.
• iis_app_pool_attributes: Dodatkowe atrybuty do konfiguracji puli aplikacji; domyślna wartość to '', co oznacza brak dodatkowych atrybutów.

Użyj następujących zmiennych do skonfigurowania podstawowych opcji witryny IIS:

• iis_site_name: Nazwa witryny IIS; domyślna wartość to 'Default Web Site'.
• iis_site_id: Numeryczne ID witryny, może być określone tylko podczas tworzenia nowej witryny; domyślna wartość to '', co oznacza brak ID witryny.
• iis_site_ip: Adres IP do nasłuchiwania połączeń; domyślna wartość to '*', co oznacza nasłuchiwanie na wszystkich adresach.
• iis_site_port: Port do nasłuchiwania połączeń; domyślna wartość to 80.
• iis_site_ssl: Włącz witrynę do obsługi ruchu SSL; domyślna wartość to false. Użyj opcji powiązań poniżej, aby określić nazwę hosta, protokół i informacje o certyfikacie dla witryny SSL.
• iis_site_hostname: Główna nazwa hosta dla witryny, domyślna wartość to '', co oznacza odpowiedź na dowolną nazwę hosta, która nie jest skonfigurowana dla innej witryny na tym samym IP i porcie.
• iis_site_path: Katalog zawierający pliki serwowane przez tę witrynę, zostanie utworzony, jeśli jeszcze nie istnieje. Domyślna wartość to 'C:\inetpub\wwwroot', co jest zwykłą domyślną ścieżką konfigurowaną podczas instalacji IIS.
• iis_site_parameters: Dodatkowe parametry do konfiguracji witryny; domyślna wartość to '', co oznacza brak dodatkowych parametrów.
• iis_site_state: Stan witryny; domyślna wartość to 'started'. 'absent' można użyć do usunięcia witryny.
• iis_site_web_config: Lokalna ścieżka do szablonu Jinja, który zostanie użyty do utworzenia pliku web.config w iis_site_path. Domyślna wartość to "", co oznacza, że plik web.config nie zostanie utworzony.
• iis_site_web_config_force: Zawsze twórz plik web.config, nawet jeśli już istnieje; domyślna wartość to true.

Użyj następujących zmiennych, aby określić dodatkowe nazwy hostów, adresy lub porty, na których witryna powinna być serwowana. Zmienne iis_binding_* dostarczają domyślnych wartości dla wszystkich powiązań, które mogą być nadpisane dla każdego elementu w iis_bindings.

• iis_binding_host_header: Dodatkowa nazwa hosta dla powiązań, domyślna wartość to ''.
• iis_binding_ip: Dodatkowy adres IP do nasłuchiwania połączeń; domyślna wartość to '*'.
• iis_binding_port: Dodatkowy port do nasłuchiwania połączeń; domyślna wartość to 80.
• iis_binding_protocol: Protokół do użycia w połączeniach; domyślna wartość to 'http'. Obsługiwane wartości to 'http', 'https' i 'ftp'.
• iis_binding_state: Stan powiązania; domyślna wartość to 'present'. Użyj 'absent', aby usunąć powiązanie.
• iis_binding_certificate_store_name: Nazwa magazynu certyfikatów zawierającego certyfikat SSL; domyślna wartość to 'My'.
• iis_binding_certificate_hash: Hash certyfikatu SSL; domyślna wartość to '', co oznacza brak określonego certyfikatu.
• iis_bindings: Lista elementów określających powiązania witryny, gdzie każdy element może używać dowolnych z następujących kluczy do nadpisania powyższych domyślnych wartości:
  • host_header
  • ip
  • port
  • protocol
  • state
  • certificate_store_name
  • certificate_hash

Użyj następujących zmiennych, aby nadpisać uprawnienia do systemu plików ustawione na ścieżce do witryny:

• iis_acl_path: Ścieżka do aktualizacji ACL, domyślna wartość to iis_site_path. Określ "" (pusty ciąg), aby pominąć aktualizacje ACL.
• iis_acl_user: Grupa użytkowników IIS; domyślna wartość to 'IIS_IUSRS'.
• iis_acl_rights: Uprawnienia do przypisania do użytkownika lub grupy; domyślna wartość to 'FullControl'.
• iis_acl_type: Typ ACL; domyślna wartość to 'allow'.
• iis_acl_state: Stan ACL; domyślna wartość to 'present'.
• iis_acl_inherit: Opcje dziedziczenia ACL; domyślna wartość to 'ContainerInherit, ObjectInherit'.
• iis_acl_propagation: Opcje propagacji ACL; domyślna wartość to 'None'.

Przykładowy plik zadań

Poniższy przykładowy plik zadań usuwa domyślną witrynę IIS, a następnie dodaje nową witrynę serwowaną na porcie 8080 oprócz portu 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

Licencja

BSD

Informacje o autorze

Chris Church chris@ninemoreminutes.com