Ansible Role: collabora-code

| This role installs and configures Collabora Online Development Edition.

Collabora Online Development Edition (CODE) is a nice tool to have LibreOffice as a web service.

Motivation

Integrates well with Nextcloud ;)

Installation

Install from Ansible Galaxy

ansible-galaxy install while_true_do.collabora_code

Install from Github

git clone https://github.com/while-true-do/ansible-role-collabora-code.git while_true_do.collabora_code

Requirements

Used Modules:

• command_module
• file_module
• include_tasks_module
• package_module
• service_module
• set_fact_module
• template_module

Dependencies

This role has the below dependencies:

• https://galaxy.ansible.com/while_true_do/nginx
• https://galaxy.ansible.com/while_true_do/repo_collabora_code

You can install them with:

ansible-galaxy install -r requirements.yml

Role Variables

# defaults/main.yml for collabora_code

# state can be set to "present" / "absent"
wtd_collabora_code_state: "present"

wtd_collabora_code_packages:
  - loolwsd
  - CODE-brand

wtd_collabora_code_dont_gen_ssl_cert: false
wtd_collabora_code_cert_domain: ""

wtd_collabora_code_domains: "localhost" # example "cloud\\.example\\.com\\|nextcloud\\.example\\.org"
wtd_collabora_code_server_name: ""
wtd_collabora_code_dictionaries: "de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru"

# admin console settings
wtd_collabora_code_admin_console_enabled: true
wtd_collabora_code_admin_console_enable_pam: false
wtd_collabora_code_admin_console_user_name: ""
# wtd_collabora_code_admin_console_secure_password: ""

# webserver settings
wtd_collabora_code_webserver: "nginx"

wtd_collabora_code_webserver_nginx_vhost_file_name: "collabora-code.conf"

wtd_collabora_code_webserver_nginx_ssl_protocols: "TLSv1 TLSv1.1 TLSv1.2"
wtd_collabora_code_webserver_nginx_ssl_ciphers: "EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH"
wtd_collabora_code_webserver_nginx_ssl_prefer_server_ciphers: "on"

wtd_collabora_code_webserver_nginx_ssl_certificate: "/etc/nginx/ssl/cloud.example.com.crt"
wtd_collabora_code_webserver_nginx_ssl_certificate_key: "/etc/nginx/ssl/cloud.example.com.key"

Example Playbook

Simple Example:

- hosts: servers
  roles:
    - { role: while_true_do.collabora_code }

Advanced Example:

- hosts: servers
  roles:
    - { role: while_true_do.collabora_code, wtd_collabora_code_webserver_nginx_ssl_certificate: "/etc/nginx/ssl/other.crt", wtd_collabora_code_webserver_nginx_ssl_certificate_key: "/etc/nginx/ssl/other.key" }

Testing

All tests are located in test directory.

Basic testing:

bash ./tests/test-ansible.sh
bash ./tests/test-spelling.sh
bash ./tests/test-whitespace.sh

Contribute / Bugs

Thank you so much for considering to contribute. Every contribution helps us. We are really happy, when somebody is joining the hard work. Please have a look at the links first.

• Code of Conduct
• Contribution Guidelines
• Create an issue or Request
• See who was contributing already

License

This work is licensed under a BSD License.

Author Information

Site: while-true-do.org

Mail: hello@while-true-do.org