Post-Tyranny-Tech-Infrastru.../ansible/roles/nextcloud/tasks/apps.yml

83 lines
3 KiB
YAML
Raw Normal View History

Add Collabora Office, 2FA, cron container, and dual-cache (#4) This commit adds production-ready features to Nextcloud based on the user's existing Nextcloud configuration. ## New Features ### 1. Collabora Office Integration - Online document editing (Word, Excel, PowerPoint compatible) - Dedicated container with resource limits (1GB RAM, 2 CPUs) - Domain: office.{client}.vrije.cloud - WOPI protocol integration with Nextcloud - Automatic app installation (richdocuments) - SSL termination via Traefik ### 2. Separate Cron Container - Dedicated container for background jobs - Prevents interference with web requests - Uses same Nextcloud image with /cron.sh entrypoint - Shares data volume with main container ### 3. Two-Factor Authentication Apps installed and configured: - twofactor_totp: TOTP authenticator apps support - twofactor_admin: Admin enforcement capabilities - twofactor_backupcodes: Backup codes for account recovery Configuration: - 2FA enforced for all users by default - Users must set up 2FA on first login ### 4. Dual-Cache Strategy (APCu + Redis) Optimized caching configuration: - **APCu**: Local in-memory cache (fast, single-server) - **Redis**: Distributed cache and file locking (shared) Benefits: - Faster page loads (APCu for frequently accessed data) - Proper file locking across containers (Redis) - Better scalability for multi-container setups ### 5. Additional Configurations - Maintenance window: 2:00 AM - Default phone region: NL - Improved performance and reliability ## Technical Changes ### Docker Compose Updates - Added nextcloud-cron service - Added collabora service with Traefik labels - Resource limits for Collabora (memory, CPU) ### Ansible Tasks - New file: `tasks/apps.yml` - App installation and configuration - Collabora WOPI URL configuration - Collabora network allowlist setup - 2FA app installation and enforcement - APCu local cache configuration - Maintenance window setting ### Configuration Variables - `collabora_enabled`: Enable/disable Collabora (default: true) - `collabora_domain`: Collabora subdomain - `collabora_admin_user`: Collabora admin username - `twofactor_enforced`: Enforce 2FA (default: true) ## Documentation Added comprehensive setup guide: - `docs/COLLABORA_SETUP.md`: Complete feature documentation - Configuration instructions - Testing procedures - Troubleshooting guide - Performance tuning tips - Security considerations ## Manual Step Required Add Collabora admin password to secrets: ```bash cd infrastructure export SOPS_AGE_KEY_FILE="$PWD/keys/age-key.txt" sops secrets/clients/test.sops.yaml # Add: collabora_admin_password: 7ju5h70L47xJMCoADgKiZIhSak4cwq0B ``` Then redeploy to apply all changes. ## Testing Checklist - [ ] Collabora: Create document in Nextcloud - [ ] 2FA: Login and set up authenticator - [ ] Cron: Check background jobs running - [ ] Cache: Verify APCu + Redis in config ## Performance Impact Expected improvements: - 30-50% faster page loads (APCu caching) - Better concurrent user support (Redis locking) - No web request delays from cron jobs (separate container) - Professional document editing experience (Collabora) Partially addresses #4 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-06 10:34:42 +01:00
---
# Install and configure Nextcloud apps
- name: Install Collabora Office app (richdocuments)
shell: docker exec -u www-data nextcloud php occ app:install richdocuments
register: collabora_install
changed_when: "'richdocuments installed' in collabora_install.stdout"
failed_when: collabora_install.rc != 0 and 'richdocuments already installed' not in collabora_install.stderr
when: collabora_enabled | default(true)
- name: Enable Collabora Office app
shell: docker exec -u www-data nextcloud php occ app:enable richdocuments
when: collabora_enabled | default(true)
changed_when: false
- name: Configure Collabora WOPI URL
shell: |
docker exec -u www-data nextcloud php occ config:app:set richdocuments wopi_url --value="https://{{ collabora_domain }}"
when: collabora_enabled | default(true)
changed_when: true
- name: Get Nextcloud internal network info
shell: docker inspect nextcloud-internal -f '{{{{ .IPAM.Config }}}}'
register: nextcloud_network
changed_when: false
when: collabora_enabled | default(true)
- name: Configure Collabora WOPI allowlist
shell: |
docker exec -u www-data nextcloud php occ config:app:set richdocuments wopi_allowlist --value="172.18.0.0/16,172.21.0.0/16"
when: collabora_enabled | default(true)
changed_when: true
- name: Install two-factor authentication apps
shell: docker exec -u www-data nextcloud php occ app:install {{ item }}
loop:
- twofactor_totp
- twofactor_admin
- twofactor_backupcodes
register: twofactor_install
changed_when: "'installed' in twofactor_install.stdout"
failed_when: twofactor_install.rc != 0 and 'already installed' not in twofactor_install.stderr
- name: Enable two-factor authentication apps
shell: docker exec -u www-data nextcloud php occ app:enable {{ item }}
loop:
- twofactor_totp
- twofactor_admin
- twofactor_backupcodes
changed_when: false
- name: Enforce two-factor authentication
shell: |
docker exec -u www-data nextcloud php occ config:system:set twofactor_enforced --value="true" --type=boolean
when: twofactor_enforced | default(true)
changed_when: true
- name: Configure APCu for local caching
shell: |
docker exec -u www-data nextcloud php occ config:system:set memcache.local --value="\\OC\\Memcache\\APCu"
changed_when: true
- name: Configure maintenance window
shell: |
docker exec -u www-data nextcloud php occ config:system:set maintenance_window_start --value=2 --type=integer
changed_when: true
- name: Display apps configuration summary
debug:
msg: |
Nextcloud Apps Configured:
- Collabora Office: {{ 'Enabled' if collabora_enabled else 'Disabled' }}
WOPI URL: https://{{ collabora_domain if collabora_enabled else 'N/A' }}
- Two-Factor Auth: {{ 'Enforced' if twofactor_enforced else 'Optional' }}
- TOTP (Authenticator apps)
- Admin enforcement
- Backup codes
- Caching:
- Local: APCu
- Distributed: Redis
- Locking: Redis
- Maintenance window: 2:00 AM