Hur man implementerar Atlassian Jira + Confluence i företag. Tekniska frågor

Planerar du att implementera Atlassian-programvara (Jira, Confluence)? Vill du undvika allvarliga designfel som måste lösas i sista stund?

Då är du på rätt ställe – vi diskuterar implementeringen av Atlassian Jira + Confluence i företag med hänsyn till olika tekniska aspekter.
Hej, jag är produktägare på RSHB och ansvarar för utvecklingen av Livscykelhanteringssystemet (LHS) som är byggt på programvarorna Atlassian Jira och Confluence.

I denna artikel kommer jag att beskriva de tekniska aspekterna av att bygga LHS. Artikeln kommer att vara till nytta för alla som planerar att implementera eller utveckla Atlassian Jira och Confluence i en företagsmiljö. Den kräver inga specialkunskaper och är riktad mot nybörjare som vill lära sig mer om Atlassians produkter. Artikeln kommer att vara användbar för administratörer, produktägare, projektledare, arkitekter och alla som planerar att implementera system baserade på Atlassians mjukvara.

Introduktion

I artikeln kommer vi att diskutera de tekniska frågorna kring implementeringen av Livscykelhanteringssystemet (LHS) i företagsmiljöer. Låt oss först definiera vad detta innebär.

Vad betyder företagslösning?

Det betyder en lösning som är:

1. Skalbar. Vid ökad belastning finns det tekniska möjligheter att öka systemets kapacitet. Man skiljer mellan horisontell och vertikal skalning — vid vertikal skalning ökar man serverkapaciteten, och vid horisontell skalning ökar man antalet servrar som systemet arbetar med.
2. Felresistent. Systemet förblir tillgängligt om en komponent slutar fungera. Generellt krävs det ingen felresistens för företagslösningar, men vi kommer att överväga just en sådan lösning. I vårt system planeras flera hundra konkurrerande användare, och driftstopp kommer att vara mycket kritiska.
3. Supportat. Lösningen måste ha stöd från leverantören. Mjukvara utan support måste ersättas med interna utvecklingar eller annan mjukvara med support.
4. Installation Självhanterad (On-premise). Självförvaltad — innebär att man kan installera programvara inte i molnet, utan på egna servrar. Mer specifikt handlar det om alla installationsalternativ som inte är SaaS. I den här artikeln kommer vi att fokusera på alternativ för endast Självförvaltad installation.
5. Möjlighet till oberoende utveckling och testning. För att organisera förutsägbara förändringar i systemet krävs separata system för utveckling (ändringar i själva systemet), testsystem (Staging) och produktionssystem för användarnas arbete.
6. Annat. Stöder olika autentiseringsscenarier, har stöd för loggar, har en anpassningsbar rollmodell etc.

Detta är grundläggande element i företagslösningar och, tyvärr, glöms de ofta bort vid systemdesign.

Vad är ett System för livscykelhantering (SLH)?

Kort sagt, i vårt fall handlar det om Atlassian Jira och Atlassian Confluence — system som erbjuder verktyg för att organisera kollektivt arbete. Systemet "imponerar" inte arbetsregler, utan erbjuder en mångfald av verktyg för arbete, inklusive Scrum, Kanban-tavlor, vattendalsmodell, och skalerbar Scrum etc.
Namnet SLH är inte ett branschspecifikt term eller allmänt vedertaget begrepp, det är helt enkelt namnet på systemet i vår bank. SLH för oss är inte ett system för buggrapportering, inte ett system för incidenthantering eller förändringshantering.

Vad ingår i implementeringen?

Implementeringen av lösningen består av många tekniska och organisatoriska frågor:

• Uppdelning av tekniska resurser.
• Inköp av programvara.
• Skapande av ett implementeringsteam.
• Installera och konfigurera lösningen.
• Utveckling av lösningens arkitektur. Rollmodell.
• Utveckling av driftsdokumentation, inklusive instruktioner, regler, tekniska projekt, policys etc.
• Ändring av företagets processer.
• Skapande av supportteam. Utveckling av SLA.
• Utbildning av användare.
• Annat.

