Связываем Jira и GitHub через Codex CLI

Урок 161 из 299 курса «OpenAI Cookbook»: официальный курс OpenAI Academy (ОпенАИ) на русском языке. Урок входит в платный доступ; первые уроки курса бесплатно.

О чём урок

Это руководство предлагает практический, пошаговый подход к автоматизации рабочего процесса между Jira и GitHub. Помечая задачу Jira меткой, вы запускаете сквозной процесс, который создает GitHub pull request, поддерживает обе системы в актуальном состоянии и оптимизирует проверку кода, все это с минимальными ручными усилиями. Автоматизация осуществляется агентом codex-cli, работающим в рамках GitHub Action. Поток выглядит следующим образом: Пометьте задачу Jira Автоматизация Jira вызывает GitHub Action Action запускает codex-cli для реализации изменения Открывается PR Jira переводится в другое состояние и аннотируется, создавая аккуратный цикл без единого клика. Это включает изменение статуса тикета, добавление ссылки на PR и комментирование тикета с обновлениями. Jira: права администратора проекта + возможность создавать правила автоматизации GitHub: доступ на запись, разрешение на добавление секретов репозитория и защищенная ветка main Ключи API и секреты, размещенные в качестве секретов репозитория: OPENAI_API_KEY – ваш ключ OpenAI для codex-cli JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN – для REST-вызовов из action codex-cli, установленный локально (pnpm add -g @openai/codex) для оперативного тестирования Репозиторий, содержащий папку .github/workflows/ Первый шаг в этом правиле отслеживает изменения меток задачи. Это гарантирует, что автоматизация будет запускаться только при добавлении или изменении метки — нет необходимости обрабатывать каждое обновление задачи. Далее мы проверяем, содержат ли обновленные метки определенное ключевое слово; в нашем примере мы используем aswe. Это служит фильтром, чтобы только задачи, явно помеченные для автоматизации, продолжали выполнение, избегая ненужного шума от несвязанных обновлений. Если условие выполняется, мы отправляем POST запрос на workflow_dispatch endpoint GitHub. Это запускает рабочий процесс GitHub Actions с соответствующим контекстом задачи. Мы передаем ключ задачи, краткое описание и очищенную версию описания — экранируя кавычки и символы новой строки, чтобы полезная нагрузка корректно парсилась в YAML/JSON. В JIRA доступны дополнительные поля в качестве переменных, чтобы предоставить агенту codex больше контекста во время его выполнения.

План урока

  1. Назначение этого руководства
  2. Предварительные требования
  3. Создание правила автоматизации Jira
  4. Добавление GitHub Action
  5. Ключевые шаги рабочего процесса
  6. Пометка задачи
  7. Сквозной рабочий процесс
  8. Просмотр и слияние PR

Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.

Полезные гиды