Как да внедрите Atlassian Jira + Confluence в корпорациите. Технически въпроси

Планирате интегриране на софтуер от Atlassian (Jira, Confluence)? Искате ли да избегнете сериозни грешки в проектирането, които ще се наложи да решавате в последния момент?

Тогава сте на правилното място — разглеждаме внедряването на Atlassian Jira + Confluence в корпорацията с оглед на различни технически аспекти.
Здравейте, аз съм собственик на продукта в РСХБ и отговарям за развитието на Системата за управление на жизнения цикъл (СУЖЦ), изградена на софтуерните продукти на Atlassian Jira и Confluence.

В тази статия ще опиша техническите аспекти на изграждане на СУЖЦ. Статията ще бъде полезна за всички, които планират внедряване или се занимават с развитието на Atlassian Jira и Confluence в корпоративна среда. Статията не изисква специални знания и е насочена към начално запознаване с продуктите на Atlassian. Тя ще бъде полезна за администратори, собственици на продукт, ръководители на проекти, архитекти, всички, които планират внедряване на системи на базата на софтуера на Atlassian.

Въведение

В статията ще бъдат разгледани техническите въпроси около внедряването на Системата за управление на жизнения цикъл (СУЖЦ) в корпоративна среда. Нека първо определим какво означава това.

А какво означава корпоративно решение?

Това означава решение:

1. Мащабируемо. В случай на увеличение на натоварването, съществува техническа възможност за увеличаване на мощността на системата. Разделят се хоризонтално и вертикално мащабиране — при вертикалното мащабиране се увеличава мощността на сървърите, а при горизонталното мащабиране се увеличава броят на сървърите за работа на системата.
2. Отказоустойчиво. Системата ще остане достъпна при повреда на един от елементите. В общи линии за корпоративни системи не се изисква отказоустойчивост, но ние ще разгледаме именно такова решение. В нашата система се планират стотици конкурентни потребители и простои ще бъдат много критични.
3. Поддържано. Решението трябва да бъде поддържано от вендора. Софтуер без поддръжка следва да бъде заменян със собствени разработки или друг софтуер с поддръжка.
4. Инсталиране на Self-managed (On-premise). Self-managed — това е възможността да инсталирате софтуер не в облака, а на собствени сървъри. По-точно, това са всички варианти на инсталиране, които не са SaaS. В тази статия ще разгледаме само варианти на инсталация Self-managed.
5. Възможност за независима разработка и тестване. За да се организират предсказуеми промени в системата, са необходими отделни системи за разработка (за промени в самата система), тестова система (Staging) и продуктивна система за работа на потребителите.
6. Друго. Поддържа различни сценарии на удостоверяване, поддържа логове за одит, има настраиваема ролевата модел и т.н.

Това са основните елементи на корпоративни решения и, за съжаление, често се забравят при проектирането на системата.

Какво представлява Система за управление на жизнения цикъл (СУЖЦ)?

С две думи, в нашия случай това е Atlassian Jira и Atlassian Confluence — система, предоставяща инструменти за организиране на екипна работа. Системата не "налага" правила за организация на работа, а предоставя разнообразни инструменти за работа - както Scrum, така и Kanban дъски, водопадна модел, и мащабируемия Scrum и т.н.
Името СУЖЦ не е отраслов термин или общоприето понятие, това е просто название на системата в нашата банка. СУЖЦ за нас не е система за проследяване на бъгове, не е система за управление на инциденти и система за управление на промени.

Какво включва внедряването?

Внедряването на решение се състои от множество технически и организационни въпроси:

• Определяне на техническите мощности.
• Закупуване на софтуер.
• Създаване на екип за внедряване на решението.
• Инсталиране и конфигуриране на решението.
• Разработка на архитектурата на решението. Ролева модел.
• Разработка на експлоатационна документация, включително инструкции, регламенти, технически проект, наредби и т.н.
• Промяна на процесите в компанията.
• Създаване на екип за поддръжка. Разработка на SLA.
• Обучение на потребителите.
• Друго.