I denna artikel kommer vi att se på de tekniska aspekterna av implementeringen, utan detaljer om den organisatoriska sidan.

Egenskaper hos Atlassian

Företaget Atlassian är ledande inom många segment:

• Gartner Magic Quadrant för Enterprise Agile Planning Tools
  (Ledarskapet beror på en lyckad förvärv av AgileCraft med sin molnlösning)
  
• Den globala marknadsandel för verktyg för livscykelhantering av applikationer

Produkter från Atlassian har alla nödvändiga företagsfunktioner. Jag vill lyfta fram följande egenskaper:

1. Atlassians lösningar baseras på webbservern Java Tomcat. Apache Tomcat-programvaran ingår i Atlassians programvara som en del av installationen; det går inte att ändra versionen av Apache Tomcat som ingår i Atlassian-programvaran, även om versionen är föråldrad och har säkerhetsproblem. Det enda alternativet är att vänta på en uppdatering från Atlassian som innehåller en nyare version av Apache Tomcat. Just nu, till exempel, innehåller de aktuella versionerna av Jira Apache Tomcat 8.5.42, medan Confluence innehåller Apache Tomcat 9.0.33.
2. Ett användarvänligt gränssnitt, som implementerar de bästa branschpraxis som finns tillgängliga för denna programvaruklass.
3. Ett helt anpassningsbart lösning. Med anpassningar kan vilken ändring som helst av den grundläggande funktionaliteten för användaren genomföras.
4. En utvecklad ekosystem. Det finns flera hundra partners: https://partnerdirectory.atlassian.com, inklusive 16 partners i Ryssland. Det är genom partners i Ryssland som man kan köpa Atlassians programvara, plugins och genomgå utbildning. Det är också partners som utvecklar och stöder de flesta plugins.
5. Appbutik (plugins): https://marketplace.atlassian.com. Plugins utökar avsevärt funktionaliteten i Atlassians programvara. Grundläggande funktionalitet i Atlassians programvara är ganska modest, och nästan alltid uppstår en behov av att installera ytterligare plugins, gratis eller mot extra kostnad. Därför kan kostnaderna för programvaran bli mycket högre än vad som först beräknades.
   För närvarande finns det flera tusen plugins publicerade i butiken, nästan tusen av dem har testats och validerats enligt programmet för Data Center-godkända appar. Sådana plugins kan betraktas som stabila och lämpliga för användning i belastade system.
   Jag rekommenderar att noggrant planera plugins, eftersom detta kraftigt påverkar kostnaden för lösningen. Många av plugins kan leda till systeminstabilitet och tillverkaren av plugin kan inte erbjuda support för att lösa problemet.
6. Utbildning och certifieringar: https://www.atlassian.com/university
7. SSO-, SAML 2.0-mekanismer stöds.
8. Stöd för skalbarhet och felöverlevnad finns endast i Data Center-versionerna. Denna version introducerades för första gången 2014 (Jira 6.3). Funktionaliteten för Data Center-versionerna utökas och förbättras ständigt (till exempel så kom möjligheten för single node installation först 2020). Tillvägagångssättet för plugins för Data Center-versionerna förändrades kraftigt 2018 med införandet av Data Center-godkända appar.
9. Kostnad för support. Kostnaden för support från leverantören ligger i praktiken nära den fulla kostnaden för licenserna för programvaran. Exempel på beräkning av licenskostnader ges nedan.
10. Avsaknad av långsiktiga releaser. Det finns så kallade Enterprise-versioner, men precis som alla andra versioner stöds de i 2 år. Med den skillnaden att för Enterprise-versioner släpps endast bugfixar, utan att ny funktionalitet läggs till.
11. Utökade supportalternativ (till extra kostnad). https://www.atlassian.com/enterprise/support-services
12. Flera databashanterare stöds. Atlassian-programvaran levereras med den kostnadsfria databashanteraren H2, denna databashanterare rekommenderas inte för produktionsanvändning. För produktionsbruk stöds följande databashanterare: Amazon Aurora (endast Data Center), PostgreSQL, Azure SQL, MySQL, Oracle DB, PostgreSQL, MS SQL Server. Det finns begränsningar för stödda versioner, och ofta stöds endast äldre versioner, men för varje databashanterare finns det en version med leverantörsstöd:
    Jira supported platforms,
    Confluence supported platforms.

