SPb Jenkins Meetup #7. О тестировании плагинов Jenkins в ci.jenkins.io

О тестировании плагинов Jenkins в ci.jenkins.io Олег Ненашев CloudBees, Inc.
St. Petersburg Jenkins Meetup 25 июля 2017

© 2017 CloudBees, Inc. All Rights Reserved. 2 @oleg_nenashev, @jenkins_spb
Обо мне @oleg_nenashev oleg-nenashev

Oleg’s “Hall of Shame”(c) • Jenkins Core • Windows Service Wrapper • Плагины • Remoting

üКАК ПОСТРОЕНО ТЕСТИРОВАНИЕ ПЛАГИНОВ? üCI В ПРОЕКТЕ JENKINS üКАК МЫ ИСПОЛЬЗУЕМ PIPELINE? üДЕМО О чём доклад?

Плагины в Jenkins >1400 <100 >1200 Поддерживается “core team”

• Экосистема построена на Maven • Много интеграций • Maven Project Plugin L - интерсепторы, Remoting, …

Сборка плагина – это просто •mvn clean verify •mvn clean package •mvn release:prepare release:perform

Parent POM? •До 1.642 – часть ядра •После – Plugin POM 2.x •https://github.com/jenkinsci/plugin-pom/ •Независимость от версий ядра и Java

Сборка в Maven Запуск по-умолчанию: • junit, findbugs • maven-enforcer, animal-sniffer, • javadoc-lint • nodejs-lint, nodejs test Через профиль: • jacoco Больше – в плагинах Plugin POM

Unit-тесты Тулы Jenkins Test Harness • Тесты в проекта • JUnit 3 / 4 • Junit не так прост: • JenkinsRule • @TestExtension • HtmlUnit • DockerRule (home-made) https://github.com/jenkinsci/jenkins-test-harness

https://github.com/jenkinsci/ssh-slaves-plugin/ https://github.com/jenkinsci/ownership-plugin/

Unit-тесты Тулы Jenkins Test Harness Acceptance Test Harness • Selenium • Cucumber • Docker • … https://github.com/jenkinsci/acceptance-test-harness

Unit-тесты Тулы Jenkins Test Harness Acceptance Test Harness https://github.com/jenkinsci/plugin-compat-tester Plugin Compat Tester • Матрицы совместимости ядра и плагинов

Наш CI...

Наш CI... • Для плагинов запускаем только JTH • ATH
и PCT занимают дни – только для релиз-кандидатов ядра L

node() { git checkout URL sh “mvn clean package verify” } Как протестировать плагин?

•Нет хостинга Jenkins для open-source •Можно собирать плагины на Travis, да… •Требуется много ресурсов Где протестировать плагин?

Было • CloudBees DEV@Cloud • https://jenkins.ci.cloudbees.com/ • CI для плагинов и ядра • Freestyle Project • Maven Plugin • Не полный open-source • CloudBees Templates Plugin – сотни похожих репозиториев • CI для инфраструктуры проекта Jenkins • Разрозненные инстансы • Полностью open-source

Становится • CloudBees DEV@Cloud • https://jenkins.ci.cloudbees.com/ • CI для плагинов и ядра • Freestyle Project • Maven Plugin • Не полный open-source • CloudBees Templates Plugin – сотни похожих репозиториев • CI для инфраструктуры проекта Jenkins • Разрозненные инстансы • Полностью open-source

Что изменилось? • Спонсорская инфраструктура • На порядок больше ресурсов Jenkins Pipeline • Библиотеки • GitHub Organization Folder

Было • CloudBees DEV@Cloud • https://jenkins.ci.cloudbees.com/ • CI для плагинов и ядра • Freestyle Project • Maven Plugin • Не полный open-source • CloudBees Templates Plugin – сотни похожих репозиториев • Хостинг для модулей проекта: • https://ci.jenkins.io/ • Полностью open-source • Jenkins Pipeline • Больше ресурсов для CI: • Linux/Windows • Docker

Наши Jenkinsfile https://github.com/jenkins-infra/pipeline-library/

Что мы собираем? Минимально совместимое ядро Последний LTS Последний Weekly Ядро: ОС: Linux (Docker) Windows Java: Java 8 Java 7 По-умолчанию Opt-in Source Compatibility не гарантирована – ByteCode Transformer, etc.

buildPlugin()

buildPlugin(). Как это работает?

Pipeline Shared Libraries • Библиотеки находятся в SCM • Версионирование • Области видимости ▸System-wide ▸Folder ▸Job

Библиотеки в Scripted Pipeline com.mycorp.libs.make Jenkinsfile buildPlugin() buildPlugin() – глобальная переменная Utility - классы com.mycorp.libs.coverity com.mycorp.libs.cppunit Глобальная библиотека

Объявление Библиотеки [1/2]

Объявление Библиотеки [2/2]

buildPlugin(). Как это работает? … Чистый Pipeline DSL

Как разрабатывать свои библиотеки?

Pipeline. Средства Разработки IDE Integration Unit Test Framework Static Analysis Library manager Debug tools Documen- tation Easy script deployment Freestyle => Pipeline Converter Good Not enough Missing

Как я работаю? Intellij IDEA Filesystem SCM Plugin (alpha) • Syntax file • Документация Тестовый Jenkins Source Code (local .git repos) • Configuration-as-Code • “Почти как Production” • Свои настройки библиотек • Репозитории с библиотеками • Jenkinsfile

Файл Синтаксиса https://st-g.de/2016/08/jenkins- pipeline-autocompletion-in-intellij

Filesystem SCM Plugin (1.21-alpha-1) • Версия доступна в экспериментальном Update Center Объявление библиотеки в SCM !!!

Тестирование • Нет официального тестового фреймворка • https://github.com/lesfurets/JenkinsPipelineUnit • Подробности и демо – в докладе Станислава “mvn verify” был вызван… И вызов успешен… Для Jenkinsfile…

https://hub.docker.com/r/onenashev/ demo-jenkins-config-as-code/

Итого • Pipeline значительно упрощает разработку и поддержку системы • Шаблонизация • Библиотеки • Organization Folders • Не обязательно строить сложные Pipeline для “простых” задач • Не хватает средств разработки

Ссылки • CI: https://ci.jenkins.io/ • Тулы: • Parent POM: https://github.com/jenkinsci/plugin-pom/ • Pipeline Lib: https://github.com/jenkins-infra/pipeline-library/ • Демо: • https://hub.docker.com/r/onenashev/demo-jenkins-config-as-code/ • https://github.com/oleg-nenashev/demo-jenkins-config-as-code

Спасибо! Контакты: E-mail: [email protected] GitHub: oleg-nenashev Twitter: @oleg_nenashev

Software at the speed of ideas СПАСИБО! www.cloudbees.com

SPb Jenkins Meetup #7. О тестировании плагинов ...

SPb Jenkins Meetup #7. О тестировании плагинов Jenkins в ci.jenkins.io

More Decks by Oleg Nenashev

Other Decks in Programming

Featured

Transcript