В тази статия ще разгледаме техническите аспекти на внедряването, без детайли за организационния компонент.

Характеристики на Atlassian

Компанията Atlassian е лидер в много сегменти:

• Gartner Magic Quadrant за инструменти за планиране на Agile за предприятия
  (Лидерството е предизвикано от успешната придобивка на AgileCraft с облачното му решение)
  
• Пазарен дял на глобалните инструменти за управление на жизнения цикъл на приложенията

Продуктите на компанията Atlassian притежават всичките необходими корпоративни функции. Ще отбележа следните характеристики:

1. Решения Atlassian са основани на уеб сървъра Java Tomcat. Софтуерът Apache Tomcat е включен в пакета на Atlassian и не може да бъде променян, дори ако версията е остаряла и съдържа уязвимости. Единствената опция е да се изчака обновление от Atlassian с по-нова версия на Apache Tomcat. В момента, например, в актуалните версии на Jira се включва Apache Tomcat 8.5.42, а в Confluence - Apache Tomcat 9.0.33.
2. Удобен интерфейс, реализирани са най-добрите практики, налични на пазара за този клас софтуер.
3. Напълно персонализируемо решение. С доработки може да бъде реализирана всяка промяна на основния функционал за потребителя.
4. Развита екосистема. Има няколко стотици партньори: https://partnerdirectory.atlassian.com, включително 16 партньора в Русия. Чрез партньорите в Русия можете да закупите софтуер на Atlassian, добавки и да преминете обучение. Именно партньорите разработват и поддържат повечето добавки.
5. Магазин за приложения (добавки): https://marketplace.atlassian.com. Добавките значително разширяват функционалността на софтуера на Atlassian. Основната функционалност на софтуера на Atlassian е относително скромна, практически за всяка задача възниква необходимост от инсталиране на допълнителни добавки безплатно или срещу допълнителна такса. Следователно разходите за софтуер могат да се окажат значително по-високи, отколкото първоначално е било оценявано.
   В момента в магазина са публикувани няколко хиляди добавки, почти хиляда от тях са тествани и валидирани по програмата за одобрени приложения Data Center. Такива добавки могат да се считат за стабилни и подходящи за използване в натоварени системи.
   Препоръчвам внимателно да подхождате към планирането на добавките, тъй като това сериозно влияе на цената на решението; много от добавките могат да доведат до нестабилност на системата, а производителят на добавката може да не предостави поддръжка за решаване на проблема.
6. Обучение и сертификации: https://www.atlassian.com/university
7. Поддържат се механизми SSO, SAML 2.0.
8. Поддръжката за мащабируемост и отказоустойчивост е налична само в изданията Data Center. Такова издание за първи път се появи през 2014 година (Jira 6.3). Функционалността на изданията Data Center постоянно се разширява и подобрява (например, възможността за единична инсталация на възел се появи едва през 2020 година). Подходът към добавките за изданията Data Center се е променил значително през 2018 година с въвеждането на одобрени добавки Data Center.
9. Цената за поддръжка. Цената за поддръжка от доставчика е практически равна на пълната цена на лицензите за софтуер. Пример за изчисление на цената на лицензите е представен по-долу.
10. Липса на Long Term версии. Съществуват т. нар. Enterprise версии, но те, както и всички останали версии, се поддържат в продължение на 2 години. С изключение на това, че за Enterprise версиите се публикуват само корекции, без добавяне на нови функционалности.
11. Разширени опции за поддръжка (с допълнителни разходи). https://www.atlassian.com/enterprise/support-services
12. Поддържат се няколко вида СУБД. Софтуерът на Atlassian се предлага с безплатна СУБД H2, която не се препоръчва за продуктивна употреба. За продуктивна употреба се поддържат следните СУБД: Amazon Aurora (само за Data Center) PostgreSQL, Azure SQL, MySQL, Oracle DB, MS SQL Server. Има ограничения по поддържаните версии и често се поддържат само стари версии, но за всяка СУБД има версия с поддръжка от доставчика:
    Поддържани платформи на Jira,
    Поддържани платформи на Confluence.

