Jenkins Multibranch pipeline не может найти Jenkinsfile в подпапке

Содержание

Вопрос или проблема
Ответ или решение
Проблема с нахождением Jenkinsfile в подпапке в Jenkins Multibranch Pipeline
Описание проблемы
Возможные причины и решения
Заключение

Вопрос или проблема

Я использую многопоточную сборку Jenkins — конкретно, папку организации, которая следит за всеми моими репозиториями Bitbucket и создает сборку для любого репозитория, содержащего Jenkinsfile. Для упрощения я настроил его так, чтобы он смотрел только на один из моих репозиторов на данный момент.

Вот в чем моя проблема:

Когда Jenkinsfile находится в корневой папке моего репозитория, все работает нормально — Jenkins видит Jenkinsfile и создает сборку, как это определено в этом Jenkinsfile.

репозиторий
|
|___> Jenkinsfile

Скриншот: Jenkins настроен на поиск Jenkinsfile в корневой папке

Как вы можете видеть, Jenkins находит его без проблем:
Скриншот: Jenkins находит Jenkinsfile в корневой папке

Однако я хочу переместить Jenkinsfile в подпапку в своем репозитории (давая мне гибкость для определения нескольких сборок для одного репозитория).
Когда я перемещаю его в подпапку (jenkins/ci-pipeline/Jenkinsfile), даже несмотря на то, что я явно указываю этот относительный путь к файлу Jenkins, он больше не может найти Jenkinsfile!!

репозиторий
|
|___> jenkins
       |
       |___> ci-pipeline
              |
              |___> Jenkinsfile

Скриншот: Jenkins настроен на поиск Jenkinsfile в подпапке

Как вы можете видеть, несмотря на указание относительного пути к файлу (jenkins/ci-pipeline/Jenkinsfile) Jenkins утверждает, что он больше не может найти Jenkinsfile:
Скриншот: Jenkins не может найти Jenkinsfile в подпапке

Кстати, хотя в описании этого поля Jenkins говорится, что это “относительное местоположение”, я попробовал указать абсолютный путь к файлу (${WORKSPACE}/jenkins/ci-pipeline/Jenkinsfile), чтобы увидеть, сработает ли это:
Скриншот: Jenkins настроен с абсолютным путем к подпапке

К сожалению, это тоже не сработало — также Jenkins не развернул свою переменную окружения WORKSPACE:
Скриншот: Jenkins не может найти Jenkinsfile в подпапке, даже с абсолютным путем

Я также зашел на узел рабочего Jenkins и подтвердил, что Jenkinsfile присутствует в этой подпапке, в рабочем пространстве Jenkins для моего репозитория.

Может кто-нибудь сказать мне, что я делаю не так??
Это кажется очень простым, но оно просто отказывается работать, и это сводит меня с ума!

Причиной этого, по-видимому, является то, что у меня устаревшая версия плагина Bitbucket Branch Source (2.2.9).

Для получения дополнительных сведений смотрите https://stackoverflow.com/a/57791004/5505583

Ответ или решение

Проблема с нахождением Jenkinsfile в подпапке в Jenkins Multibranch Pipeline

Если вы столкнулись с проблемой, когда Jenkins Multibranch Pipeline не может найти Jenkinsfile, расположенный в подпапке вашего репозитория Bitbucket, не переживайте, вы не одиноки. В этом ответе мы рассмотрим возможные причины этой проблемы и предложим решения, основываясь на вашем описании ситуации.

Описание проблемы

Ваша конфигурация Jenkins Multibranch Pipeline работает корректно, когда Jenkinsfile находится в корневой папке репозитория. Однако, когда вы перемещаете Jenkinsfile в подпапку (jenkins/ci-pipeline/Jenkinsfile), Jenkins не может его найти, даже если вы явно указываете относительный путь (jenkins/ci-pipeline/Jenkinsfile) в настройках.

Возможные причины и решения

Конфигурация Multibranch Pipeline:
- Убедитесь, что вы правильно настроили ваш Multibranch Pipeline. В настройках вашего Jenkinsfile необходимо указать путь к Jenkinsfile, находящемуся в подпапке. Для этого в разделе "Pipeline" укажите значение поля "Script Path" как jenkins/ci-pipeline/Jenkinsfile.
Версия плагина:
- Проблема, с которой вы столкнулись, может быть связана с устаревшей версией плагина Bitbucket Branch Source Plugin. Вы используете версию 2.2.9, которая может иметь баги, влияющие на работу с файлами в подпапках. Рекомендуется обновить этот плагин до последней версии. Это может решить множество проблем, связанных с совместимостью и функциональностью.
Проблемы с кэшированием:
- В некоторых случаях Jenkins может кэшировать информацию о репозиториях. Попробуйте выполнить "Scan Multibranch Pipeline Now", чтобы обновить информацию о ветках и Jenkinsfile.
Ошибки в путях:
- Убедитесь, что вы используете правильный путь к Jenkinsfile. Простой опечатки может быть достаточно, чтобы Jenkins не смог найти файл. Проверьте регистр букв в пути, так как некоторые файловые системы чувствительны к регистру.
Логирование и отладка:
- Проверьте консольные логи в Jenkins на наличие дополнительных сообщений об ошибках. Это может дать вам подсказку о том, почему не удается найти Jenkinsfile. Если не удается найти конкретную причину, попробуйте добавить дополнительные шаги отладки в ваш pipeline, чтобы понять, на каком этапе происходит сбой.
Файловая структура:
- Убедитесь, что структура вашего репозитория правильно организована. Не должно быть скрытых файлов или проблем с правами доступа к файлам. Иногда права доступа могут препятствовать Jenkins в чтении Jenkinsfile.

Заключение

Вышеуказанные шаги помогут вам определить и устранить проблему с нахождением Jenkinsfile в подпапке в Jenkins Multibranch Pipeline. Наиболее критичным моментом является использование актуальных версий плагинов и правильная настройка путей. Рекомендуется проводить регулярные обновления Jenkins и его плагинов для минимизации подобных проблем.

Если после выполнения всех рекомендаций проблема остается актуальной, рассмотрите возможность поиска решения на форумах или в официальной документации Jenkins.