cchurch.win-iis

Win-IIS

Verwalte die grundlegende IIS (Internet Information Services) Konfiguration auf Windows Server. Die Funktion Web-Server wird installiert, falls nicht vorhanden.

Rollenvariablen

Verwende die folgenden Variablen, um den Anwendungspool zu erstellen oder zu aktualisieren, der mit der Website verbunden ist:

iis_app_pool_name: Name des Anwendungspools, der erstellt oder aktualisiert werden soll; Standard ist 'DefaultAppPool'.
iis_app_pool_attributes: Zusätzliche Attribute zur Konfiguration des Anwendungspools; Standard ist '', was keine zusätzlichen Attribute angibt.

Verwende die folgenden Variablen, um grundlegende IIS-Websiteoptionen zu konfigurieren:

iis_site_name: Name der IIS-Website; Standard ist 'Default Web Site'.
iis_site_id: Numerische Website-ID, kann nur angegeben werden, wenn eine neue Website erstellt wird; Standard ist '', was die Website-ID weglässt.
iis_site_ip: IP-Adresse, um auf Verbindungen zu hören; Standard ist '*', was auf allen Adressen hört.
iis_site_port: Port, um auf Verbindungen zu hören; Standard ist 80.
iis_site_ssl: Ermöglicht es der Website, SSL-Verkehr zu verarbeiten; Standard ist false. Verwende die untenstehenden Bindungsoptionen, um den Hostnamen, das Protokoll und die Zertifikatinformationen für die SSL-Website anzugeben.
iis_site_hostname: Primärer Hostname für die Website, Standard ist '', was auf jeden Hostnamen reagiert, der nicht für eine andere Website auf derselben IP und demselben Port konfiguriert ist.
iis_site_path: Verzeichnis mit den von dieser Website bereitgestellten Dateien, wird erstellt, falls es noch nicht vorhanden ist. Standard ist 'C:\inetpub\wwwroot', was der übliche Standardpfad ist, der bei der Installation von IIS konfiguriert wird.
iis_site_parameters: Zusätzliche Parameter zur Konfiguration der Website; Standard ist '', was keine zusätzlichen Parameter angibt.
iis_site_state: Der Zustand der Website; Standard ist 'started'. 'absent' kann verwendet werden, um eine Website zu entfernen.
iis_site_web_config: Lokaler Pfad zu einer Jinja-Vorlage, die verwendet wird, um eine web.config-Datei im iis_site_path zu erstellen. Standard ist "", was keine web.config-Datei erstellt.
iis_site_web_config_force: Immer eine web.config-Datei schreiben, selbst wenn bereits eine existiert; Standard ist true.

Verwende die folgenden Variablen, um zusätzliche Hostnamen, Adressen oder Ports anzugeben, unter denen die Website bereitgestellt werden soll. Die iis_binding_*-Variablen bieten Standardwerte für alle Bindungen, die für jeden Eintrag in iis_bindings überschrieben werden können.

iis_binding_host_header: Zusätzlicher Hostname für Bindungen, Standard ist ''.
iis_binding_ip: Zusätzliche IP-Adresse, um auf Verbindungen zu hören; Standard ist '*'.
iis_binding_port: Zusätzlicher Port, um auf Verbindungen zu hören; Standard ist 80.
iis_binding_protocol: Protokoll, das für Verbindungen verwendet werden soll; Standard ist 'http'. Unterstützte Werte sind 'http', 'https' und 'ftp'.
iis_binding_state: Der Zustand der Bindung; Standard ist 'present'. Verwende 'absent', um eine Bindung zu entfernen.
iis_binding_certificate_store_name: Name des Zertifikatspeichers, der das SSL-Zertifikat enthält; Standard ist 'My'.
iis_binding_certificate_hash: Zertifikat-Hash des SSL-Zertifikats; Standard ist '', was kein Zertifikat angibt.
iis_bindings: Eine Liste von Elementen, die die Website-Bindungen spezifiziert, wobei jedes Element eine der folgenden Schlüssel verwenden kann, um die oben genannten Standardwerte zu überschreiben:
- host_header
- ip
- port
- protocol
- state
- certificate_store_name
- certificate_hash

Verwende die folgenden Variablen, um die Dateisystemberechtigungen für den Website-Pfad zu überschreiben:

iis_acl_path: Pfad zur Aktualisierung der ACL, Standard ist iis_site_path. Gib "" (einen leeren String) an, um ACL-Aktualisierungen zu überspringen.
iis_acl_user: IIS-Benutzergruppe; Standard ist 'IIS_IUSRS'.
iis_acl_rights: Rechte, die dem Benutzer oder der Gruppe zugewiesen werden sollen; Standard ist 'FullControl'.
iis_acl_type: ACL-Typ; Standard ist 'allow'.
iis_acl_state: ACL-Zustand; Standard ist 'present'.
iis_acl_inherit: ACL-Vererbungsoptionen; Standard ist 'ContainerInherit, ObjectInherit'.
iis_acl_propagation: ACL-Propagation Optionen; Standard ist 'None'.

Beispiel-Playbook

Das folgende Beispiel-Playbook entfernt die Standard-IIS-Website und fügt dann eine neue Website hinzu, die neben Port 80 auch auf Port 8080 bereitgestellt wird:

- hosts: windows
  roles:
    - role: cchurch.win-iis
      iis_site_name: 'Default Web Site'
      iis_site_state: absent        
    - role: cchurch.win-iis
      iis_site_name: 'Meine Neue Seite'
      iis_site_path: 'C:\www\meinenneuesseite'
      iis_bindings:
        - port: 8080