Я согласен, эта проблема сложна, потому что Дженкинс и его плагины сильно изменились за эти годы.Позвольте мне рассказать вам, как я выполнил то, что вы просите.Я опубликую все номера своих версий (в основном, в актуальном состоянии).
Jenkins Версия: 2.176.1 (java -jar /usr/share/jenkins/jenkins.war --version)
Плагины
- github 1.29.4
- github-api 1.9
- github-branch-source 2.5.3
- github-pullrequest 0.2.5
- pipe-github-lib 1.0
Также я использую интерфейс Blue Ocean, который может влиять на вещи (кто знает)
- blueocean 1.17.0
- blueocean-git-pipe 1.17.0
- blueocean-github-pipe 1.17.0
Github Webhooks
Прежде всего, настройте webhooks для вашей системы. Это хорошее руководство для Github Webhooks Перейдите в свой репозиторий Github и нажмите на вкладку Настройки.Затем выберите «Webhooks» в левом меню:
URL-адрес моей настройки Jenkins: https://jenkinsci.dorian.com. Итак, в поле «Payload URL» я поставил https://jenkinsci.dorian.com/github-webhook/
Я оставил настройки как «application / json» и «send me everything» и «active»
В разделе Webhooks есть удобный раздел «Недавние поставки», который может показать вам, делают ли ваши веб-зацепки дженерики.Сначала у меня был неправильный URL, поэтому у меня рядом с ними красные крестики.Теперь все они отмечены зелеными галочками.
Github Access Token
Многие руководства предполагают, что вы предоставляете Jenkins персональный токен доступа для связи с вашим репо.Для этого перейдите к аватару своей учетной записи в правом верхнем углу и выберите «Настройки» -> «Настройки разработчика» -> «Токены личного доступа» -> «Создать токен»
. Поместите в описание все, что хотите.В разделе «Выбор областей действия», если вы хотите, чтобы он работал, установите все флажки в списке.
Я выбрал:
- репо: статус
- запись: repo_hook
- чтение: repo_hook
- admin: org_hook
Нажмите «Сохранить», и вам будет показан ваш секретный ключ.Скопируйте это куда-нибудь в безопасное место (мы будем использовать его в ближайшее время).
Настройка Jenkins
Теперь о сложной части.Попробуйте установить все перечисленные выше плагины.
Перейдите в Jenkins-Manage Jenkins-> Настроить систему
Найдите раздел Github и нажмите Добавить сервер Github
В разделе «Учетные данные» нажмите «Добавить»."Вы попадете в меню.Выберите «Секретный текст»
- Область действия: глобальная
- Секрет: вставьте свой токен доступа с более раннего
- ID: (я оставил это поле пустым)
- Описание: DorianGithubCreds
Хит сохранить.Затем выберите DorianGithubCreds из списка учетных данных.
Чтобы проверить, нажмите «Проверить подключение».Mine возвращает «Учетные данные, подтвержденные для пользователя dnrahamim», ограничение скорости: 4998
Теперь перейдите к Github Pull Request Builder
- URL-адрес API сервера GitHub: https://api.github.com
- Переопределение URL Jenkins: (пусто)
- Общий секретный ключ: (пусто)
- Учетные данные: DorianGithubCreds
- Автоматическое управление веб-заданиями: true
- Все остальное пусто
Настроить задание
Перейти к заданию, которое должно создавать ваше хранилище Выберите «Настроить» в левом меню
В разделе Projects-> Github Organization
- Учетные данные: DorianGithubCreds
- Владелец: Dorian
- Поведения:
- Открытие филиалов
- Стратегия: исключить ветви, которые также представлены как PR
- Обнаружение запросов извлечения из источника
- Стратегия: объединение запроса извлечения с текущей ревизией целевой ветви
- Обнаружение пул-запросов от вилок
- Стратегия: объединение запроса извлечения с текущей версией целевой ветки
- Доверие: от пользователей с правами администратора или записи
- Распознаватели проектов
- Конвейер Jenkinsfile
- Путь: Jenkinsfile (мой Jenkinsfile находится в корне проекта)
- Стратегии сборки: (намеренно пусто)
Уведомления
Теперь, когда я делаю запрос на извлечение или всякий раз, когда я публикую изменения в запросе на извлечение, Дженкинс запускает для этого новую сборку.branch.
Сам запрос на извлечение в Github также перечисляет свои «проверки состояния» внизу.Когда сборка находится в состоянии ожидания, проверка состояния желтая.Если это удастся, он получает зеленую галочку.Если это не удается, он получает красный X.
У меня изначально была проблема, потому что у меня был старый ящик Jenkins, который также был настроен для управления веб-хитов Github и создания запросов на извлечение.Его сборки терпели неудачу, поэтому его уведомления были теми, что поступали на мой запрос на извлечение.Я исправил эту проблему, запретив этой старой коробке Дженкинса строить мои новые ветви.Как только старая коробка Дженкинса перестала строить, уведомления из новой коробки Дженкинса добрались до Github.
Завершение
Вот и все!Это все, что я намеренно настроил.Пожалуйста, попробуйте мою конфигурацию и посмотрите, работает ли она для вас.Дайте мне знать, если я что-то пропустил.
Сложная часть настройки Jenkins с Github заключается в том, что, хотя существует много руководств, предложения часто конфликтуют друг с другом, и очень многие устарели (иногда даже официальны).документация устарела).
Тем не менее, вот некоторые ресурсы:
- Это хорошее руководство для Github Webhooks
- Технический документ Github по CI с Дженкинсом (он не дает подробных объяснений, но дает хороший обзор)
- Плагин GitHB для создания запросов на извлечение Github
- Полуофициальный пост SO для отображения статуса сборки на репозитории Github