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

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

Libravatarもまた、あなたのアバター(プロフィール画像)を他のウェブサイトに配信するサービスです。Libravatar APIはGravatarを大きくベースにしているので、Libravatarアバターサービスや独自のLibravatarサーバーに切り替えることもできます。

FIPSモードではGravatarを含むLibravatarサービスを利用できません。

Libravatarサービスを独自のサービスに変更してください。

note
LibravatarサービスのURLにはMD5ハッシュしか使えません。SHA-256 サポートの追加については、イシュー 370057を参照してください。

gitlab.yml gravatar セクションで、設定オプションを次のように設定してください:

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

  1. /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"
    
  2. 変更を適用するには、sudo gitlab-ctl reconfigure を実行します。

セルフコンパイルによるインストールの場合:

  1. 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"
    
  2. ファイルを保存し、変更を有効にするためにGitLabを再起動してください。

Libravatarサービスをデフォルト(Gravatar)に設定します。

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

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

セルフコンパイルによるインストールの場合:

  1. config/gitlab.yml からgravatar: セクションを削除してください。
  2. ファイルを保存し、GitLabを再起動して変更を適用します。

Gravatar サービスを無効にします。

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

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

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

    gitlab_rails['gravatar_enabled'] = false
    
  2. 変更を適用するには、sudo gitlab-ctl reconfigure を実行します。

セルフコンパイルによるインストールの場合:

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

      gravatar:
        enabled: false
    
  2. ファイルを保存し、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'