概要

警告

バージョン 3.5.38 および 3.5.39 では、下記のプロパティのいずれかを、Wrapper の実行ユーザーに許可されていないグループに設定すると、Wrapper がクラッシュする場合があります。 Wrapper を実行するユーザーが、設定したいグループのメンバーであることを常に確認してください。

wrapper.group

対応バージョン :3.5.38
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :Windows (未対応)Mac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

このプロパティを使用すると、Wrapper が作成する特定のファイルのグループを自動的に変更できます。 UNIX システムのターミナルで使用する 'chown' コマンドと同じ結果になります。 指定したグループは、下記のすべてのプロパティのデフォルト値として使用されます。

有効な値は、Wrapper を使用するシステム上に存在するグループの名前または ID です。 ただし、Wrapper は root ユーザー、または対象グループに属するユーザーで実行する必要があります。 そうでない場合、グループの変更を試みると permission denied エラーが報告されます。

デフォルト値は '-UNCHANGED-' です。これは、Wrapper がグループを変更せず、その割り当ては OS に任されることを意味します。通常は、Wrapper プロセスを所有するユーザーのプライマリグループが使用されます。親ディレクトリに Setgid ビットが設定されている場合は、親ディレクトリのグループが使用されます。ハイフン('-')は不正なグループ名となるため競合を避ける目的で、意図的にデフォルト値に含まれています。

例:
wrapper.group=jenkins

注意

グループのパーミッションは、wrapper.*.umask プロパティを使用して制御することもできます。

wrapper.*.group

対応バージョン :3.5.38
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :Windows (未対応)Mac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

次のプロパティを使用して、Wrapper が作成する特定のファイルのグループを指定することもできます。 各プロパティのデフォルト値は wrapper.group プロパティの値です。

wrapper.group.strict

対応バージョン :3.5.38
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :Windows (未対応)Mac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Wrapper の起動時に、wrapper.*.group プロパティが既存のグループ名または ID で設定されていること、および Wrapper が root ユーザーとして、または設定されたグループに属するユーザーとして実行されていることを確認するためのいくつかのチェックが行われます。 値が有効であるためにはこれが必要ですが、実行時にグループを正常に割り当てられることを完全に保証するものではありません。 実行中に Wrapper がファイルへグループを割り当てられない理由はいくつかあります。 実際、Wrapper の実行中にグループリストやユーザーのグループ所属が変更される可能性があります。

wrapper.group.strict を TRUE に設定すると、設定の読み込み中に無効なグループが検出された場合、Wrapper は FATAL エラーで停止します。 ただし、このプロパティは、後で実行中にグループの割り当てに失敗しても Wrapper を停止させることはありません。 代わりにエラーが報告され、グループは変更されません。

wrapper.group.strict を FALSE に設定すると、無効なグループはすべて wrapper.group の値に解決され、それが失敗した場合は '-UNCHANGED-' に解決されます。

デフォルト値は FALSE です。

例:
wrapper.group.strict=TRUE

参照: ログファイル