Техническа архитектура

Обяснения на схемата:

• На схематичното изображение е представена реализация в нашата банка, това конфигурация служи за пример и не е препоръчвана.
• nginx предоставя функционалност за обратен прокси и за Jira, и за Confluence.
• Отказоустойчивостта на СУБД се реализира чрез средствата на СУБД.
• Преносът на промени между средите се извършва с помощта на плъгина Configuration Manager for Jira.
• AppSrv на схемата е собствен сървър за приложения за отчетност, не използва софтуер на Atlassian.
• BD EasyBI е създаден за изграждане на кубове и отчетност с помощта на плъгина eazyBI Reports and Charts for Jira.
• Сервизът Confluence Synchrony (компонент, позволяващ съвместно редактиране на документи) не е отделен инсталационен пакет и се стартира заедно с Confluence на същия сървър.

Лицензиране

Въпросите около лицензирането на Atlassian заслужават отделна статия, тук ще спомена само общите принципи.
Главните въпроси, с които се сблъскахме, са свързани с лицензиране на редакциите Data Center. Спецификата на лицензирането за редакции Server и Data Center:

1. Лицензията за редакцията Server е безсрочна и купувачът може да използва софтуера дори след изтичането на лиценза. Но след изтичането на лиценза купувачът губи правото да получава поддръжка за продукта и да актуализира софтуера до актуални версии.
2. Лицензирането се извършва в зависимост от броя на потребителите с глобалната разрешителна група 'JIRA Users'. Независимо дали потребителите използват системата или не — дори ако не са влизали в системата нито веднъж, всички потребители ще се считат за лицензирани. В случай на надвишаване на броя на лицензирани потребители, решението ще бъде да се отнеме правото 'JIRA Users' на част от потребителите.
3. Лицензът за Data Center по същество е абонамент. Изисква се годишно плащане на лиценза. След изтичането на срока, достъпът до системата ще бъде блокиран.
4. Цената на лицензите може да се променя с времето. Както показва практиката, обикновено в посока увеличение и, възможно, значително. Следователно, ако през тази година лицензите имат определена сума, следващата година цената на лицензите може да нарасне.
5. Лицензирането се извършва по потребители по ниво (например, ниво 1001-2000 потребители). Има възможност за преминаване на по-високо ниво, с доплащане.
6. При надвишаване на броя на лицензируемите потребители, новите потребители ще бъдат създавани без право на достъп до системата (‘JIRA Users’ global permission).
7. Плъгините могат да се лицензира само за същия брой потребители, както основният софтуер.
8. Необходимо е лицензиране само на продуктивни инсталации, за останалите може да се получи Developer license: https://confluence.atlassian.com/jirakb/get-a-developer-license-for-jira-server-744526918.html.
9. За закупуването на поддръжка е необходимо да се закупи Renew Software maintenance — цената е приблизително 50% от цената на оригиналния софтуер. Тази възможност не е налична за Data Center и не важи за плъгини — за тяхната поддръжка ще трябва да се плаща пълната цена ежегодно.
   Така че, годишната поддръжка на софтуера струва повече от 50% от пълната стойност на софтуера в случай на редакцията Server и 100% в случай на редакцията Data Center — това е значително повече отколкото при повечето други доставчици. На мен ми се струва, че това е значителен недостатък на бизнес модела на Atlassian.

Особености на преминаването от редакция Server на Data Center:

1. Преминаването от редакция Server на Data Center е платно. Цената може да бъде намерена тук. https://www.atlassian.com/licensing/data-center.
2. При преминаване от редакция Server на Data Center не се изисква плащане за смяна на редакцията при плъгините — плъгините за редакция Server ще функционират. Но продължаването на лицензиите за плъгини вече задължително ще е необходимо за редакцията Data Center.
3. Можете да използвате приставки, за които няма версия за изданията Data Center. Въпреки това, такива приставки може да работят неправилно и е по-добре предварително да предвидите алтернатива на тях.
4. Преходът към изданието Data Center се извършва чрез инсталиране на нов лиценз. Лицензът за изданието Server остава наличен.
5. Няма функционални разлики между изданията Data Center и Server за потребителите, всички разлики са само в функциите за администриране и техническите възможности на инсталацията.
6. Цената на софтуера и приставките се различава за изданията Server и Data Center. Разликата в цената често е по-малко от 5% (не е съществена). Пример за изчисление на цената е посочен по-долу.

Функционален обем на внедряване

Основното предлагане на софтуер Atlassian включва огромно количество възможности, но често тези възможности на системата са значително недостатъчни. Понякога дори най-простите функции не са налични в основното предлагане, затова без приставки почти не може да се обхване нито едно внедряване. За системата Jira използваме следните приставки (изображението е кликаемо):

За системата Confluence използваме следните приставки (изображението е кликаемо):

Коментари към таблиците с приставките:

• Всички цени са посочени при изчисление на 2000 потребители;
• Цените са посочени на база на посочените цени https://marketplace.atlassian.com, действителната цена (с намаления) е по-ниска;
• Както виждаме, крайната сума практически не се различава за изданията Data Center и Server;
• За използване са избрани приставки, които поддържат само изданието Data Center. Останалите приставки сме изключили от плановете, за да осигурим стабилност на системата.

Функционалността е описана накратко в колоната Коментар. Допълнителни приставки разшириха функционалността на системата:

• Добавени са няколко визуални инструмента;
• Подобрен е интеграционният механизъм;
• Добавен е инструментариум за проекти по водопадната модел;
• Добавен е инструментариум за мащабируем Scrum, за организиране на работата на големи проектни екипи;
• Добавена е функционалност за отчитане на времето;
• Добавен е инструментариум за автоматизация на операции и конфигуриране на решението;
• Добавена е функционалност за опростяване и автоматизация на администрирането на решението.

Допълнително използваме Atlassian Companion app. Това приложение позволява редактиране на файлове във външни приложения (MS Office) и връщането им обратно в Confluence (check-in).
Приложение за работни места на потребителите (дебел клиент) ALM Works Jira Client https://marketplace.atlassian.com/apps/7070 решихме да не го използваме поради лоша поддръжка от страна на доставчика и отрицателни отзиви.
За интеграции с MS Project при нас се използва самостоятелно разработено приложение, което позволява обновяване на статусите на проблеми в MS Project от Jira и обратно. В бъдеще, за същите цели, планираме да използваме платен плъгин Ceptah Bridge — JIRA MS Project Plugin, който се инсталира като допълнение на MS Project.
Интеграцията с външни приложения се реализира чрез Application Links. При това, за приложенията на Atlassian интеграциите са предварително настроени и работят веднага след настройката, например, може да се изведе информация за проблемите в Jira на страница в Confluence.
За достъп до сървърите на Jira и Confluence се използва REST API: https://developer.atlassian.com/server/jira/platform/rest-apis.
SOAP и XML-RPC API са остарели и недостъпни в новите версии за употреба.

Заключение

И така, разгледахме техническите особености на внедряването на системата, базирана на продуктите на Atlassian. Предложеното решение представлява едно от възможните решения и е подходящо за корпоративна среда

Предложеното решение е мащабируемо, устойчиво на отказ, съдържа три среди за организация на разработката и тестването, включва всички необходими елементи за съвместна работа в системата и предоставя широка гама от инструменти за управление на проекти.

С радост ще отговаря на въпросите в коментарите.

Източник: habr.com