Skip to content

Ansible role to install Apache Tomcat Java Servlet Container

License

Notifications You must be signed in to change notification settings

idealista/tomcat_role

Repository files navigation

Logo

Build Status Ansible Galaxy

Tomcat Ansible role

This ansible role installs a Tomcat server in a debian environment.

Getting Started

These instructions will get you a copy of the role for your ansible playbook. Once launched, it will install a Tomcat server in a Debian system. Supported tomcat versions:

  • 7.x
  • 8.x
  • 8.5.x
  • 9.x

Supported OS:

  • Debian:
    • Stretch
    • Buster
  • Ubuntu
    • Focal

Prerequisities

For compatible Ansible versions check .travis.yml. Inventory destination should be a Debian environment.

For testing purposes, Molecule with Docker as driver and Goss as verifier This role needs a system with java previously installed. Its really recommended the use of idealista's java role for that purpose: idealista.java-role

Installing

Create or add to your roles dependency file (e.g requirements.yml) from GitHub:

- src: http://github.com/idealista/tomcat_role.git
  scm: git
  version: 1.0.0
  name: tomcat

or using Ansible Galaxy as origin if you prefer:

- src: idealista.tomcat_role
  version: 1.0.0
  name: tomcat

Install the role with ansible-galaxy command:

ansible-galaxy install -p roles -r requirements.yml -f

Use in a playbook:

- hosts: someserver
  roles:
    - { role: tomcat }

Usage

Look to the defaults properties file to see the possible configuration properties.

Testing

Install dependencies

pipenv sync
pipenv shell

For more information read the pipenv docs.

Running test

molecule test

See molecule/molecule.yml to check possible testing platforms.

Works With

Ansible Molecule Goss

Versioning

For the versions available, see the tags on this repository.

Additionaly you can see what change in each version in the CHANGELOG.md file.

Authors

See also the list of contributors who participated in this project.

License

Apache 2.0 License

This project is licensed under the Apache 2.0 license - see the LICENSE file for details.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.