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

Обзор

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

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

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

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

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

экран добавления приложения с помощью меню настройки

Как настроить конфигурацию в Asana:

  1. Откройте проект Asana, в который хотите установить интеграцию Asana для GitHub. Раскройте выпадающее меню Настроить в правом верхнем углу.
  2. Прокрутите до пункта Приложения и выберите + Добавить приложение.

приложение 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 в каждой задаче связанного проекта.

Поле Github в задаче

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

Ссылка на заявку Github на внесение изменений

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

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

Описание заявки 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 прикрепит заявку на внесение изменений к задаче проекта, в котором интеграция не активирована?
    • В разделе комментариев к задаче будет доступно вложение со ссылкой на заявку на внесение изменений, но сам виджет, синхронизирующий статус заявки, не появится.

К сожалению, этот браузер не поддерживается

Asana не работает в вашем текущем интернет-браузере. Зарегистрируйтесь из одного из этих поддерживаемых браузеров.

Выберите язык

При выборе другого языка меняется язык интерфейса и/или содержимого сайта asana.com