tomcat-role

=================

This is an Ansible role for installing a customizable version of Apache Tomcat, which keeps the CATALINA_BASE directory separate from CATALINA_HOME as per best practices.

With this role, you can provide your application's WAR file and other configurations when starting Tomcat. This role is designed to work inside a Docker container.

Here are the options you have:

• Any WAR files placed in tomcat_system_home/distributions will be copied to tomcat_catalina_base. In a container, you can get these by:
  • Mounting tomcat_system_home/distributions to a suitable directory on the host machine (where the WAR files are stored);
  • Providing a URL to a single WAR file using the WEBAPP_DISTRO_URL environment variable;
• Any scripts found in tomcat_catalina_base/environment will run before Tomcat starts (via setenv.sh).

Requirements

No specific requirements.

Role Variables

• tomcat_download_mirror: The site from where to download Tomcat.
• tomcat_majorversion: The major version of Tomcat, like 8.x.x (default is "8").
• tomcat_minorversion: The minor version of Tomcat, like x.0.x (default is "0").
• tomcat_patchversion: The patch version of Tomcat, like x.x.30 (default is "30").
• tomcat_download_path: The location on the server where Tomcat will be downloaded (default is "/tmp").
• tomcat_remove_archive: If set to "true", the Tomcat download archive will be deleted after extraction (default is "true").
• tomcat_system_user: The system user who will run Tomcat (default is "cms").
• tomcat_system_group: The group for the system user who will run Tomcat (default is "cms").
• tomcat_system_home: The home directory of the system user running Tomcat (default is "/opt/{{ tomcat_system_user }}").
• tomcat_catalina_home: The directory where Tomcat will be extracted (default is "/usr/local/tomcat").
• tomcat_catalina_base: The directory for custom Tomcat configurations (default is "{{ tomcat_system_home }}/tomcat").

Dependencies

Note that Oracle JDK 8 needs to be installed before using this role. You can use the williamyeh.oracle-java role for that.

Example Playbook

For an example of how to use this role, check out hippo-tomcat-template.

License

MIT

Author Information

Daniel Rhoades (https://github.com/daniel-rhoades)