Win-IIS

Gérez la configuration de base d'IIS (Internet Information Services) sur un serveur Windows. La fonctionnalité Web-Server sera installée si elle n'est pas présente.

Variables de rôle

Utilisez les variables suivantes pour créer ou mettre à jour le pool d'applications utilisé par le site :

• iis_app_pool_name : Le nom du pool d'applications à créer ou mettre à jour et associer au site ; par défaut, c'est 'DefaultAppPool'.
• iis_app_pool_attributes : Attributs supplémentaires pour la configuration du pool d'applications ; par défaut, c'est '', ce qui n'indique aucun attribut supplémentaire.

Utilisez les variables suivantes pour configurer les options de base du site IIS :

• iis_site_name : Nom du site IIS ; par défaut, c'est 'Default Web Site'.
• iis_site_id : ID numérique du site, peut uniquement être spécifié lors de la création d'un nouveau site ; par défaut, c'est '', ce qui omet l'ID du site.
• iis_site_ip : Adresse IP à écouter pour les connexions ; par défaut, c'est '*', ce qui écoute toutes les adresses.
• iis_site_port : Port à écouter pour les connexions ; par défaut, c'est 80.
• iis_site_ssl : Activer le site pour gérer le trafic SSL ; par défaut, c'est false. Utilisez les options de liaison ci-dessous pour spécifier le nom d'hôte, le protocole et les informations de certificat pour le site SSL.
• iis_site_hostname : Nom d'hôte principal du site, par défaut, c'est '', ce qui répond à tout nom d'hôte non configuré pour un autre site sur la même IP et le même port.
• iis_site_path : Répertoire contenant les fichiers servis par ce site, sera créé s'il n'existe pas encore. Par défaut, c'est 'C:\inetpub\wwwroot', qui est le chemin par défaut habituel configuré lors de l'installation d'IIS.
• iis_site_parameters : Paramètres supplémentaires pour la configuration du site ; par défaut, c'est '', ce qui n'indique aucun paramètre supplémentaire.
• iis_site_state : L'état du site ; par défaut, c'est 'started'. 'absent' peut être utilisé pour supprimer un site.
• iis_site_web_config : Chemin local vers un modèle Jinja qui sera utilisé pour créer un fichier web.config dans iis_site_path. Par défaut, c'est "", ce qui ne crée pas de fichier web.config.
• iis_site_web_config_force : Écrire toujours un fichier web.config même s'il existe déjà ; par défaut, c'est true.

Utilisez les variables suivantes pour spécifier d'autres noms d'hôtes, adresses ou ports où le site doit être servi. Les variables iis_binding_* fournissent des valeurs par défaut pour toutes les liaisons qui peuvent être remplacées pour chaque élément dans iis_bindings.

• iis_binding_host_header : Nom d'hôte supplémentaire pour les liaisons, par défaut c'est ''.
• iis_binding_ip : Adresse IP supplémentaire à écouter pour les connexions ; par défaut, c'est '*'.
• iis_binding_port : Port supplémentaire à écouter pour les connexions ; par défaut, c'est 80.
• iis_binding_protocol : Protocole à utiliser pour les connexions ; par défaut, c'est 'http'. Les valeurs prises en charge sont 'http', 'https' et 'ftp'.
• iis_binding_state : L'état de la liaison ; par défaut, c'est 'present'. Utilisez 'absent' pour supprimer une liaison.
• iis_binding_certificate_store_name : Nom du magasin de certificats contenant le certificat SSL ; par défaut, c'est 'My'.
• iis_binding_certificate_hash : Hachage du certificat du certificat SSL ; par défaut, c'est '', ce qui ne spécifie pas de certificat.
• iis_bindings : Une liste d'éléments spécifiant les liaisons du site, où chaque élément peut utiliser l'une des clés suivantes pour remplacer les valeurs par défaut ci-dessus :
  • host_header
  • ip
  • port
  • protocol
  • state
  • certificate_store_name
  • certificate_hash

Utilisez les variables suivantes pour remplacer lespermissions du système de fichiers définies sur le chemin du site :

• iis_acl_path : Chemin pour mettre à jour l'ACL, par défaut c'est iis_site_path. Spécifiez "" (une chaîne vide) pour sauter les mises à jour ACL.
• iis_acl_user : Groupe d'utilisateurs IIS ; par défaut, c'est 'IIS_IUSRS'.
• iis_acl_rights : Droits à attribuer à l'utilisateur ou au groupe ; par défaut, c'est 'FullControl'.
• iis_acl_type : Type d'ACL ; par défaut, c'est 'allow'.
• iis_acl_state : État de l'ACL ; par défaut, c'est 'present'.
• iis_acl_inherit : Options d'héritage de l'ACL ; par défaut, c'est 'ContainerInherit, ObjectInherit'.
• iis_acl_propagation : Options de propagation de l'ACL ; par défaut, c'est 'None'.

Exemple de Playbook

Le playbook d'exemple suivant supprime le site web IIS par défaut, puis ajoute un nouveau site qui est servi sur le port 8080 en plus du port 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: 'Mon Nouveau Site'
      iis_site_path: 'C:\www\monnouveausite'
      iis_bindings:
        - port: 8080

Licence

BSD

Informations sur l'auteur

Chris Church chris@ninemoreminutes.com