kevinveenbirkenbach/computer-playbook
1
0
Fork 0
mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-08-27 05:55:15 +02:00
Code Issues Packages Projects Releases Wiki Activity
computer-playbook/roles/web-svc-collabora
History
Kevin Veen-Birkenbach 594d9417d1
handlers(docker): add once-per-directory docker compose pull with lockfile 
- Introduced a new handler 'docker compose pull' that runs only once per
  {{ docker_compose.directories.instance }} directory by using a lock
  file under /run/ansible/compose-pull.
- Ensures idempotency by marking the task as changed only when a pull
  was actually executed.
- Restricted execution with 'when: MODE_UPDATE | bool'.
- Improves update workflow by avoiding redundant docker pulls during
  the same Ansible run.

Reference: ChatGPT discussion
https://chatgpt.com/share/68a55151-959c-800f-8b70-160ffe43e776
2025-08-20 06:42:49 +02:00
..
config
handlers(docker): add once-per-directory docker compose pull with lockfile
2025-08-20 06:42:49 +02:00
meta
Optimized collabora draft
2025-08-20 01:00:20 +02:00
tasks
Optimized collabora draft
2025-08-20 01:00:20 +02:00
templates
Deactivated redis, moved version to correct place for web-svc-collabora
2025-08-20 03:40:37 +02:00
vars
Optimized collabora draft
2025-08-20 01:00:20 +02:00
README.md
Optimized collabora draft
2025-08-20 01:00:20 +02:00

README.md

Docker Collabora (DRAFT)

Description

This Ansible role deploys Collabora Online (CODE) in Docker to enable real-time, in-browser document editing for Nextcloud. It automates the setup of the Collabora CODE container, Nginx reverse proxy configuration, network isolation via Docker networks, and environment variable management.

Overview

  • Dockerized Collabora CODE: Uses the official collabora/code image.
  • Nginx Reverse Proxy: Configures a public-facing proxy with TLS termination and WebSocket support for /cool/ paths.
  • Docker Network Management: Creates an isolated /28 subnet for Collabora and connects containers securely.
  • Environment Configuration: Generates a .env file with domain, credentials, and extra parameters for Collabora's WOPI server.

Features

  • Automatic creation of a dedicated Docker network for Collabora.
  • Proxy configuration template for Nginx with long timeouts and WebSocket upgrades.
  • Customizable domain names and ports via Ansible variables.
  • Support for SSL termination at the proxy level.
  • Integration hooks to restart Nginx and recreate Docker Compose stacks on changes.

Documentation

See the role’s README.md, task files, and Jinja2 templates in the roles/web-svc-collabora directory for usage examples and variable definitions.

Further Resources