GitLabでLibravatarサービスを使用する

プラン: Free、Premium、Ultimate
提供形態: GitLab Self-Managed

GitLabはGravatarアバターサービスをデフォルトでサポートしています。

Libravatarは、アバター（プロフィール画像）を他のウェブサイトに配信する別のサービスです。Libravatar APIはGravatarに大きく基づいているため、Libravatarアバターサービス、または独自のLibravatarサーバーに切り替えることができます。

Libravatarサービスを独自のサービスに変更する

gitlab.yml Gravatarセクションで、設定オプションを次のように設定します:

Linuxパッケージインストールの場合:

/etc/gitlab/gitlab.rbを編集します:

gitlab_rails['gravatar_enabled'] = true
#### For HTTPS
gitlab_rails['gravatar_ssl_url'] = "https://seccdn.libravatar.org/avatar/%{hash}?s=%{size}&d=identicon"
#### Use this line instead for HTTP
# gitlab_rails['gravatar_plain_url'] = "http://cdn.libravatar.org/avatar/%{hash}?s=%{size}&d=identicon"

変更を適用するには、sudo gitlab-ctl reconfigureを実行します。

自己コンパイルによるインストールの場合:

config/gitlab.ymlを編集します:

  gravatar:
    enabled: true
    # default: https://www.gravatar.com/avatar/%{hash}?s=%{size}&d=identicon
    plain_url: "http://cdn.libravatar.org/avatar/%{hash}?s=%{size}&d=identicon"
    # default: https://secure.gravatar.com/avatar/%{hash}?s=%{size}&d=identicon
    ssl_url: https://seccdn.libravatar.org/avatar/%{hash}?s=%{size}&d=identicon"

ファイルを保存してから、変更を有効にするためにGitLabを再起動します。

Libravatarサービスをデフォルト（Gravatar）に設定する

Linuxパッケージインストールの場合:

/etc/gitlab/gitlab.rbからgitlab_rails['gravatar_ssl_url']またはgitlab_rails['gravatar_plain_url']を削除します。
変更を適用するには、sudo gitlab-ctl reconfigureを実行します。

自己コンパイルによるインストールの場合:

config/gitlab.ymlからgravatar:セクションを削除します。
ファイルを保存し、変更を適用するためにGitLabを再起動します。

Gravatarサービスを無効にする

Gravatarを無効にするには（たとえば、サードパーティのサービスを禁止するなど）、次の手順を実行します:

Linuxパッケージインストールの場合:

/etc/gitlab/gitlab.rbを編集します:

gitlab_rails['gravatar_enabled'] = false

変更を適用するには、sudo gitlab-ctl reconfigureを実行します。

自己コンパイルによるインストールの場合:

config/gitlab.ymlを編集します:
```
  gravatar:
    enabled: false
```
ファイルを保存し、変更を適用するためにGitLabを再起動します。

独自のLibravatarサーバー

独自のLibravatarサービスを実行している場合、URLは設定で異なりますが、GitLabがURLを正しく解析できるように、同じプレースホルダーを指定する必要があります。

たとえば、https://libravatar.example.comでサービスをホストし、gitlab.ymlで指定する必要があるssl_urlは次のとおりです:

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

画像が見つからない場合のデフォルトのURL

Libravatarは、Libravatarサービスに見つからないユーザーメールアドレスに対して、異なる画像のセットをサポートしています。

identicon以外のセットを使用するには、URLの&d=identiconの部分を、サポートされている別のセットに置き換えます。たとえば、retroセットを使用できます。その場合、URLはssl_url: "https://seccdn.libravatar.org/avatar/%{hash}?s=%{size}&d=retro"のようになります。

Microsoft Office 365のユースケースの例

ユーザーがOffice 365ユーザーの場合、GetPersonaPhotoサービスを使用できます。このサービスにはログインが必要なため、すべてのユーザーがOffice 365にアクセスできる企業インストールで、このユースケースが最も役立ちます。

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