브로드캐스트 메시지
GitLab v19.4Offering: GitLab Self-Managed, GitLab Dedicated
요약
GitLab은 인스턴스 사용자에게 두 가지 유형의 브로드캐스트 메시지를 표시할 수 있습니다. 브로드캐스트 메시지는 브로드캐스트 메시지 API로 관리할 수 있습니다. 브로드캐스트 메시지는 타기팅 설정과 관계없이 API를 통해 누구나 조회할 수 있습니다.
GitLab은 인스턴스 사용자에게 두 가지 유형의 브로드캐스트 메시지를 표시할 수 있습니다.
- 배너
- 알림
브로드캐스트 메시지는 브로드캐스트 메시지 API로 관리할 수 있습니다.
브로드캐스트 메시지는 타기팅 설정과 관계없이 API를 통해 누구나 조회할 수 있습니다. 민감하거나 기밀인 정보를 포함하지 않아야 하며, 특정 그룹이나 프로젝트에 비공개 정보를 전달하는 용도로 브로드캐스트 메시지를 사용하지 않아야 합니다.
배너#
배너는 페이지 상단에 표시되며, 설정에 따라 명령줄에서 Git 원격 응답으로도 표시됩니다.

$ git push
...
remote:
remote: **Welcome to GitLab** :wave:
remote:
...
배너가 동시에 둘 이상 활성화되어 있으면 생성 순서대로 페이지 상단에 표시됩니다. 명령줄에는 가장 최근 배너만 표시됩니다.
배너는 닫을 수 있도록 구성한 경우에만 닫을 수 있습니다.
알림#
GitLab은 페이지 오른쪽 아래에 알림을 표시합니다. 알림에는 플레이스홀더를 넣을 수 있으며, 플레이스홀더는 현재 사용자의 속성으로 대체됩니다.

{{name}}, would you like to give us feedback?
<a href="example.com">Take our survey!</a>
알림이 동시에 둘 이상 활성화되어 있으면 가장 최근 알림만 표시됩니다.
알림은 다음 플레이스홀더를 지원합니다.
{{email}}{{name}}{{user_id}}{{username}}{{instance_id}}
사용자가 로그인하지 않은 상태라면 사용자 관련 값은 비어 있습니다.
사전 요구 사항#
관리자 액세스 권한이 있어야 합니다.
브로드캐스트 메시지 추가#
GitLab 인스턴스 사용자에게 메시지를 표시하려면 브로드캐스트 메시지를 추가합니다.
브로드캐스트 메시지는 타기팅 설정과 관계없이 API를 통해 누구나 조회할 수 있습니다. 민감하거나 기밀인 정보를 포함하지 않아야 하며, 특정 그룹이나 프로젝트에 비공개 정보를 전달하는 용도로 브로드캐스트 메시지를 사용하지 않아야 합니다.
브로드캐스트 메시지를 추가하려면 다음을 수행합니다.
- 오른쪽 위 모서리에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Messages를 선택합니다.
- 오른쪽에서 Add new message를 선택합니다.
- Message 텍스트를 입력합니다.
- 메시지 내용에는 Markdown, 이모지,
a및brHTML 태그를 사용할 수 있습니다. br태그는 줄바꿈을 넣습니다.aHTML 태그는 다음 CSS 속성을 담은class및style속성을 허용합니다.colorborderbackgroundpaddingmargintext-decoration
- 메시지 내용에는 Markdown, 이모지,
- Type에서
banner또는notification을 선택합니다. - Theme를 선택합니다. 기본 테마는
indigo입니다. - 사용자가 브로드캐스트 메시지를 닫을 수 있게 하려면 Dismissable을 선택합니다.
- 선택 사항. 명령줄에서 Git 원격 응답으로 브로드캐스트 메시지를 표시하지 않으려면 Git remote responses 체크박스를 지웁니다.
- 선택 사항. 일부 사용자에게만 메시지를 표시하려면 Target broadcast message를 선택합니다.
- 모든 페이지에서 모든 사용자에게 표시합니다.
- 조건에 맞는 특정 페이지에서 모든 사용자에게 표시합니다.
- 그룹 또는 프로젝트 페이지에서 특정 권한을 가진 사용자에게만 표시합니다. 이 설정을 사용하면 메시지가 그룹, 하위 그룹, 프로젝트 페이지에 표시되지만 Git 원격 응답에는 표시되지 않습니다.
- 필요하다면 브로드캐스트 메시지를 표시할 Target roles를 선택합니다.
- 필요하다면 Target Path를 추가하여 해당 경로와 일치하는 URL 에서만 브로드캐스트 메시지를 표시합니다.
와일드카드 문자
*로 여러 URL을 지정할 수 있습니다. 예를 들면 다음과 같습니다.*/-/milestones는 모든 그룹 또는 프로젝트의 Milestones 목록 페이지를 지정합니다.*/-/milestones/*는 개별 마일스톤 페이지만 지정합니다.*/-/milestones*는 목록 페이지와 개별 마일스톤 페이지를 모두 지정합니다.
- 메시지를 시작하고 종료할 날짜와 시간(UTC)을 선택합니다.
- Add broadcast message를 선택합니다.
브로드캐스트 메시지가 만료되면 사용자 인터페이스에는 더 이상 표시되지 않지만 브로드캐스트 메시지 목록에는 그대로 남아 있습니다.
브로드캐스트 메시지 편집#
브로드캐스트 메시지를 변경해야 한다면 편집할 수 있습니다.
브로드캐스트 메시지를 편집하려면 다음을 수행합니다.
- 오른쪽 위 모서리에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Messages를 선택합니다.
- 브로드캐스트 메시지 목록에서 해당 메시지의 편집 버튼을 선택합니다.
- 필요한 내용을 변경한 다음 Update broadcast message를 선택합니다.
만료된 메시지는 종료 날짜를 변경하여 다시 활성화할 수 있습니다.
브로드캐스트 메시지 삭제#
브로드캐스트 메시지가 더 이상 필요하지 않다면 삭제할 수 있습니다. 활성 상태인 브로드캐스트 메시지도 삭제할 수 있습니다.
브로드캐스트 메시지를 삭제하려면 다음을 수행합니다.
- 오른쪽 위 모서리에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Messages를 선택합니다.
- 브로드캐스트 메시지 목록에서 해당 메시지의 삭제 버튼을 선택합니다.
브로드캐스트 메시지를 삭제하면 브로드캐스트 메시지 목록에서 제거됩니다.