Интеграция GitHub для Slack позволяет подключить учетную запись GitHub к приложению GitHub в Slack. После подключения вы можете использовать команды косой черты для взаимодействия с GitHub, получать уведомления о действиях репозитория и сотрудничать со своей командой прямо в Slack.
Подключение учетной записи GitHub к приложению GitHub в Slack
Примечание.
Прежде чем вы сможете подключить учетные записи, администратор рабочего пространства Slack должен установить приложение GitHub. См . раздел AUTOTITLE.
- В Slack начните прямое сообщение с помощью приложения GitHub.
- Прямое сообщение будет предварительно заполнено приветственным сообщением и ссылкой для подключения вашей учетной записи GitHub. Следуйте инструкциям на экране в Slack и в GitHub в браузере, чтобы аутентифицировать и авторизовать подключение.
Как только ваша учетная запись GitHub будет подключена, Slack покажет вам список доступных команд и функций, которые вы можете использовать.
Использование команд Slash для взаимодействия с GitHub в Slack
Чтобы использовать команду с косой чертой, введите /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.
Примечание.
Если у вас есть несколько рабочих пространств Slack, в которых вы используете приложение GitHub, упоминания будут работать только в том рабочем пространстве, в котором вы недавно вошли в свое приложение GitHub. Если вы войдете в свое приложение GitHub в другом рабочем пространстве, упоминания перестанут работать в предыдущем рабочем пространстве.
Ниже приведены сценарии, в которых вы будете упомянуты:
- Вам назначена задача.
- Ваш отзыв запрашивается в запросе на вытягивание.
- Вы упоминаетесь в запросе на вытягивание, описании проблемы, комментарии или обсуждении.
- Ваш отзыв запрашивается по развертыванию.
- Вы получаете запланированное напоминание о запросе на проверку по запросу.
Вы можете увидеть сводку ваших упоминаний 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.
Дополнительные материалы
-
[AUTOTITLE](/integrations/how-tos/slack/customize-notifications) — узнайте, как настроить уведомления GitHub в Slack в соответствии с вашими потребностями. -
[AUTOTITLE](/integrations/tutorials/slack) - Развитие навыков и знаний об интеграции GitHub Slack с помощью примеров и практических действий.