VI
без тьмы нет света
Size: a a a
2019 November 22
NV
Ivan Cheban
Статья, в которой понятно рассказывают об автоматизации публикации документов с помощью Jenkins: https://3di-info.com/automate-documentation-publishing-jenkins/
В статье нет самого, по моему ощущению, интересного: когда запускается сборка и куда публикуется документация. Но похоже, что запускают вручную, а потом собранные файлы... непонятно, что потом с ними происходит. Только если сам Мэдкеп их выкладывает на какой-нибудь сервер.
Пока что у них вся автоматизация — это кнопка для запуска команды на конкретной машине. Впереди ещё долгий путь )
Пока что у них вся автоматизация — это кнопка для запуска команды на конкретной машине. Впереди ещё долгий путь )
IC
В самом мэдкепе есть планировщик запуска создания сборки
IC
Куда публикуется документация? Да куда укажешь в publishing destination. В моем случае: в SharePoint Online
IC
Собранные файлы в виде HTML5 на SP отображаются как сайт с документацией
NV
Ivan Cheban
В самом мэдкепе есть планировщик запуска создания сборки
Так, а зачем тогда Jenkins?
IC
Я сейчас изучаю этот вопрос, чтобы установить мэдкеп на сервере и создать джобу в Дженкинсе для запуска сборки и публикации по расписанию
IC
Чтобы не было привязки к конкретной машине (в данном случае моей)
IC
У нас мэдкеп проект привязан к гиту, чтобы все техрайтеры в команде (8 человек) могли выгружать туда свои изменения
IC
Дальше я вижу такой сценарий:
1. Создать в Дженкинске джобу на pull последних изменений с гита.
2. Создать джобу в Дженкинске для запука на сервере с установленным мэдкепом батч команды на создание сборки HTML5 и публикации ее в SharePoint в виде сайта с документацией.
3. (Опционально) Рассылка электронной почтой об успешной сборке и публикации команде техрайтеров.
1. Создать в Дженкинске джобу на pull последних изменений с гита.
2. Создать джобу в Дженкинске для запука на сервере с установленным мэдкепом батч команды на создание сборки HTML5 и публикации ее в SharePoint в виде сайта с документацией.
3. (Опционально) Рассылка электронной почтой об успешной сборке и публикации команде техрайтеров.
IC
Можно запускать джобы вручную или по графику автоматически
iv
гитлаб (если у вас гитлаб) может по пушу в репозиторий запускать джобу в дженкинсе
IC
У нас гитлаб
IC
Не уверен, что по каждому пушу нужно джобу запускать. Я за расписание
iv
это смотря сколько у вас пушей и как вообще разработка ведётся. можно настроить только на пуши в мастер или только на пуши с тегами
L
Ivan Cheban
У нас гитлаб
Можно гитлаб ci, он умеет по разным событиям (Пуш, тег, пуш в опр ветки),но нужно ранеры сконфигурировать
iv
Можно гитлаб ci, он умеет по разным событиям (Пуш, тег, пуш в опр ветки),но нужно ранеры сконфигурировать
да, но точно так же можно и с jenkins’ом связать
IC
Спасибо! Почитаю про это.
IC
То есть тогда и Дженкинс не нужен будет?
iv
если делать с gitlab ci, то дженкинс не нужен, но вам тогда надо разворачивать gitlab ci runner, и если у вас есть работающий jenkins, настройка gitlab ci с нуля выглядит излишне сложной штукой