1
0
Fork 0
mash-ansible-role-nextcloud/templates/preview-generator
Gergely Horváth a877b16c03
Preview generator setup (#7)
* Preview generator setup

Enable the variable nextcloud_preview_enabled and you are good to go.

Some important aspects of usage:
- the preview generator has two stages [according to their readme](https://github.com/nextcloud/previewgenerator)
  - a generate-all phase, which has to be executed only a single time
  - a pre-generate phase, that should be run in a cronjob.
    That runs quite fast if the generate-all phase finishd.
We do not want to run the generate-all phase multiple times, so its execution has to be followed somehow.
This is done by creating a file on the host side and both the task that executes generate-all
and both the cronjob checks its existance.

Multiple vaiables are also defined and the corresponding default values are also set.
These values are based on the [upstream readme](https://github.com/nextcloud/previewgenerator) and also on experience.
Feel free to change anything.

Once installed, the playbook needs to be called with the adjust-nextcloud-config tag.
This tag sets up the variables and calls the generate-all script, that will also create the file---signalling
its finished state---on the host.
*** As this may take a long time, be sure to only call it when you have time to leave it running!!! ***
The playbook calls generate-all asynchronously, but it will timeout after about 27h.
On 60GBs, most if images, it took about 10 minutes to finish.
If it takes more time, you may want to start it from the host by calling
```sh
/usr/bin/env docker exec mash-nextcloud-server php /var/www/html/occ preview:generate-all
```

If the nextcloud_preview_enabled value is set back to false, the host side files are cleaned up
and also the cron job is changed, not to call prevew generation again however, the database and generated
previews are kept intact.

* fix playbook format suggestions by Slavi (see conversation in !7)
2023-09-16 10:01:20 +03:00
..
preview-generator-cron.sh.j2 Preview generator setup (#7) 2023-09-16 10:01:20 +03:00