방송 메시지

Tier: Free, Premium, Ultimate

Offering: Self-Managed

  • 타겟 역할은 GitLab 14.8에서 플래그role_targeted_broadcast_messages도입되었습니다. 기본으로 비활성화됩니다.
  • 테마는 GitLab 14.10에서 도입되었고, 배경 색상이 제거되었습니다.

GitLab은 GitLab 인스턴스의 사용자에게 방송 메시지를 표시할 수 있습니다. 방송 메시지에는 두 가지 유형이 있습니다:

  • 배너
  • 알림

방송 메시지는 방송 메시지 API를 사용하여 관리할 수 있습니다.

배너

배너는 페이지 상단에 표시되며 선택적으로 Git 원격 응답으로 명령행에도 표시됩니다.

방송 메시지 배너

$ git push
...
remote:
remote: **GitLab에 오신 것을 환영합니다** :wave:
remote:
...

한 번에 여러 배너가 활성화된 경우, 생성된 순서대로 페이지 상단에 표시됩니다. 명령행에서는 가장 최근 배너만 표시됩니다.

알림

알림은 페이지 오른쪽 하단에 표시되며 플레이스홀더를 포함할 수 있습니다. 플레이스홀더는 활성 사용자의 속성으로 대체됩니다. 플레이스홀더는 중괄호로 둘러싸여 있어야 합니다. 예를 들어 {{name}}. 사용 가능한 플레이스홀더는 다음과 같습니다:

  • {{email}}
  • {{name}}
  • {{user_id}}
  • {{username}}
  • {{instance_id}}

사용자가 로그인하지 않은 경우 사용자 관련 값은 비어 있습니다.

방송 메시지 알림

한 번에 여러 알림이 활성화된 경우 가장 최신 알림만 표시됩니다.

방송 메시지 추가

GitLab 인스턴스의 사용자에게 메시지를 표시하려면 방송 메시지를 추가하세요.

방송 메시지를 추가하려면:

  1. 왼쪽 사이드바에서 맨 아래에서 관리 영역(Admin Area)을 선택합니다.
  2. 메시지(Messages)를 선택합니다.
  3. 새 메시지 추가(Add new message)를 선택합니다.
  4. 메시지(Message) 필드에 메시지의 텍스트를 추가합니다. Markdown, 이모지, abr HTML 태그를 사용하여 메시지 내용을 스타일 지정할 수 있습니다. br 태그는 줄 바꿈을 삽입합니다. a HTML 태그는 다음 CSS 속성을 가진 classstyle 속성을 허용합니다:
    • color
    • border
    • background
    • padding
    • margin
    • text-decoration
  5. 테마(Theme)를 선택합니다. 기본 테마는 indigo입니다.
  6. 사라질 수 있는(Dismissable) 확인란을 선택하여 사용자가 방송 메시지를 닫을 수 있도록 합니다.
  7. 선택 사항. Git 원격 응답(Git remote responses) 확인란을 지워서 Git 명령행에서 방송 메시지가 표시되는 것을 방지합니다.
  8. 선택 사항. 타겟 역할(Target roles)을 선택하여 선택한 역할을 가진 사용자에게만 방송 메시지를 표시합니다. 메시지는 그룹, 하위 그룹 및 프로젝트 페이지에 표시되며 Git 원격 응답에는 표시되지 않습니다.
  9. 필요한 경우, 타겟 경로(Target Path)를 추가하여 해당 경로와 일치하는 URL에서만 방송 메시지를 표시합니다. 예를 들어 mygroup/myproject*와 같이 와일드카드 문자 *를 사용하여 여러 URL과 일치할 수 있습니다.
  10. 메시지가 시작하고 끝나는 날짜와 시간(UTC)을 선택합니다.
  11. 방송 메시지 추가(Add broadcast message)를 선택합니다.

방송 메시지가 만료되면 사용자 인터페이스에 더 이상 표시되지 않지만 방송 메시지 디렉터리에는 계속 표시됩니다.

방송 메시지 수정

방송 메시지를 수정해야 하는 경우 수정할 수 있습니다.

방송 메시지를 수정하려면:

  1. 왼쪽 사이드바에서 맨 아래에서 관리 영역(Admin Area)을 선택합니다.
  2. 메시지(Messages)를 선택합니다.
  3. 방송 메시지 디렉터리에서 메시지의 수정 버튼을 선택합니다.
  4. 필요한 변경 사항을 한 후 방송 메시지 업데이트(Update broadcast message)를 선택합니다.

만료된 메시지는 종료 날짜를 변경하여 다시 활성화할 수 있습니다.

방송 메시지 삭제

방송 메시지가 더 이상 필요하지 않은 경우 삭제할 수 있습니다. 방송 메시지가 활성 상태일 때 삭제할 수 있습니다.

방송 메시지를 삭제하려면:

  1. 왼쪽 사이드바에서 맨 아래에서 관리 영역(Admin Area)을 선택합니다.
  2. 메시지(Messages)를 선택합니다.
  3. 방송 메시지 디렉터리에서 메시지의 삭제 버튼을 선택합니다.

방송 메시지가 삭제되면 방송 메시지 디렉터리에서 제거됩니다.