Rola Ansible dla Tomcat

Rola Ansible do instalacji, konfiguracji i aktualizacji Apache Tomcat na systemach Linux. Ta rola śledzi wersje oznaczone w repozytorium GitHub Tomcat i pobiera Tomcat z luster Fundacji Apache. Jeśli szukasz roli Ansible, która aktualizuje Tomcat przy każdym uruchomieniu, to jest to rola dla Ciebie.

Wymagania

Wymaga co najmniej Java 8. Poniżej znajdują się dwie opcje, które są dostępne:

1. geerlingguy.java
2. ansiblebit.oracle-java

Instalacja

Aby zainstalować bezpośrednio z GitHub:

- name: tomcat
  src: http://github.com/vantaworks/tomcat.git
  scm: git
  version: master

Lub, jeśli chcesz zainstalować z Ansible Galaxy:

- name: tomcat
  src: vantaworks.tomcat
  version: master

Następnie uruchom następujące polecenie, aby zainstalować:

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

Dalsze informacje na temat zmiennych oraz przykładowych playbooków są pokazane poniżej.

Zmiennych roli

Dostępne zmienne są wyszczególnione poniżej, wraz z wartościami domyślnymi (patrz defaults/main.yml):

Główna wersja do użycia podczas instalacji Tomcat:

tomcat_major_version: 8

Specyficzna wersja mniejsza Tomcat do zablokowania. (Zalecenie: pozostawić niezdefiniowaną, aby rola pobrała najnowszą wersję określonej głównej wersji).

tomcat_minor_version: 8.5.57
# domyślnie jest niezdefiniowana

Z którego lustra Fundacji Apache pobrać Tomcat:

tomcat_mirror: "http://apache.mirrors.hoobly.com"

Określ parametry konta serwisowego Tomcat, w tym GID/UID (opcjonalne):

tomcat_user: tomcat
tomcat_group: tomcat

tomcat_user_uid: ""
tomcat_group_gid: ""
# domyślnie jest niezdefiniowana

Nazwa usługi systemowej:

tomcat_service_name: "tomcat"

Czy włączyć usługę Tomcat:

tomcat_service_enabled: True

Procenty przydziału pamięci JVM:

tomcat_jvm_percentage_xms: 15
tomcat_jvm_percentage_xmx: 55

Czy włączyć tryb debugowania JMX dla Tomcat:

tomcat_debug_mode: False

Zależności

Brak zależności Ansible-Python. Zobacz Wymagania powyżej dla wymagań dotyczących roli.

Przykłady playbooków

# Instalacja i utrzymanie Tomcat 8 (aktualnie 8.5)
- name: Przykład instalacji Play 1 - Produkcja
  hosts: tomcat
  vars:
    tomcat_major_version: 8
  roles:
    - vantaworks.tomcat

- name: Przykład instalacji Play 2 - Rozwój
  hosts: tomcat_dev
  vars:
    tomcat_major_version: 9
    tomcat_permissions_production: False
    tomcat_users:
      - username: "tomcat"
        password: "lamepassword"
        roles: "tomcat,admin,manager,manager-gui"
      - username: "developer"
        password: "worsepw"
        roles: "tomcat,admin,manager,manager-gui"
  roles:
    - vantaworks.tomcat

- name: Przykład deinstalacji Play
  hosts: tomcat
  vars:
    tomcat_state: "absent"
    tomcat_uninstall_create_backup: True
    tomcat_uninstall_remove_user: True
    tomcat_uninstall_remove_group: True
    tomcat_uninstall_remove_all: True
  roles:
    - vantaworks.tomcat

Licencja

BSD