blob: 492b270a9f4d6b5061b86136052b810ac3a15e89 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
Tiny Tiny RSS
=============
Description
-----------
The `ttrss` role installs and configures the [Tiny Tiny RSS](https://tt-rss.org/)
feed aggregator.
The [ttrss-auth-ldap](https://github.com/sacredheartsc/ttrss-freeipa) is used to
authenticate users against the local FreeIPA domain.
This role configures the PHP application only; it does not configure the webserver.
Variables
---------
This role **accepts** the following variables:
Variable | Default | Description
-------------------------------|------------------------------------|------------
`ttrss_version` | `HEAD` | Git version of TT-RSS to install
`ttrss_freeipa_plugin_version` | `HEAD` | Git version of FreeIPA plugin to install
`ttrss_update_on_calendar` | `weekly` | Systemd [calendar interval](https://www.freedesktop.org/software/systemd/man/systemd.time.html#Calendar%20Events) for updating TT-RSS
`ttrss_server_name` | `{{ ansible_fqdn }}` | Canonical HTTP hostname
`ttrss_db_host` | `{{ postgresql_host }}` | PostgreSQL host
`ttrss_user` | `s-ttrss` | PostgreSQL user (will be created)
`ttrss_db_name` | `ttrss` | PostgreSQL database (will be created)
`ttrss_session_lifetime_sec` | 604800 | Login session lifetime (seconds)
`ttrss_email_from_name` | `Tiny Tiny RSS` | Email `From:` name
`ttrss_email_from_address` | `ttrss-noreply@{{ email_domain }}` | Email `From:` address
`ttrss_access_group` | `role-ttrss-access` | FreeIPA group for TT-RSS users (will be created)
`ttrss_admin_group` | `role-ttrss-admin` | FreeIPA group for TT-RSS administrators (will be created)
### Exports
This role **exports** the following variables:
Variable | Description
------------------------|------------
`ttrss_php_environment` | Dictionary of required environment variables for PHP
`ttrss_apache_config` | Apache config block for TT-RSS
`ttrss_home` | TT-RSS webroot
Usage
-----
Example playbook:
````yaml
- name: configure tinytinyrss web application
hosts: ttrss_servers
roles:
- role: ttrss
vars:
ttrss_server_name: ttrss.ipa.example.com
ttrss_db_host: postgres.ipa.example.com
ttrss_access_group: ttrss-users
ttrss_admin_group: ttrss-admins
- role: php
vars:
php_fpm_environment: '{{ ttrss_php_environment }}'
- role: apache_vhost
vars:
apache_default_vhost: yes
apache_canonical_hostname: '{{ ttrss_server_name }}'
apache_document_root: '{{ ttrss_home }}'
apache_config: '{{ ttrss_apache_config }}'
````
|