Как связать Trello и GitHub, чтобы не терять задачи между досками и репозиториями

Если вы ведёте разработку в Trello, а код лежит в GitHub, наверняка знакомы с ситуацией: карточка висит в «В работе», а пулл-реквест уже смержен. Или наоборот — разработчик запушил ветку, но никто не перенёс карточку. Интеграция Trello и GitHub решает именно эту проблему — автоматически связывает коммиты, PR и ветки с карточками, и статус виден без ручного обновления.

Что даёт интеграция на практике

После правильной настройки вы получаете:

• Автоматическое перемещение карточки при создании PR или мерже.
• Видимость, кто что делает, прямо из Trello — без перехода в GitHub.
• Коммиты и ссылки на ветки прямо в карточке.
• Общий прогресс команды и разработчикам, и менеджерам.

Это не магия, а буквально пара минут настройки. Дальше — по шагам.

Способ 1: Официальная интеграция Trello и GitHub (Power-Up)

Это самый простой и стабильный путь. Встроенный Power-Up работает без сторонних сервисов и настраивается прямо в интерфейсе Trello.

Пошаговая настройка

1. Откройте доску в Trello и нажмите «Power-Ups» в верхнем меню.
2. Найдите «GitHub» и нажмите «Добавить».
3. Нажмите «Настройки» (шестерёнка рядом с Power-Up) и выберите «Авторизовать аккаунт».
4. Предоставьте Trello доступ к нужным репозиториям или организации на GitHub.
5. После авторизации привяжите конкретные репозитории к доске — в настройках Power-Up нажмите «Привязать репозиторий» и выберите нужный.

После этого в каждой карточке появится кнопка «GitHub» — там можно привязать ветку, PR или коммит к этой карточке.

Как привязывать к карточке

Откройте карточку, нажмите кнопку GitHub в боковой панели и выберите один из вариантов:

• Привязать ветку — введите название ветки, и она привяжется к карточке. Все коммиты в этой ветке автоматически появятся в карточке.
• Привязать pull request — выберите существующий PR из списка.
• Привязать коммит — введите хеш коммита, если нужно привязать конкретный.

Когда вы создаёте ветку через Trello (кнопка «Создать ветку»), она автоматически привязывается к карточке — это удобнее, чем вручную вводить название.

Автоматическое перемещение карточек

Это та самая функция, ради которой всё и затевается. Настраивается в правилах Power-Up:

1. Зайдите в настройки GitHub Power-Up на доске.
2. Найдите раздел «Правила автоматизации».
3. Добавьте правило, например: «Когда pull request открыт → переместить карточку в список «Review»».
4. Добавьте ещё одно: «Когда pull request смержен → переместить в «Done»».

Можно настроить несколько правил под ваш рабочий процесс. Главное — проверьте, что названия списков в правилах точно совпадают с названиями на вашей доске, иначе автоматизация не сработает.

Способ 2: GitHub Actions + Trello API

Подходит, если официального Power-Up недостаточно — например, нужно кастомное поведение или интеграция с несколькими досками одновременно.

Идея простая: при событии в GitHub (push, PR, merge) запускается GitHub Action, который через Trello API обновляет карточку.

Что понадобится

• Trello API Key — получить можно на trello.com/power-ups/admin (нужен аккаунт Trello).
• Trello Token — генерируется там же, после авторизации.
• ID карточки Trello или списка — можно посмотреть в URL карточки или через API.

Пример workflow

Создайте файл .github/workflows/trello-move.yml в репозитории:

name: Move Trello card on PR merge

on:
  pull_request:
    types: [closed]

jobs:
  move-card:
    if: github.event.pull_request.merged == true
    runs-on: ubuntu-latest
    steps:
      - name: Move Trello card
        run: |
          curl -X PUT "https://api.trello.com/1/cards/secrets.TRELLO_CARD_ID /idList?value={{ secrets.TRELLO_DONE_LIST_ID }}&key=secrets.TRELLO_API_KEY &token={{ secrets.TRELLO_TOKEN }}"

Здесь используются секреты репозитория — добавьте их в Settings → Secrets:

• TRELLO_API_KEY
• TRELLO_TOKEN
• TRELLO_CARD_ID — конкретная карточка, если она заранее известна.
• TRELLO_DONE_LIST_ID — список «Done» на доске.

Минус этого подхода — нужно как-то передавать ID карточки в workflow. Самый простой способ — указывать номер карточки в названии ветки или в описании PR, а в workflow добавить скрипт, который по номеру находит нужную карточку через Trello API.

Способ 3: Сторонние сервисы (Zapier, Make, IFTTT)

Если не хотите писать код, но официальный Power-Up не покрывает все сценарии — можно использовать платформы автоматизации.

Когда это удобно

