https://github.com/idealista/tomcat_role
Ansible role to install Apache Tomcat Java Servlet Container
https://github.com/idealista/tomcat_role
ansible ansible-role apache-tomcat debian java tomcat
Last synced: 3 months ago
JSON representation
Ansible role to install Apache Tomcat Java Servlet Container
- Host: GitHub
- URL: https://github.com/idealista/tomcat_role
- Owner: idealista
- License: apache-2.0
- Created: 2017-07-03T16:10:10.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-11-21T11:03:37.000Z (over 1 year ago)
- Last Synced: 2026-01-13T21:52:45.662Z (5 months ago)
- Topics: ansible, ansible-role, apache-tomcat, debian, java, tomcat
- Language: Jinja
- Homepage:
- Size: 312 KB
- Stars: 13
- Watchers: 24
- Forks: 32
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://travis-ci.org/idealista/tomcat_role)
[](https://galaxy.ansible.com/idealista/tomcat_role)
# Tomcat Ansible role
This ansible role installs a Tomcat server in a debian environment.
- [Getting Started](#getting-started)
- [Prerequisities](#prerequisities)
- [Installing](#installing)
- [Usage](#usage)
- [Testing](#testing)
- [Built With](#built-with)
- [Versioning](#versioning)
- [Authors](#authors)
- [License](#license)
- [Contributing](#contributing)
## Getting Started
These instructions will get you a copy of the role for your ansible playbook. Once launched, it will install a [Tomcat](https://tomcat.apache.org/) 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](.travis.yml).
Inventory destination should be a Debian environment.
For testing purposes, [Molecule](https://molecule.readthedocs.io/) with Docker as driver and [Goss](http://goss.rocks) 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](https://github.com/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](https://galaxy.ansible.com/idealista/tomcat_role/) 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
```sh
pipenv sync
pipenv shell
```
For more information read the [pipenv docs](https://docs.pipenv.org/).
### Running test
```
molecule test
```
See molecule/molecule.yml to check possible testing platforms.
## Works With
## Versioning
For the versions available, see the [tags on this repository](https://github.com/idealista/tomcat_role/tags).
Additionaly you can see what change in each version in the [CHANGELOG.md](CHANGELOG.md) file.
## Authors
* **Idealista** - *Work with* - [idealista](https://github.com/idealista)
See also the list of [contributors](https://github.com/idealista/tomcat_role/contributors) who participated in this project.
## License
This project is licensed under the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) license - see the [LICENSE](LICENSE) file for details.
## Contributing
Please read [CONTRIBUTING.md](.github/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.