Use Libravatar service with GitLab

GitLab by default supports功能avatar service. Libravatar is a service which delivers your avatar (profile picture) to other websites and their API isheavily based on gravatar.

This means that it is not complicated to switch to Libravatar avatar service or even self hosted Libravatar server.

配置

Ingitlab.yml gravatar sectionset the configuration options as follows:

For HTTP

gravatar:enabled:true# gravatar URLs: possible placeholders: %{hash} %{size} %{email} %{username}plain_url:"http://cdn.libravatar.org/avatar/%{hash}?s=%{size}&d=identicon"

For HTTPS

gravatar:enabled:true# gravatar URLs: possible placeholders: %{hash} %{size} %{email} %{username}ssl_url:"https://seccdn.libravatar.org/avatar/%{hash}?s=%{size}&d=identicon"

Self-hosted

If you arerunning your own libravatar servicethe URL will be different in the configuration but the important part is to provide the same placeholders so GitLab can parse the URL correctly.

For example, you host a service onhttp://libravatar.example.comtheplain_urlyou need to supply ingitlab.ymlis

http://libravatar.example.com/avatar/%{hash}?s=%{size}&d=identicon

Omnibus-gitlab例子

In/etc/gitlab/gitlab.rb:

For http

gitlab_rails['gravatar_enabled']=truegitlab_rails['gravatar_plain_url']="http://cdn.libravatar.org/avatar/%{hash}?s=%{size}&d=identicon"

For https

gitlab_rails['gravatar_enabled']=truegitlab_rails['gravatar_ssl_url']="https://seccdn.libravatar.org/avatar/%{hash}?s=%{size}&d=identicon"

Runsudo gitlab-ctl reconfigurefor changes to take effect.

Default URL for missing images

Libravatar supports different setsof小姐ing imagesfor emails not found on the Libravatar service.

In order to use a different set other thanidenticon, replace&d=identiconportion of the URL with another supported set. For example, you can useretroset in which case the URL would look like:plain_url: "http://cdn.libravatar.org/avatar/%{hash}?s=%{size}&d=retro"

Usage examples

For Microsoft Office 365

If your users are Office 365-users, the "GetPersonaPhoto" service can be used. Note that this service requires login, so this use case is most useful in a corporate installation, where all users have access to Office 365.

gitlab_rails['gravatar_plain_url']='http://outlook.office365.com/owa/service.svc/s/GetPersonaPhoto?email=%{email}&size=HR120x120'gitlab_rails['gravatar_ssl_url']='https://outlook.office365.com/owa/service.svc/s/GetPersonaPhoto?email=%{email}&size=HR120x120'