InfoGrab DocsInfoGrab Docs

브로드캐스트 메시지

요약

GitLab은 인스턴스 사용자에게 두 가지 유형의 브로드캐스트 메시지를 표시할 수 있습니다. 브로드캐스트 메시지는 브로드캐스트 메시지 API로 관리할 수 있습니다. 브로드캐스트 메시지는 타기팅 설정과 관계없이 API를 통해 누구나 조회할 수 있습니다.

GitLab은 인스턴스 사용자에게 두 가지 유형의 브로드캐스트 메시지를 표시할 수 있습니다.

  • 배너
  • 알림

브로드캐스트 메시지는 브로드캐스트 메시지 API로 관리할 수 있습니다.

Warning

브로드캐스트 메시지는 타기팅 설정과 관계없이 API를 통해 누구나 조회할 수 있습니다. 민감하거나 기밀인 정보를 포함하지 않아야 하며, 특정 그룹이나 프로젝트에 비공개 정보를 전달하는 용도로 브로드캐스트 메시지를 사용하지 않아야 합니다.

배너#

배너는 페이지 상단에 표시되며, 설정에 따라 명령줄에서 Git 원격 응답으로도 표시됩니다.

A broadcast message banner displaying a welcome message.

$ git push
...
remote:
remote: **Welcome to GitLab** :wave:
remote:
...

배너가 동시에 둘 이상 활성화되어 있으면 생성 순서대로 페이지 상단에 표시됩니다. 명령줄에는 가장 최근 배너만 표시됩니다.

배너는 닫을 수 있도록 구성한 경우에만 닫을 수 있습니다.

알림#

GitLab은 페이지 오른쪽 아래에 알림을 표시합니다. 알림에는 플레이스홀더를 넣을 수 있으며, 플레이스홀더는 현재 사용자의 속성으로 대체됩니다.

A broadcast message notification using the name placeholder.

{{name}}, would you like to give us feedback?
<a href="example.com">Take our survey!</a>

알림이 동시에 둘 이상 활성화되어 있으면 가장 최근 알림만 표시됩니다.

알림은 다음 플레이스홀더를 지원합니다.

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

사용자가 로그인하지 않은 상태라면 사용자 관련 값은 비어 있습니다.

사전 요구 사항#

관리자 액세스 권한이 있어야 합니다.

브로드캐스트 메시지 추가#

GitLab 인스턴스 사용자에게 메시지를 표시하려면 브로드캐스트 메시지를 추가합니다.

Warning

브로드캐스트 메시지는 타기팅 설정과 관계없이 API를 통해 누구나 조회할 수 있습니다. 민감하거나 기밀인 정보를 포함하지 않아야 하며, 특정 그룹이나 프로젝트에 비공개 정보를 전달하는 용도로 브로드캐스트 메시지를 사용하지 않아야 합니다.

브로드캐스트 메시지를 추가하려면 다음을 수행합니다.

  1. 오른쪽 위 모서리에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 Messages를 선택합니다.
  3. 오른쪽에서 Add new message를 선택합니다.
  4. Message 텍스트를 입력합니다.
    • 메시지 내용에는 Markdown, 이모지, a 및 br HTML 태그를 사용할 수 있습니다.
    • br 태그는 줄바꿈을 넣습니다.
    • a HTML 태그는 다음 CSS 속성을 담은 class 및 style 속성을 허용합니다.
      • color
      • border
      • background
      • padding
      • margin
      • text-decoration
  5. Type에서 banner 또는 notification을 선택합니다.
  6. Theme를 선택합니다. 기본 테마는 indigo 입니다.
  7. 사용자가 브로드캐스트 메시지를 닫을 수 있게 하려면 Dismissable을 선택합니다.
  8. 선택 사항. 명령줄에서 Git 원격 응답으로 브로드캐스트 메시지를 표시하지 않으려면 Git remote responses 체크박스를 지웁니다.
  9. 선택 사항. 일부 사용자에게만 메시지를 표시하려면 Target broadcast message를 선택합니다.
    • 모든 페이지에서 모든 사용자에게 표시합니다.
    • 조건에 맞는 특정 페이지에서 모든 사용자에게 표시합니다.
    • 그룹 또는 프로젝트 페이지에서 특정 권한을 가진 사용자에게만 표시합니다. 이 설정을 사용하면 메시지가 그룹, 하위 그룹, 프로젝트 페이지에 표시되지만 Git 원격 응답에는 표시되지 않습니다.
  10. 필요하다면 브로드캐스트 메시지를 표시할 Target roles를 선택합니다.
  11. 필요하다면 Target Path를 추가하여 해당 경로와 일치하는 URL 에서만 브로드캐스트 메시지를 표시합니다. 와일드카드 문자 *로 여러 URL을 지정할 수 있습니다. 예를 들면 다음과 같습니다.
    • */-/milestones는 모든 그룹 또는 프로젝트의 Milestones 목록 페이지를 지정합니다.
    • */-/milestones/*는 개별 마일스톤 페이지만 지정합니다.
    • */-/milestones*는 목록 페이지와 개별 마일스톤 페이지를 모두 지정합니다.
  12. 메시지를 시작하고 종료할 날짜와 시간(UTC)을 선택합니다.
  13. Add broadcast message를 선택합니다.

