Role Name

This role helps install or update Atlassian Confluence.

Requirements

To run Atlassian Confluence, you need a few additional things:

• Java
• Database
• Initialization script

Java installation is not included in this playbook. You need to install it separately. You can use your own Java roles or my role hudecof.java.

You might prefer a different database than the one I suggest. That’s fine; it’s also not covered here.

The tar.gz version does not come with a startup script. I use supervisord for that. I will create templates for supervisord, init.d, and systemd and place them in the installation directory.

If you are updating, please manually shut down your old instance first. This role does not handle that! It only sets up your new instance with your custom settings.

Role Variables

• atlassian_confluence_version: The version you want to install. This is the only variable you must change; the others are optional.

• atlassian_confluence_baseurl: The URL for downloading tar.gz files. Change it if you have your own mirror.

• atlassian_confluence_basedir: The path where the tar.gz file will be downloaded and extracted, defaulting to /opt/atlassian.

• atlassian_confluence_home: This is the confluence.home, which is your data directory.

• atlassian_confluence_user, atlassian_confluence_uid, atlassian_confluence_group, atlassian_confluence_gid: These variables set up a dedicated user to run the instance.

• atlassian_confluence_server_xml: A list of changes to server.xml. It uses XPath to edit/add/remove existing properties.

Example of atlassian_confluence_server_xml:

atlassian_confluence_server_xml:
- xpath: /Server/Service/Connector
  ensure: present
  attribute: proxyPort
  value: 443
- xpath: /Server/Service/Connector
  ensure: present
  attribute: scheme
  value: https

• atlassian_confluence_catalina_opts: A list of custom CATALINA_OPTS properties. Currently, you cannot change existing ones.

For details on CrowdSSO, see CrowdSSO.md.

Dependencies

This role requires the cmprescott.xml role/library.

Example Playbook

- hosts: atlassian
  roles:
    - cmprescott.xml
    - hudecof.atlassian-confluence

License

BSD

Author Information

Peter Hudec