GitHub и Asana | Руководство по продукту

Обзор

С помощью интеграции Asana для GitHub можно автоматически синхронизировать обновления статуса запросов Github на внесение изменений в задачи Asana, чтобы улучшать взаимодействие между разными командами.

Эта интеграция помогает повышать чёткость и прозрачность инженерной работы между техническими и нетехническими отделами. С помощью этой новой интеграции разработчики могут беспрепятственно общаться через Asana, чтобы держать в курсе различные отделы и заинтересованных лиц из других подразделений, не упуская ни одной мелочи.

Интеграция Asana для GitHub доступна всем пользователям версий Premium, Business и Enterprise.

Установка для Asana и действий GitHub

Подключите Asana к GitHub, чтобы синхронизировать статусы запросов на внесение изменений. Для использования интеграции необходимо настроить конфигурацию в Asana, а для дополнительных функций — и в GitHub.

• Выберите GitHub, нажав + Добавить в проект.
• Авторизуйте свою учётную запись GitHub, следуя инструкциям.
• Интеграция GitHub + Asana будет установлена на уровне проекта.

Поздравляем — теперь можно подключить запросы GitHub на внесение изменений к задачам Asana. Если вы хотите подключить дополнительный функционал к этой интеграции, обратитесь к следующему разделу руководства. В противном случае сразу переходите к разделу Основные функции.

Как выполнить настройку действий GitHub:

Этот раздел предполагает наличие у вас базовых навыков работы с секретами репозиториев git и GitHub. Если у вас нет доступа к настройкам секретов репозитория, обратитесь к его владельцу.

Мы поддерживаем два вида действий GitHub:

1. Автоматизация в Asana уведомлений о заявках GitHub на внесение изменений: это действие оставляет в задаче Asana комментарий с указанием статуса заявки на внесение изменений. Оно включается в себя заголовок заявки со ссылкой на связанную задачу Asana. Для настройки этого действия посетите страницу действий GitHub.
2. Подключение к Asana вложений из описаний заявок GitHub на внесение изменений: это действие автоматически подключает заявки GitHub на внесение изменений к задаче (задачам) Asana путём добавления URL задач(и) Asana в описание заявки. Для настройки этого действия посетите страницу действий GitHub.

Как и в случае с другими действиям GitHub, они будут выполняться только при возникновении события в репозитории, для которого вы настроили эти действия. Например, можно настроить действие, которое будет выполняться каждый раз, когда кто-то объединяет или комментирует заявку на внесение изменений.

Каждое из указанных действий GitHub необходимо настраивать по отдельности за исключением случаев, когда в одном репозитории выполняется несколько одинаковых действий. Например, можно настроить одно действие, которое будет комментировать задачу в описании заявки на внесение изменений по завершении тестирования, и другое действие, которое будет добавлять другой комментарий к задаче при объединении заявки на внесение изменений.

Действия GitHub также можно добавлять в состав существующего рабочего процесса. За дополнительными сведениями обращайтесь к руководству по действиям GitHub.

Отзыв секретных токенов

Если вы настроили действия Github в предыдущем разделе, можно отозвать секретные токены. Для этого перейдите на эту страницу настройки и выберите Отозвать все (Revoke all).

Это приведёт к отзыву всех существующих секретных токенов действий GitHub.

Вы по-прежнему будете видеть информацию о заявках на внесение изменений в существующих проектах Asana, в которые вы добавили эту интеграцию.

Основные функции

Как прикрепить заявку на внесение изменений к задаче Asana (в Asana):

После установки интеграции GitHub в Asana вы будете видеть поле GitHub в каждой задаче связанного проекта.

Чтобы прикрепить заявку на внесение изменений к задаче Asana, получите URL заявки и вставьте его в пустое поле GitHub. Теперь в задаче Asana должен появиться виджет со следующими сведениями: статус проверки, состояние сборки, PR-статус, изменения строк и счётчик беседы в GitHub.

Как прикрепить заявку на внесение изменений к задаче Asana (в GitHub):

После установки интеграции GitHub в Asana и настройки действий GitHub можно будет автоматически прикреплять заявки на внесение изменений к задачам Asana через описание заявки в GitHub.

Получите URL задачи Asana и вставьте его в описание заявки GitHub на внесение изменений. Теперь при просмотре задачи в Asana должен появиться виджет со следующими сведениями: статус проверки, состояние сборки, PR-статус и изменения строк.

Все ошибки должны отображаться на вкладке действий GitHub в GitHub.

Как получать объединение заявок на внесение изменений и закрывать обновления:

Заявки на внесение изменений можно закрывать в GitHub после того, как соответствующие отделы проверят и объединят изменения. При этом статус в виджете Asana обновится автоматически.

Если вы хотите прикрепить новую заявку GitHub на внесение изменений, можно добавить URL задачи Asana в описание этой заявки на GitHub, и виджет поменяется автоматически. Также можно удалить закрытую заявку из Asana через меню в правом верхнем углу. После удаления вы можете ввести новый URL заявки GitGub на внесение изменений.

После установки интеграции GitHub в Asana и настройки действий GitHub вы будете получать комментарии к задачам Asana через прикреплённую открытую заявку на внесение изменений. В неё также будут включаться обновления по поводу объединения или закрытия заявки.

Вопросы и ответы

• Можно ли использовать один и тот же сгенерированный секрет в нескольких репозиториях?
  • Да
• Смогут ли мои коллеги видеть информацию о заявках на внесение изменений, которые я прикрепил(а) к задаче Asana, даже если у них нет доступа к самой заявке?
  • Да. При прикреплении заявки на внесение изменений к задаче информацию из виджета будут видеть все просматривающие эту задачу.
• Отключается ли мой старый секретный токен при генерации нового?
  • Нет, ваш старый секретный токен по-прежнему будет работать. Если вы хотите отключить свои текущие секретные токены, это можно сделать здесь.
• Можно ли использовать один и тот же сгенерированный секрет в нескольких репозиториях?
  • Да
• При попытке отправить файл рабочего процесса «git» говорит, что у моего токена нет доступа к созданию рабочих процессов. Что делать?
  • Если вы используете двухфакторную аутентификацию и взаимодействуете с GitHub через командную строку, GitHub требует использовать личный токен доступа в качестве пароля. Просим вас создать новый личный токен доступа к GitHub с поддержкой рабочего процесса.
• Зачем мы запрашиваем эти разрешения GitHub?
  • В рамках этой интеграции мы производим только чтение и запись данных из заявок на внесение изменений. Разрешение на странице аутентификации — это самое строгое разрешение, которое GitHub позволяет нам запрашивать для доступа к заявкам.
• Что произойдёт, если действие GitHub прикрепит заявку на внесение изменений к задаче проекта, в котором интеграция не активирована?
  • В разделе комментариев к задаче будет доступно вложение со ссылкой на заявку на внесение изменений, но сам виджет, синхронизирующий статус заявки, не появится.