브로드캐스트 메시지가 만료되면 사용자 인터페이스에는 더 이상 표시되지 않지만 브로드캐스트 메시지 목록에는 그대로 남아 있습니다.

브로드캐스트 메시지 편집#

브로드캐스트 메시지를 변경해야 한다면 편집할 수 있습니다.

브로드캐스트 메시지를 편집하려면 다음을 수행합니다.

  1. 오른쪽 위 모서리에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 Messages를 선택합니다.
  3. 브로드캐스트 메시지 목록에서 해당 메시지의 편집 버튼을 선택합니다.
  4. 필요한 내용을 변경한 다음 Update broadcast message를 선택합니다.

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

브로드캐스트 메시지 삭제#

브로드캐스트 메시지가 더 이상 필요하지 않다면 삭제할 수 있습니다. 활성 상태인 브로드캐스트 메시지도 삭제할 수 있습니다.

브로드캐스트 메시지를 삭제하려면 다음을 수행합니다.

  1. 오른쪽 위 모서리에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 Messages를 선택합니다.
  3. 브로드캐스트 메시지 목록에서 해당 메시지의 삭제 버튼을 선택합니다.

브로드캐스트 메시지를 삭제하면 브로드캐스트 메시지 목록에서 제거됩니다.

브로드캐스트 메시지

GitLab v19.4
Tier: Free, Premium, Ultimate
Offering: GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

GitLab은 인스턴스 사용자에게 두 가지 유형의 브로드캐스트 메시지를 표시할 수 있습니다. 브로드캐스트 메시지는 브로드캐스트 메시지 API로 관리할 수 있습니다. 브로드캐스트 메시지는 타기팅 설정과 관계없이 API를 통해 누구나 조회할 수 있습니다.

GitLab은 인스턴스 사용자에게 두 가지 유형의 브로드캐스트 메시지를 표시할 수 있습니다.

  • 배너
  • 알림

브로드캐스트 메시지는 브로드캐스트 메시지 API로 관리할 수 있습니다.

Warning

브로드캐스트 메시지는 타기팅 설정과 관계없이 API를 통해 누구나 조회할 수 있습니다. 민감하거나 기밀인 정보를 포함하지 않아야 하며, 특정 그룹이나 프로젝트에 비공개 정보를 전달하는 용도로 브로드캐스트 메시지를 사용하지 않아야 합니다.

배너#

배너는 페이지 상단에 표시되며, 설정에 따라 명령줄에서 Git 원격 응답으로도 표시됩니다.

A broadcast message banner displaying a welcome message.

$ git push
...
remote:
remote: **Welcome to GitLab** :wave:
remote:
...

배너가 동시에 둘 이상 활성화되어 있으면 생성 순서대로 페이지 상단에 표시됩니다. 명령줄에는 가장 최근 배너만 표시됩니다.

배너는 닫을 수 있도록 구성한 경우에만 닫을 수 있습니다.

알림#

GitLab은 페이지 오른쪽 아래에 알림을 표시합니다. 알림에는 플레이스홀더를 넣을 수 있으며, 플레이스홀더는 현재 사용자의 속성으로 대체됩니다.

A broadcast message notification using the name placeholder.

{{name}}, would you like to give us feedback?
<a href="example.com">Take our survey!</a>

알림이 동시에 둘 이상 활성화되어 있으면 가장 최근 알림만 표시됩니다.

알림은 다음 플레이스홀더를 지원합니다.

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

