--- description: Основное предназначение бота - это уведомления от GitLab. Вы будете получать только персональные уведомления. --- # :bell:{ .jingle-bell } Уведомления Основное предназначение бота - это уведомления от GitLab. Вы будете получать только те уведомления, которые касаются вас непосредственно. ## Новый репозиторий { id="new-repository" } Если во время [первичной настройки](../getting-started/first-start.md) вы указали, что хотите получать уведомления о новых репозиториях, то при появлении нового репозитория получите соответствующее уведомление:
![notify about new merge request](img/notify-new-project.png){ loading=lazy width="500" }
Уведомление содержит: - GitLab Notify — название репозитория. - Project description — описание репозитория. Опционально, может быть пусто. - ssh, http — ссылки на удаленный репозиторий. При нажатии будет скопирована в буфер обмена. - Author Name — имя создателя репозитория в GitLab Доступно три быстрых действия: - :link: — ссылка на новый репозиторий в GitLab. - :bell: — поставить на отслеживание. Вы начнете получать уведомления о событиях в MR, тредах и сборках. - :no_bell: — не получать уведомления. Используется по умолчанию, по факту просто удаляет сообщение уведомления. !!! warning "Отслеживание репозитория" Пока вы явно не нажмете :bell:, вы не будете получать никаких уведомлений. Более того, приложение даже не будет запрашивать MR и прочие сущности репозитория, не будет сохранять их в БД. ## Новый MR { id="new-mr" } Это уведомление приходит, когда вас назначают ответственным и/или ревьювером. При этом не важно когда это произошло: вас указали при создании MR, или потом заменили кого-то вами. Вы в любом случае получите уведомление.
![notify about new merge request](img/notify-new-mr.png){ loading=lazy width="500" }
Уведомление содержит: - Название MR. - Описание MR. Опционально. - Labels. Метки репозитория. - Имя проекта. - Ветки откуда куда мержим. - Автор MR. - Ответственный/Ревьюверы MR. Заполнение зависит от вашей позиции в этом MR. Если вы ответственный, то вам покажут ревьюверов. Если вы ревьювер, то ответственного. Доступные быстрые действия: - :eyes: — прочитано. Удаляет сообщение. - :link: — ссылка на MR. - :no_bell: — не получать уведомления по MR. !!! warning Учтите, что отключение уведомлений отключает только уведомления об изменениях в MR. Например, обновление статуса MR. Но уведомления по пайплайнам проекта, по тредам MR продолжат приходить. ## Конфликт в MR { id="conflict-mr" } Если в вашем MR возник конфликт, то вы будете своевременно оповещены. В этом уведомлении указывается название MR, проект и ветка.
![notify about conflict in merge request](img/notify-conflict-mr.png){ loading=lazy width="500" }
Доступные быстрые действия: - :eyes: — прочитано. Удаляет сообщение. - :link: — ссылка на MR. - :no_bell: — не получать уведомления по этому MR. ## Обновление MR { id="update-mr" } Если в MR, в котором вы являетесь ответственным/ревьювером, добавляются коммиты, вы получаете уведомление.
![notify about update in merge request](img/notify-update-mr.png){ loading=lazy width="500" }
Уведомление содержит: - Название MR. - Отношение количества закрытых тредов к общему количеству созданных тредов. - Отношение количества закрытых вами созданных тредов к общему количеству созданных вами тредов. - Название репозитория. - Имя создателя MR. Доступные быстрые действия: - :eyes: — прочитано. Удаляет сообщение. - :link: — ссылка на MR. - :no_bell: — не получать уведомления по этому MR. ## Изменение статуса MR { id="status-mr" } Когда статус вашего MR меняется, вы получаете уведомление.
![notify about update status in merge request](img/notify-update-status-mr.png){ loading=lazy width="500" }
Доступные быстрые действия: - :eyes: — прочитано. Удаляет сообщение. - :link: — ссылка на MR. ## Новый тред в MR { id="new-thread" } В GitLab можно создавать не просто комментарии, а треды. Если кто-то создаст такое обсуждение в вашем MR, то вы сразу об этом узнаете. Это уведомление поддерживает уровни конфиденциальности: 1. `WITHOUT_NOTIFY` — уведомления по тредам не отправляются совсем. 2. `NOTIFY_WITHOUT_CONTEXT` — вы получаете уведомление о факте нового треда, но без текста сообщений и отправителей. 3. `NOTIFY_WITHOUT_CONTEXT` — самое подробное уведомление. Содержит текст сообщений и имена отправителей. === "NOTIFY_WITH_CONTEXT"
![notify about new thread in merge request](img/notify-new-thread.png){ loading=lazy width="500" }
Уведомление содержит: - Название MR - Первое сообщение треда с автором треда - Остальные сообщения треда, если таковые имеются. === "NOTIFY_WITHOUT_CONTEXT"
![notify about new thread in merge request](img/notify-new-thread-without-context.png){ loading=lazy width="500" }
Уведомление содержит: - Название MR Доступные быстрые действия: - Ответ в GitLab из Telegram. - :eyes: — прочитано. Удаляет сообщение. - :link: — ссылка на тред. - :no_bell: — не получать уведомления по этому треду. Уведомления по другим тредам в это MR продолжат поступать. ## Новое сообщение в треде { id="new-thread-answer" } Важно оставаться в теме обсуждения, поэтому при появлении новых ответов в тредах, в которых вы участвовали, вы получите уведомление. Это уведомление поддерживает уровни конфиденциальности: 1. `WITHOUT_NOTIFY` — уведомления по тредам не отправляются совсем. 2. `NOTIFY_WITHOUT_CONTEXT` — вы получаете уведомление о факте нового треда, но без текста сообщений и отправителей. 3. `NOTIFY_WITHOUT_CONTEXT` — самое подробное уведомление. Содержит текст сообщений и имена отправителей. === "NOTIFY_WITH_CONTEXT"
![notify about new message in thread](img/notify-new-comment-in-thread.png){ loading=lazy width="500" }
Уведомление содержит: - Название MR - Первое сообщение треда с автором треда - Предпоследнее сообщение треда - Новое сообщение треда !!! tip "" Такой объем информации должен помочь вам вспомнить/понять контекст обсуждения и ответить прямо из Telegram. === "NOTIFY_WITHOUT_CONTEXT"
![notify about new comment in thread without context](img/notify-new-comment-in-thread-without-context.png){ loading=lazy width="500" }
Уведомление содержит: - Название MR Доступные быстрые действия: - Ответ в GitLab из Telegram. - :eyes: — прочитано. Удаляет сообщение. - :link: — ссылка на тред. - :no_bell: — не получать уведомления по этому треду. Уведомления по другим тредам в это MR продолжат поступать. ### Упоминание в треде { id="mention-in-thread" } Допустим, кто-то упомянул вас в MR используя тегирование GitLab (@GitlabLogin). Автор этого MR не вы, ответственным назначали тоже не вас. Если вы отслеживаете репозиторий этого MR, но не участвовали в дискуссии, то в этом случае вам придет уведомление. Так вы не пропустите сообщения с вашим упоминанием. Формат и быстрые действия такие же, как у уведомления "Новое сообщение в треде". ## Уведомление о решенном треде { id="resolved-thread" } Если кто-то отметит решенным созданный вами тред, вы получите уведомление об этом. ## Уведомление о пайплайне { id="new-pipeline" } Полезно сразу узнавать, что сборка закончилась успешно или упала. !!! question "Я буду получать уведомление обо всех пайплайнах?" Нет. Вы будете получать уведомление только о тех пайплайнах, в которых выступили инициатором. Напримр, запустили CI руками из GitLab, или нажали кнопку Merge в MR.
![notify about new pipeline](img/notify-new-pipeline.png){ loading=lazy width="500" }
Уведомление содержит: - Предыдущий статус пайплайна и новый статус - Номер пайплайна - Название репозитория - Ветка, для которой запускалась сборка Доступные быстрые действия: - :eyes: — прочитано. Удаляет сообщение. - :link: — ссылка на результат работы пайплайна.