Plugin Avatar Jenkins

De EjnTricks
Révision de 12 avril 2017 à 23:26 par Etienne (discussion | contributions)

(diff) ← Version précédente | Voir la version courante (diff) | Version suivante → (diff)

Afin de personnaliser l'interface de Jenkins, le plugin Avatar permet d'associer une image aux utilisateurs. Cependant, ce plugin est très minimaliste et n'apporte pas grand chose. L'avatar n'est visible qu'en visualisant les détails d'un utilisateur déclaré, contrairement au plugin Gravatar qui affiche l'avatar dans la liste des utilisateurs.

Hand-icon.png Votre avis

Nobody voted on this yet

 You need to enable JavaScript to vote


Icon-Configuration-Settings.png Ajout avatar

L'ajout de l'avatar s'effectue en modifiant les informations des utilisateurs déclarés. La liste des utilisateurs est accessible depuis le menu Utilisateurs sur la gauche de l'interface. La liste des utilisateurs déclarés est alors présentée.


Il faut cliquer sur l'utilisateur à modifier, présentant ainsi ses informations.


Sur cette fenêtre, il faut cliquer sur le menu Configurer afin d'afficher les propriétés en modification. La nouvelle section Avatar est disponible avec le bouton Choisissez un fichier pour sélectionner l'image de l'avatar, et Upload pour téléverser cette image.


Après sélection du fichier, le nom de celui-ci est présenté juste avant le bouton Upload.


Après téléversement, une miniature de l'image est présentée, confirmant le succès de cette étape.


Viewer icon.png Rendu

Lorsqu'un avatar est associé à un utilisateur, cette image est visible sur la page d'informations des utilisateurs.


Comme évoqué dans l'introduction, cela n'a pas un grand intérêt car le but premier de Jenkins n'est pas une gestion d'utilisateur et peu de personne va aller visualiser ces informations.


Or le manque a été comblé depuis la version 1.1 du plugin, qui reprend l'avatar dans la liste des utilisateurs par exemple.


Delete-file-icon.png Suppression avatar

La suppression de l'avatar associé à l'utilisateur est très simple. Il faut éditer les informations de celui-ci et cliquer sur le bouton Upload, dans la section Avatar, sans avoir sélectionné de fichier.


Process-icon.png Emplacement du fichier

Pour les plus curieux, la question sur l'emplacement du fichier uploadé peut se poser. En fait, ce fichier n'est pas déposé directement sur le filesystem du serveur, mais dans un fichier XML décrivant l'utilisateur. Ce fichier se trouve dans le répertoire d'extension de Jenkins, à savoir /usr/share/tomcat6/.jenkins/ dans le cadre de cette étude sous Ubuntu. Dans le cas étudier, utilisateur etienne, il existe le fichier /usr/share/tomcat6/.jenkins/users/etienne/config.xml. Celui-ci contient une balise imageBytes, fille de net.hurstfrost.jenkins.avatar.user.AvatarProperty, contenant le binaire de l'image.

<?xml version='1.0' encoding='UTF-8'?>
<user>
  <fullName>etienne</fullName>
  <description></description>
  <properties>
    <jenkins.security.ApiTokenProperty>
      <apiToken>A8WyKs3YSwh2gqhNMrgbOI49ntP8dYH+wHB7Gg3gpP9JyZy6rWW1JRtWDc/HYUnA</apiToken>
    </jenkins.security.ApiTokenProperty>
    <net.hurstfrost.jenkins.avatar.user.AvatarProperty>
      <imageBytes>iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAYAAAB/HSuDAACAAElEQVR42uy9B7hdZbW9bzohhBaq
9N5FRVREEbGi4rUXsDcUBctVgateRbCXq16viIBSpCYnCTUh5SQkIYEEUggkFEGK9BICaafmN8b5
j+/8v+ychBBAEN73eeaz1l579bVOsuf85hzzJS8BAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
.
.
.
AAAAAABeHv4f9Q79YiOqIgUAAAAASUVORK5CYII=</imageBytes>
    </net.hurstfrost.jenkins.avatar.user.AvatarProperty>
    <hudson.tasks.Mailer_-UserProperty>
      <emailAddress>ejouvin@amexio.fr</emailAddress>
    </hudson.tasks.Mailer_-UserProperty>
    <hudson.model.MyViewsProperty>
      <primaryViewName></primaryViewName>
      <views>
        <hudson.model.AllView>
          <owner class="hudson.model.MyViewsProperty" reference="../../.."/>
          <name>Tous</name>
          <filterExecutors>false</filterExecutors>
          <filterQueue>false</filterQueue>
          <properties class="hudson.model.View$PropertyList"/>
        </hudson.model.AllView>
      </views>
    </hudson.model.MyViewsProperty>
    <org.jenkinsci.main.modules.cli.auth.ssh.UserPropertyImpl>
      <authorizedKeys></authorizedKeys>
    </org.jenkinsci.main.modules.cli.auth.ssh.UserPropertyImpl>
    <hudson.search.UserSearchProperty>
      <insensitiveSearch>false</insensitiveSearch>
    </hudson.search.UserSearchProperty>
  </properties>
</user>


Viewer icon.png Voir aussi

Documentation officielle: https://plugins.jenkins.io/avatar