사용자가 로그인하지 않은 상태라면 사용자 관련 값은 비어 있습니다.

사전 요구 사항#

관리자 액세스 권한이 있어야 합니다.

브로드캐스트 메시지 추가#

GitLab 인스턴스 사용자에게 메시지를 표시하려면 브로드캐스트 메시지를 추가합니다.

Warning

브로드캐스트 메시지는 타기팅 설정과 관계없이 API를 통해 누구나 조회할 수 있습니다. 민감하거나 기밀인 정보를 포함하지 않아야 하며, 특정 그룹이나 프로젝트에 비공개 정보를 전달하는 용도로 브로드캐스트 메시지를 사용하지 않아야 합니다.

브로드캐스트 메시지를 추가하려면 다음을 수행합니다.

  1. 오른쪽 위 모서리에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 Messages를 선택합니다.
  3. 오른쪽에서 Add new message를 선택합니다.
  4. Message 텍스트를 입력합니다.
    • 메시지 내용에는 Markdown, 이모지, a 및 br HTML 태그를 사용할 수 있습니다.
    • br 태그는 줄바꿈을 넣습니다.
    • a HTML 태그는 다음 CSS 속성을 담은 class 및 style 속성을 허용합니다.
      • color
      • border
      • background
      • padding
      • margin
      • text-decoration
  5. Type에서 banner 또는 notification을 선택합니다.
  6. Theme를 선택합니다. 기본 테마는 indigo 입니다.
  7. 사용자가 브로드캐스트 메시지를 닫을 수 있게 하려면 Dismissable을 선택합니다.
  8. 선택 사항. 명령줄에서 Git 원격 응답으로 브로드캐스트 메시지를 표시하지 않으려면 Git remote responses 체크박스를 지웁니다.
  9. 선택 사항. 일부 사용자에게만 메시지를 표시하려면 Target broadcast message를 선택합니다.
    • 모든 페이지에서 모든 사용자에게 표시합니다.
    • 조건에 맞는 특정 페이지에서 모든 사용자에게 표시합니다.
    • 그룹 또는 프로젝트 페이지에서 특정 권한을 가진 사용자에게만 표시합니다. 이 설정을 사용하면 메시지가 그룹, 하위 그룹, 프로젝트 페이지에 표시되지만 Git 원격 응답에는 표시되지 않습니다.
  10. 필요하다면 브로드캐스트 메시지를 표시할 Target roles를 선택합니다.
  11. 필요하다면 Target Path를 추가하여 해당 경로와 일치하는 URL 에서만 브로드캐스트 메시지를 표시합니다. 와일드카드 문자 *로 여러 URL을 지정할 수 있습니다. 예를 들면 다음과 같습니다.
    • */-/milestones는 모든 그룹 또는 프로젝트의 Milestones 목록 페이지를 지정합니다.
    • */-/milestones/*는 개별 마일스톤 페이지만 지정합니다.
    • */-/milestones*는 목록 페이지와 개별 마일스톤 페이지를 모두 지정합니다.
  12. 메시지를 시작하고 종료할 날짜와 시간(UTC)을 선택합니다.
  13. Add broadcast message를 선택합니다.

브로드캐스트 메시지가 만료되면 사용자 인터페이스에는 더 이상 표시되지 않지만 브로드캐스트 메시지 목록에는 그대로 남아 있습니다.

브로드캐스트 메시지 편집#

브로드캐스트 메시지를 변경해야 한다면 편집할 수 있습니다.

브로드캐스트 메시지를 편집하려면 다음을 수행합니다.

  1. 오른쪽 위 모서리에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 Messages를 선택합니다.
  3. 브로드캐스트 메시지 목록에서 해당 메시지의 편집 버튼을 선택합니다.
  4. 필요한 내용을 변경한 다음 Update broadcast message를 선택합니다.

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

브로드캐스트 메시지 삭제#

브로드캐스트 메시지가 더 이상 필요하지 않다면 삭제할 수 있습니다. 활성 상태인 브로드캐스트 메시지도 삭제할 수 있습니다.

브로드캐스트 메시지를 삭제하려면 다음을 수행합니다.

  1. 오른쪽 위 모서리에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 Messages를 선택합니다.
  3. 브로드캐스트 메시지 목록에서 해당 메시지의 삭제 버튼을 선택합니다.

브로드캐스트 메시지를 삭제하면 브로드캐스트 메시지 목록에서 제거됩니다.