Teknisk arkitektur

Förklaringar till schemat:

• Schemat visar en implementation i vår bank, denna konfiguration presenteras som exempel och är inte en rekommenderad.
• nginx tillhandahåller funktionalitet för reverse-proxy både för Jira och Confluence.
• Felöverlevnad för databashanterare realiseras genom databashanterarens egna medel.
• Överföring av ändringar mellan miljöer sker med hjälp av pluginen Configuration Manager for Jira.
• AppSrv på schemat är en egen applikationsserver för rapportering och använder ingen Atlassian-programvara.
• DB EasyBI är skapad för att bygga kuber och rapporter med hjälp av pluginen eazyBI Reports and Charts for Jira.
• Tjänsten Confluence Synchrony (komponenten som möjliggör samtidig redigering av dokument) är inte separat installerad och körs tillsammans med Confluence, på samma server.

Licensiering

Frågor kring Atlassian-licenser förtjänar en egen artikel, här nämner jag endast de allmänna principerna.
De viktigaste frågorna vi stötte på rör licensiering av Data Center-utgåvor. Egenskaperna för licensiering av Server- och Data Center-utgåvor:

1. Licensen för Server-utgåvan är etern och köparen kan använda programvaran även efter att licensen har löpt ut. Men efter utgång av licensen förlorar köparen rätten att få produktstöd och uppdatera programvaran till aktuella versioner.
2. Licensiering görs baserat på antalet användare med global behörighet ‘JIRA Users’. Det spelar ingen roll om de använder systemet eller inte – även om användarna aldrig har loggat in i systemet, kommer alla användare att beaktas för licensen. Om antalet licensierade användare överskrids, kommer lösningen att vara att ta bort fullmakten ‘JIRA Users’ från vissa användare.
3. Licensen för Data Center är faktiskt en prenumeration. Årlig betalning av licensen krävs. Vid utgång av termen kommer arbetet med systemet att blockeras.
4. Licenskostnader kan förändras över tid. Som erfarenheten visar, ofta uppåt och möjligen betydligt. Så om dina licenser kostar en summa i år, kan kostnaden för licenserna öka nästa år.
5. Licensering sker per användare genom tier (till exempel nivå 1001-2000 användare). Det finns möjlighet att uppgradera till en högre tier mot en extra kostnad.
6. Vid överskridande av antalet licensierade användare kommer nya användare att skapas utan rätt att logga in i systemet (‘JIRA Users’ global permission).
7. Plugins kan licensieras endast för samma antal användare som huvudprogramvaran.
8. Licensiering krävs endast för produktionsinstallationer, medan utvecklingslicens kan erhållas för andra: https://confluence.atlassian.com/jirakb/get-a-developer-license-for-jira-server-744526918.html.
9. För att köpa support krävs köp av Renew Software maintenance – kostnaden är ungefär 50 % av kostnaden för den ursprungliga programvaran. Detta alternativ är inte tillgängligt för Data Center och gäller inte för plugins – för deras support måste den fulla kostnaden betalas årligen.
   Således kostar årlig support för programvaran mer än 50 % av det fulla priset för programvaran för Server-utgåvan och 100 % för Data Center-utgåvan – detta är betydligt mer än för de flesta andra leverantörer. Enligt min åsikt är detta en betydande nackdel med Atlassians affärsmodell.

Särskilda aspekter av övergången från Server-utgåvan till Data Center:

