role: package.www

Parent roles: package . www

URL: https://gitlab.mn.tu-dresden.de/sdm/package.www.git

Description

This role is the top level package of all www categorised software and does not provide a special software product.

Requirement

Variables

• www_root_directory

  • description:
    • path to the root directory of the web service
  • default: /var/www

• www_mimetypes

  • descriptions:
    • list of known mimetypes
  • default: []

• www_list_directory

  • description:
    • enables the listing of a directory
  • default: false

• www_index_files

  • description:
    • list of index files
  • default: [“index.html”]

• www_user:

  • description:
    • The username for the www directory and the service.
  • default: www

• www_group:

  • description:
    • The groupname for the www directory and the service.
  • default: www

• www_ssl_priv_key:

  • description:
    • The SSL private key for the service.
  • default: ""

• www_ssl_cert:

  • description:
    • The SSL certificate for the service.
  • default: ""

• www_ssl_ca_cert:

  • description:
    • The SSL CA certificate for the service.
  • default: ""

• www_ssl_selfsigned:

  • description:
    • This option specifies if selfsigned SSL certificates are used.
    • If it is true the selfsigned SSL certificates are generated.
  • choices: [false, true]
  • default: false

• www_servername:

  • description:
    • The default name of der www hostname.
  • default: “{{ inventory_hostname }}”

• www_ssl_cert_dest_path:

  • description:
    • The default destination directory for the SSL certificate for the service.
  • default: “{{ ‘%s/ssl/certs/%s’ | format(system_config_directory, www_ssl_cert | basename) }}”

• www_ssl_priv_key_dest_path:

  • description:
    • The default destination directory for the SSL private key for the
  • default: “{{ ‘%s/ssl/private/%s’ | format(system_config_directory, www_ssl_priv_key | basename) }}”

• www_port:

  • description:
    • The standard http-port
  • default: “80”

• www_ssl_port:

  • description:
    • The standard https-port
  • default: “443”

• www_log_files:

  • description:
    • The standard log-file directory
  • default: “/var/log/nginx/”

• www_php_enable

  • description:
    • If this option is true, the PHP FPM will be installed.
  • choices: [false, true]
  • default: true

Processes

main

1. create www group
2. create www user
3. install PHP if www_php_enable is true

configure

1. create and configure www directory
2. configure PHP if www_php_enable is true
3. configure SSL if www_ssl_priv_key and www_ssl_cert or www_ssl_selfsigned are set

License

BSD-3-Clauses

Contributors

• Martin Pietsch (martin.pietsch@tu-dresden.de)
• Reimar Unger (reimar.unger@tu-dresden.de)