トムキャット Ansible ロール

Linux上でApacheのTomcatをインストール、設定、更新するためのAnsibleロールです。このロールは、TomcatのGitHubリポジトリでタグ付けされているバージョンを追跡し、ApacheファウンデーションのミラーからTomcatをダウンロードします。毎回Tomcatを更新するAnsibleロールを探しているなら、これがあなたにぴったりです。

要件

Java 8以上が必要です。以下の2つの選択肢があります：

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

インストール

GitHubから直接インストールするには：

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

または、Ansible Galaxyからインストールしたい場合：

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

次に、以下のコマンドを実行してインストールします。

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

変数や例のプレイブックに関する詳細情報は以下に示されています。

ロール変数

使用可能な変数は以下に示されています。デフォルト値も含まれています（defaults/main.ymlを参照）：

トムキャットインストール時に使用するメジャーバージョン。

tomcat_major_version: 8

特定のトムキャットマイナーバージョンを固定するための変数。（推奨：未設定のままにしておくと、指定されたメジャーバージョンの最新リビジョンをダウンロードします）

tomcat_minor_version: 8.5.57
# デフォルトは未設定

どのApacheファウンデーションのミラーからTomcatをダウンロードするか。

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

トムキャットのサービスアカウントのパラメータを指定します。GID/UID（オプション）。

tomcat_user: tomcat
tomcat_group: tomcat

tomcat_user_uid: ""
tomcat_group_gid: ""
# デフォルトは未設定

システムサービスの名前。

tomcat_service_name: "tomcat"

トムキャットサービスを有効にするかどうか。

tomcat_service_enabled: True

JVMのメモリ割り当てのパーセンテージ。

tomcat_jvm_percentage_xms: 15
tomcat_jvm_percentage_xmx: 55

トムキャットのJMXデバッグを有効にするかどうか。

tomcat_debug_mode: False

依存関係

Ansible-Pythonの依存関係はありません。ロールの要件については上記の要件を参照してください。

例のプレイブック

# Tomcat 8（現在は8.5）をインストールして維持する
- name: 例のインストールプレイ 1 - 本番環境
  hosts: tomcat
  vars:
    tomcat_major_version: 8
  roles:
    - vantaworks.tomcat

- name: 例のインストールプレイ 2 - 開発環境
  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: 例のアンインストールプレイ
  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

ライセンス

BSD