• Нужно связать GitHub не только с Trello, но и с другими инструментами (Slack, Google Sheets, Telegram).
• Требуется сложная логика с условиями и ветвлением.
• Команда уже использует Zapier или Make для других задач.

Пример: перемещение карточки через Zapier

1. Создайте Zap: триггер — «Pull Request merged» в GitHub.
2. Добавьте действие — «Move Card to List» в Trello.
3. Настройте соответствие: какой репозиторий → какая доска → какой список.
4. Активируйте Zap.

У Make (бывший Integromat) больше возможностей для сложных сценариев — можно добавить фильтры, циклы, обработку ошибок. Но для простого перемещения карточек Zapier вполне достаточно.

Сравнение способов

Критерий	Power-Up	GitHub Actions	Zapier / Make
Настройка	5 минут	30–60 минут	15–30 минут
Нужен код	Нет	Да	Нет
Гибкость	Средняя	Высокая	Высокая
Стоимость	Бесплатно	Бесплатно	Есть платные тарифы
Надёжность	Высокая (официальный)	Зависит от реализации	Зависит от сервиса
Подходит для	Команд до 10–15 человек	Кастомных сценариев	Сложных цепочек автоматизации

Что выбрать под вашу ситуацию

Маленькая команда, один-два репозитория, стандартный процесс — включайте официальный Power-Up. Это займёт пару минут и будет работать стабильно. Настройте правила автоматизации для перемещения карточек при открытии и мерже PR — этого достаточно в 80% случаев.

Нужна кастомная логика или интеграция с несколькими досками — пишите GitHub Action. Придётся потратить время на настройку, зато полный контроль. Хороший вариант, если в команде есть кто-то, кто умеет работать с YAML и API.

Сложная автоматизация с кучей инструментов — Zapier или Make. Удобно, если уже используете эти платформы. Но учтите: бесплатные тарифы имеют лимиты на количество операций, и при активной разработке лимит может закончиться быстро.

Частые ошибки при настройке

Не совпадают названия списков. Правило автоматизации ссылается на список «In Review», а на доске он называется «На проверке». Карточка не переместится, и вы решите, что интеграция не работает. Проверяйте точное написание, включая регистр и пробелы.

Привязываете ветку, но не видите коммитов в карточке. Коммиты появляются только если они сделаны после привязки ветки. Старые коммиты не подтянуты автоматически — это нормальное поведение.

Забыли про права доступа. Если аккаунт, которым авторизовали Power-Up, не имеет доступа к репозиторию или доске — ничего не заработает. Проверьте, что у аккаунта есть права минимум на чтение в GitHub и на запись в Trello.

Слишком много правил автоматизации. Если настроить перемещение карточки на каждое событие, доска превратится в хаос. Карточки будут прыгать между списками без ведома команды. Ограничьтесь ключевыми событиями: открыт PR → Review, смержен PR → Done.

Практические рекомендации

• Используйте единые соглашения по именованию веток. Например, TRELLO-123-add-auth. Так легко найти нужную карточку и вручную, и автоматически.
• Добавляйте номер карточки в описание PR. Это помогает и людям понять контекст, и автоматическим скриптам — связать PR с карточкой.
• Не дублируйте статусы. Если Trello показывает, что задача в Review, не нужно дополнительно ставить статус в GitHub — это создаёт путаницу. Выберите один источник истины.
• Проверяйте интеграцию после настройки. Создайте тестовую карточку, привяжите ветку, сделайте коммит, откройте PR, смерджьте — и убедитесь, что карточка прошла весь путь по доске.
• Ограничьте количество привязанных репозиториев. Если привязать все репозитории организации к одной доске, в карточках будет мусор из коммитов не относящихся задач. Привязывайте только нужные.

Как это выглядит в повседневной работе

Разработчик берёт карточку из списка «To Do», нажимает «Создать ветку» прямо в Trello — ветка автоматически привязывается. Работает, пушит, открывает PR. Карточка сама перемещается в «Review». Ревьюер смотрит код, ставит аппров, жмёт merge — карточка уходит в «Done». Менеджер открывает доску и видит актуальный статус без единого вопроса к команде.

Если кто-то из команды не разработчик — дизайнер, аналитик, тестировщик — он тоже видит прогресс по задаче прямо в Trello, не залезая в GitHub. Это и есть главная ценность интеграции: единое пространство, где все видят, на каком этапе задача.

Итог

Начните с официального GitHub Power-Up в Trello — это бесплатно, настраивается за пять минут и закрывает потребности большинства команд. Настройте два правила автоматизации: перемещение в Review при открытии PR и в Done при мерже. Если этого окажется мало — переходите к GitHub Actions для кастомной логики или к Zapier/Make для сложных цепочек.

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