Интеграция GitHub Slack позволяет подключить аккаунт GitHub к GitHub приложению в Slack. После подключения вы можете использовать команды слэша для взаимодействия GitHub, получения уведомлений о активности репозитория и сотрудничества с командой непосредственно в Slack.
Подключение аккаунта GitHub к GitHub приложению в Slack
Примечание.
Прежде чем вы сможете подключить свои аккаунты, администратор вашего рабочего пространства Slack должен уже установить приложение GitHub . См . раздел AUTOTITLE.
- В Slack начните личное сообщение через приложение GitHub .
- Личное сообщение будет заранее заполнено приветственным сообщением и ссылкой для подключения вашего GitHub аккаунта. Следуйте подсказкам на экране в Slack и GitHub в браузере, чтобы аутентифицировать и авторизировать соединение.
После подключения GitHub аккаунта Slack покажет вам список доступных команд и функций, которые можно использовать.
Использование Slash-команд для взаимодействия GitHub в Slack
Чтобы использовать команду slash, введите /github команду, а затем команду, которую хотите выполнить, в поле ввода сообщения любого Slack-канала или личного сообщения, где находится приложение GitHub . Чтобы пригласить приложение на канал, введите /invite @github его в нужном месте.
| Command | Description |
|---|---|
/github help | Отображает список основных команд и их описания. |
/github subscribe owner/repo | Подписывает канал на уведомления для указанного репозитория. |
/github unsubscribe owner/repo | Отписывает канал от уведомлений для указанного репозитория. |
/github subscribe list | Список всех репозиториев, на которые подписан канал. |
/github open owner/repo | Открывает проблему в указанном репозитории. Вам будет предложено указать название и описание проблемы. |
/github close [issue link] | Закрывает указанную проблему как завершенную. |
/github close [issue link] reason:"not planned" | Закрывает указанный вопрос с причиной. Замените "not planned" на свою причину. |
/github reopen [issue link] | Повторно открывает указанную проблему. |
/github signin | Перезапускайте рабочий процесс «Подключите аккаунт GitHub». |
Примечание.
При подписке канала на репозиторий канал будет получать уведомления обо всех open, close, а также reopen событиях о запросах на вытягивание и проблемах в этом репозитории. Канал также будет получать уведомления о любых push событиях непосредственно в ветвь репозитория по умолчанию.
Упоминания в Slack
Когда вы подписываетесь на репозиторий в Slack, вы увидите себя упомянутым в уведомлениях о событиях репозитория, в которых вы упоминались. Например, если вам назначена задача или вы упомянуты в комментарии, вы увидите себя упомянутым в уведомлении в Slack.
Упоминания требуют входа в аккаунт GitHub через GitHub приложение в Slack. Это позволяет GitHub сопоставить вашу Slack-идентичность с вашей GitHub идентичностью. См. раздел «Подключение GitHub вашего GitHub аккаунта к приложению» в Slack.
Примечание.
Если у вас есть несколько рабочих пространств, где вы используете приложение GitHub , упоминания будут работать только в том рабочем пространстве, где вы недавно вошли в приложение GitHub . Если вы входите в GitHub приложение в другом рабочем пространстве, упоминания перестанут работать в предыдущем workspace.
Ниже приведены сценарии, в которых вы будете упомянуты:
- Вам назначена задача.
- Ваш отзыв запрашивается в запросе на вытягивание.
- Вы упоминаетесь в запросе на вытягивание, описании проблемы, комментарии или обсуждении.
- Ваш отзыв запрашивается по развертыванию.
- Вы получаете запланированное напоминание о запросе на проверку по запросу.
Краткое описание ваших GitHub упоминаний можно увидеть в разделе «Упоминания» в Slack. Дополнительные сведения см. в разделе Уведомления о рассмотрении на вкладке «Действия » в документации Slack.
Цепочка бесед
Уведомления о каждой проблеме или запросе pull группируются в цепочку в Slack. В родительском сообщении всегда отображается последний статус проблемы или запроса на вытягивание, а также другие метаданные, такие как название, описание, исполнители, рецензенты, метки и проверки. Цепочки помогают поддерживать организованность обсуждений, упрощая отслеживание обновлений и обсуждений, связанных с конкретной проблемой или запросом на вытягивание. Когда состояние проблемы или запроса на вытягивание изменяется, соответствующий ответ публикуется как в цепочке, так и в канале, чтобы все участники канала знали об обновлении.
Вы можете отключить потоки для уведомлений о проблемах и запросах на вытягивание в отдельных каналах.
- В канале Slack, где вы хотите отключить потоки, введите
/github settings. - В меню настроек справа от пункта «Отключить потоки для уведомлений о вытягивании и выгрузке» нажмите «Отключить».
Вы или любой другой участник канала можете повторно включить потоки в любое время, выполнив те же действия и нажав «Включить » в меню настроек.
Трансляция комментариев и отзывов на канал Slack
По умолчанию комментарии и отзывы будут отображаться только в соответствующей теме. Если вы хотите, чтобы участники канала видели их, а не только участников выпуска, вы можете включить трансляцию с помощью следующих команд:
-
Для трансляции комментариев используйте
/github subscribe owner/repo comments:"channel" -
Для обзорной трансляции используйте
/github subscribe owner/repo reviews:"channel"
Раскрывая ссылки на GitHub активности в Slack
Превью ссылок предоставляет дополнительный контекст при обмене ссылками на GitHub активности в Slack. Превью ссылок отображаются в Slack для следующих GitHub заданий:
- Запросы на слияние
- Проблемы
- Комментарии с прямыми ссылками
- Кодирование больших двоичных объектов с номерами строк
- Организации, репозитории и пользователи
Предварительный просмотр ссылок не будет отображаться, если применимо одно из следующих условий:
- Предварительный просмотр ссылок отключен в рабочем пространстве Slack. Подробнее о том, как делиться ссылками и настраивать параметры предварительного просмотра , см. в документации Slack.
- Эта же ссылка уже была распространена на канале за последние 30 минут.
- В одном сообщении публикуется 3 или более ссылок.
- Репозиторий является частным, и пользователь, который поделился ссылкой:
- Не подключил их GitHub аккаунт к GitHub приложению в Slack.
- Предлагается не показывать предварительный просмотр ссылок при появлении запроса.
-
GitHub Приложение не находится в канале, где распространяется ссылка. См. [Использование слэш-команд для взаимодействия с GitHub в Slack](#using-slash-commands-to-interact-with-github-in-slack).
Дополнительные материалы
-
[AUTOTITLE](/integrations/how-tos/slack/customize-notifications) — Узнайте, как настроить уведомления GitHub в Slack под свои потребности. -
[AUTOTITLE](/integrations/tutorials/slack) — Развивайте навыки и знания о интеграции GitHub Slack через примеры и практические занятия.