GitLab에서 Libravatar 서비스 사용하기

Tier: Free, Premium, Ultimate Offering: Self-Managed

기본적으로 GitLab은 Gravatar 아바타 서비스를 지원합니다.

Libravatar는 다른 웹사이트에 사용자의 아바타(프로필 사진)를 전달하는 또 다른 서비스입니다. Libravatar API는 Gravatar를 많이 기반으로 하고 있기 때문에 Libravatar 아바타 서비스나 심지어 자체 Libravatar 서버로 전환할 수 있습니다.

Libravatar 서비스를 자체 서비스로 변경

gitlab.yml Gravatar 섹션에서 다음과 같이 구성 옵션을 설정하세요.

Linux 패키지 설치의 경우:

  1. /etc/gitlab/gitlab.rb 파일을 편집하세요. 

    gitlab_rails['gravatar_enabled'] = true
#### HTTPS의 경우
gitlab_rails['gravatar_ssl_url'] = "https://seccdn.libravatar.org/avatar/%{hash}?s=%{size}&d=identicon"
#### 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
    # 기본: https://www.gravatar.com/avatar/%{hash}?s=%{size}&d=identicon
    plain_url: "http://cdn.libravatar.org/avatar/%{hash}?s=%{size}&d=identicon"
    # 기본: 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를 비활성화하려면, 예를 들어 제3자 서비스를 금지하려는 경우, 다음 단계를 완료하세요.

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는 사용자 이메일 주소에 대한 찾을 수 없는 이미지를 위한 다른 세트를 지원합니다.

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'