Win-IIS

Gestiona la configuración básica de IIS (Servicios de Información de Internet) en Windows Server. La característica Web-Server se instalará si no está presente.

Variables del Rol

Utiliza las siguientes variables para crear o actualizar el grupo de aplicaciones que utiliza el sitio:

• iis_app_pool_name: El nombre del grupo de aplicaciones a crear o actualizar y asociar con el sitio; el valor por defecto es 'DefaultAppPool'.
• iis_app_pool_attributes: Atributos adicionales para la configuración del grupo de aplicaciones; el valor por defecto es '', lo que no especificará ningún atributo adicional.

Utiliza las siguientes variables para configurar opciones básicas del sitio IIS:

• iis_site_name: Nombre del sitio IIS; el valor por defecto es 'Default Web Site'.
• iis_site_id: ID numérico del sitio, solo se puede especificar al crear un nuevo sitio; el valor por defecto es '', que omite el ID del sitio.
• iis_site_ip: Dirección IP para escuchar conexiones; el valor por defecto es '*', que escucha en todas las direcciones.
• iis_site_port: Puerto para escuchar conexiones; el valor por defecto es 80.
• iis_site_ssl: Habilitar el sitio para manejar tráfico SSL; el valor por defecto es false. Usa las opciones de enlace a continuación para especificar el nombre de host, protocolo e información del certificado para el sitio SSL.
• iis_site_hostname: Nombre de host principal para el sitio, el valor por defecto es '', que responderá a cualquier nombre de host que no esté configurado para otro sitio en la misma IP y puerto.
• iis_site_path: Directorio que contiene los archivos servidos por este sitio, se creará si aún no existe. El valor por defecto es 'C:\inetpub\wwwroot', que es la ruta predeterminada usual configurada al instalar IIS.
• iis_site_parameters: Parámetros adicionales para la configuración del sitio; el valor por defecto es '', que no especificará parámetros adicionales.
• iis_site_state: El estado del sitio; el valor por defecto es 'started'. 'absent' puede usarse para eliminar un sitio.
• iis_site_web_config: Ruta local a una plantilla Jinja que se utilizará para crear un archivo web.config en iis_site_path. El valor por defecto es "", que no crea un archivo web.config.
• iis_site_web_config_force: Siempre escribir un archivo web.config incluso si ya existe uno; el valor por defecto es true.

Utiliza las siguientes variables para especificar nombres de host, direcciones o puertos adicionales donde se debe servir el sitio. Las variables iis_binding_* proporcionan valores predeterminados para todos los enlaces que pueden ser sobreescritos por cada elemento en iis_bindings.

• iis_binding_host_header: Nombre de host adicional para enlaces, el valor por defecto es ''.
• iis_binding_ip: Dirección IP adicional para escuchar conexiones; el valor por defecto es '*'.
• iis_binding_port: Puerto adicional para escuchar conexiones; el valor por defecto es 80.
• iis_binding_protocol: Protocolo a utilizar para las conexiones; el valor por defecto es 'http'. Los valores soportados son 'http', 'https' y 'ftp'.
• iis_binding_state: El estado del enlace; el valor por defecto es 'present'. Usa 'absent' para eliminar un enlace.
• iis_binding_certificate_store_name: Nombre del almacén de certificados que contiene el certificado SSL; el valor por defecto es 'My'.
• iis_binding_certificate_hash: Hash del certificado SSL; el valor por defecto es '', lo que no especifica un certificado.
• iis_bindings: Una lista de elementos que especifican enlaces de sitio, donde cada elemento puede usar cualquiera de las siguientes claves para sobrescribir los valores predeterminados anteriores:
  • host_header
  • ip
  • port
  • protocol
  • state
  • certificate_store_name
  • certificate_hash

Utiliza las siguientes variables para sobrescribir los permisos del sistema de archivos establecidos en la ruta del sitio:

• iis_acl_path: Ruta para actualizar ACL, el valor por defecto es iis_site_path. Especifica "" (una cadena vacía) para omitir actualizaciones de ACL.
• iis_acl_user: Grupo de usuarios de IIS; el valor por defecto es 'IIS_IUSRS'.
• iis_acl_rights: Derechos a asignar al usuario o grupo; el valor por defecto es 'FullControl'.
• iis_acl_type: Tipo de ACL; el valor por defecto es 'allow'.
• iis_acl_state: Estado de ACL; el valor por defecto es 'present'.
• iis_acl_inherit: Opciones de herencia de ACL; el valor por defecto es 'ContainerInherit, ObjectInherit'.
• iis_acl_propagation: Opciones de propagación de ACL; el valor por defecto es 'None'.

Ejemplo de Playbook

El siguiente ejemplo de playbook elimina el sitio web IIS predeterminado, luego agrega un nuevo sitio que se sirve en el puerto 8080 además del puerto 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

Licencia

BSD

Información del Autor

Chris Church chris@ninemoreminutes.com