Présentation

AVERTISSEMENT

Dans les versions 3.5.38 et 3.5.39, le Wrapper peut planter lorsque l'une des propriétés ci-dessous est définie avec un groupe qui n'est pas autorisé pour l'utilisateur sous lequel le Wrapper s'exécute. Veuillez toujours vous assurer que l'utilisateur exécutant le Wrapper est membre du groupe que vous souhaitez définir.

wrapper.group

Compatibilité :3.5.38
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :Windows (Non pris en charge)Mac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Cette propriété permet de modifier automatiquement le groupe de certains fichiers que le Wrapper crée, produisant le même résultat que la commande 'chown' utilisée dans un terminal sur un système UNIX. Le groupe spécifié sera utilisé comme valeur par défaut pour toutes les propriétés listées ci-dessous.

Une valeur valide est le nom ou l'ID d'un groupe existant sur le système où le Wrapper est utilisé. Le Wrapper doit cependant s'exécuter soit avec l'utilisateur root, soit avec un utilisateur appartenant au groupe cible, sinon une erreur de permission refusée sera signalée lors de la tentative de modification du groupe.

La valeur par défaut est '-UNCHANGED-', ce qui signifie que le Wrapper ne modifiera pas le groupe, et la responsabilité de son attribution sera laissée au système d'exploitation. Habituellement, le groupe principal de l'utilisateur propriétaire du processus Wrapper est utilisé, ou le groupe du répertoire parent si le bit Setgid est défini sur le répertoire parent. Notez que des tirets ('-') ont volontairement été inclus dans la valeur par défaut afin d'éviter tout conflit, car ils en font un nom de groupe illégal.

Exemple :
wrapper.group=jenkins

NOTE

Vous pouvez également contrôler les permissions du groupe en utilisant les propriétés wrapper.*.umask.

wrapper.*.group

Compatibilité :3.5.38
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :Windows (Non pris en charge)Mac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Il est également possible de spécifier le groupe pour des fichiers particuliers créés par le Wrapper en utilisant les propriétés suivantes. Chacune a pour valeur par défaut celle de la propriété wrapper.group.

wrapper.group.strict

Compatibilité :3.5.38
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :Windows (Non pris en charge)Mac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Au démarrage du Wrapper, plusieurs vérifications sont effectuées pour s'assurer que les propriétés wrapper.*.group sont définies avec un nom ou un ID de groupe existant, et que le Wrapper s'exécute soit en tant qu'utilisateur root, soit en tant qu'utilisateur appartenant aux groupes configurés. Bien que cela soit nécessaire pour que la valeur soit valide, cela ne garantit pas complètement que le groupe puisse être attribué avec succès à l'exécution. Il existe un certain nombre de raisons pour lesquelles le Wrapper peut échouer à attribuer un groupe à un fichier pendant l'exécution. Il est en effet possible que la liste des groupes ou l'appartenance des utilisateurs à un groupe changent pendant que le Wrapper s'exécute.

Si wrapper.group.strict est défini à TRUE, le Wrapper s'arrêtera avec une erreur FATAL chaque fois qu'un groupe invalide est détecté lors du chargement de la configuration. Cette propriété n'entraînera cependant pas l'arrêt du Wrapper s'il échoue ultérieurement à attribuer le groupe pendant l'exécution. À la place, une erreur sera signalée et le groupe restera simplement inchangé.

Si wrapper.group.strict est défini à FALSE, tout groupe invalide sera résolu à la valeur de wrapper.group, ou à défaut, à '-UNCHANGED-'.

La valeur par défaut est FALSE.

Exemple :
wrapper.group.strict=TRUE

Référence : fichier journal