1. Övergången från Server edition till Data Center är betalningspliktig. Kostnaden kan hittas här https://www.atlassian.com/licensing/data-center.
2. Vid övergång från Server edition till Data Center krävs ingen betalning för att byta edition av plugins – plugins för Server edition kommer att fungera. Men licenser för plugins måste förnyas för Data Center edition.
3. Du kan använda plugins för vilka det inte finns en version för Data Center editions. Men naturligtvis kan sådana plugins fungera inkorrekt, så det är bättre att förutsäga ett alternativ till sådana plugins.
4. Övergången till Data Center edition görs genom att installera en ny licens. Licensen för Server edition förblir fortfarande tillgänglig.
5. Det finns inga funktionella skillnader mellan Data Center och Server editions för användare, alla skillnader ligger i administrationsfunktioner och tekniska installationsmöjligheter.
6. Kostnaden för mjukvara och plugins skiljer sig mellan Server och Data Center editions. Skillnaden i kostnad är ofta mindre än 5% (inte betydande). Ett exempel på kostnadsberäkning ges nedan.

Omfång av implementering

Basleveransen av Atlassian-mjukvara inkluderar ett stort antal funktioner, men ofta är funktionen som tillhandahålls av systemet otillräcklig. Ibland saknas även de enklaste funktionerna i basleveransen, därför är plugins praktiskt taget nödvändiga för varje implementation. För Jira-systemet använder vi följande plugins (bilden är klickbar):

För Confluence-systemet använder vi följande plugins (bilden är klickbar):

Kommentarer till tabeller med plugins:

• Alla priser baseras på 2000 användare;
• Priserna är baserade på angivna priser https://marketplace.atlassian.com, det verkliga priset (med rabatter) blir lägre;
• Som vi ser, skiljer sig den slutliga summan knappt mellan Data Center och Server editions;
• Endast plugins med stöd för Data Center edition har valts för användning. Övriga plugins har uteslutits från planerna för systemets stabilitet.

Funktionaliteten beskrivs kort i Kommentar-kolumnen. Ytterligare plugins har utökat systemets funktionalitet:

• Några visuella verktyg har lagts till;
• Integrationsmekanismerna har förbättrats;
• Verktyg har lagts till för vattenfallsmodellprojekt;
• Verktyg har lagts till för skalbart Scrum, för att organisera arbetet i stora projektteam;
• Funktionalitet för tidshantering har lagts till;
• Verktyg för automatisering av operationer och konfiguration av lösningen har lagts till;
• Funktionalitet för att förenkla och automatisera administrationen av lösningen har lagts till.

Dessutom använder vi Atlassian Companion app. Denna applikation möjliggör redigering av filer i externa applikationer (MS Office) och att returnera dem till Confluence (check-in).
Applikation för användarnas arbetsstationer (tjock klient) ALM Works Jira Client https://marketplace.atlassian.com/apps/7070 beslöt vi att inte använda på grund av dåligt stöd från leverantören och negativa recensioner.
För integrationer med MS Project vi använder en egenutvecklad applikation som gör det möjligt att uppdatera status på frågor i MS Project från Jira och vice versa. I framtiden planerar vi att använda en betald plugin för samma syften. Ceptah Bridge — JIRA MS Project Plugin, som installeras som ett tillägg på MS Project.
Integration med externa applikationer genomförs via Application Links. För Atlassian-applikationer är integrationerna förkonfigurerade och fungerar omedelbart efter inställning, till exempel kan information om frågor i Jira visualiseras på en sida i Confluence.
REST API används för åtkomst till Jira- och Confluence-servrarna: https://developer.atlassian.com/server/jira/platform/rest-apis.
SOAP och XML-RPC API är avvecklade och inte tillgängliga i nya versioner för användning.

Slutsats

Så vi har granskat de tekniska aspekterna av att implementera systemet baserat på Atlassians produkter. Den föreslagna lösningen representerar en av möjliga lösningar och passar bra för en företagsmiljö.

Den föreslagna lösningen är skalbar, redundant, och innehåller tre miljöer för utveckling och testning, innehåller alla nödvändiga element för samarbete i systemet och erbjuder ett brett utbud av verktyg för projektledning.

Jag svarar gärna på frågor i kommentarerna.

Källa: habr.com