Produktionssättning Stockholms stad SOA-plattform 1 (9)
Innehållsförteckning 1 Syfte 3 2 Generell information 3 2.1 Förklaringar av objekttyper... 3 2.1.1 TeamPlace... 3 2.1.2 SOA-tjänst... 3 2.1.3 Virtualisering... 3 2.1.4 Ärendestatus (estöd) och Notifieringstjänst... 3 2.2 Förutsättningar... 3 2.3 Miljö... 3 2.3.1 TEST... 4 2.3.2 PREPROD... 4 2.3.3 PROD... 4 3 Generella aktiviteter för driftsättning 5 3.1 Process... 5 3.1.1 Ledtider... 5 3.2 Leverans av SOA-tjänstepaket... 6 3.2.1 Paket på Teamplace... 6 3.2.2 Gate Paketleverans... 7 3.3 Systemtest i Testmiljö... 7 3.3.1 Installation... 8 3.3.2 Systemtest... 8 3.3.3 Gate Testmiljö... 8 3.4 Acceptanstester i PreProd... 8 3.4.1 Installation... 8 3.4.2 Acceptanstester... 8 3.4.3 Gate Preprodmiljö... 8 3.5 Verifierings i Produktionsmiljö... 9 3.5.1 Installation... 9 3.5.2 Acceptanstester... 9 3.5.3 Gate Prodmiljö... 9 2 (9)
1 SYFTE Dokumentet beskriver aktiviteter som applikationsförvaltningen och applikationsdriften för SOA-plattformen tillsammans med utvecklingsprojektet behöver utföra inför driftssättning av SOA-tjänster eller virtualisering av tjänster. Aktiviteterna är obligatoriska för att plattformsförvaltningen ska kunna ta emot nämnda objekttyper. Varje SOA-projekt måste ta höjd för dessa aktiviteter i tid och kostnad. Processen skall även användas när ny funktionalitet och buggrättningar skall driftsättas där det är applicerbart. Processen benämns driftsättningsprocessen och syftar till den process av aktiviteter och hänsynstagande man måste ta i akt för säkerställa kvalite av plattformen med dess etjänster, kostnadseffektivitet och support. Aktiviteter som sker inom plattformsförvaltningen framgår inte av detta dokument. 2 GENERELL INFORMATION 2.1 FÖRKLARINGAR AV OBJEKTTYPER 2.1.1 TEAMPLACE TeamPlace är den area dit leveranser av SOA-tjänster med tillhörande dokumentation sker. Varje SOA-tjänsteutvecklare som inte har tillgång till detta Teamplace måste kontakta Volvo IT om access, se mailadress avseende support i dokument Läs mig först 1.0.docx. 2.1.2 SOA-TJÄNST En SOA-tjänst är en SOA-applikation som paketeras enligt anvisningarna som beskrivs i denna SDK. 2.1.3 VIRTUALISERING Med virtualisering menas att man i MSE alt Appfabric pekar ut en end-point till en tjänst som exekveras i visst verksamhetssystem. 2.1.4 ÄRENDESTATUS (ESTÖD) OCH NOTIFIERINGSTJÄNST Dessa SOA-tjänster är en del av plattformen. Dessa kan användas av verksamhetssystem för att t.ex. skicka statusinformation om ärenden eller utföra utskick av e-post. 2.2 FÖRUTSÄTTNINGAR För att planera införande av en ny SOA-tjänst eller ny funktionaliet krävs ett implementationsavtal mellan Stockholm stad (beställande förvaltning) och Volvo IT. SOA-tjänsten skall vara utvecklad utefter dokument i denna SDK. 2.3 MILJÖ Plattformsförvaltningen tillhandahåller tre miljöer. TEST, PREPROD och PROD. All utveckling sker lokalt i utvecklarens miljö enligt beskrivning som framgår i SDK. 3 (9)
2.3.1 TEST Syftet med miljön är att kunna utföra integrationstester och verifiera lösningen inför acceptanstest. Testmiljön är inte avsedd att vara en labbmiljö för halvfärdiga SOAtjänster. En godkänd paketleverans inklusive källkodsgranskning krävs för installation i Testmiljön. 2.3.2 PREPROD Syftet med miljön är att kunna utföra acceptanstester. 2.3.3 PROD Installation i PROD sker efter godkänd acceptanstest. 4 (9)
3 GENERELLA AKTIVITETER FÖR DRIFTSÄTTNING En förutsättning för driftsättning är att SOA-tjänsteägaren har tecknat avtal med Volvo IT om driftsättning. 3.1 PROCESS Processen för driftsättning har 5 stycken huvudsteg Leverans av SOA-tjänstepaket Granskning av leveransens ingående delar Systemtest i Testmiljö Acceptanstest i PreProdmiljö Verifiering i Produktionsmiljö 3.1.1 LEDTIDER Att gå igenom hela driftsättningsprocessen kan variera från fall till fall, men oftast tar det 4-6 veckor. Faktorer som påverkar tiden är kvaliten på leveransen och hur komplex SOAtjänsten är. Det finns även andra typer av ledtider som sätter vissa ramar för hur lång tid en driftsättning tar, tex brandväggsöppningar som kan ta 1-2 veckor. Dessa öppningar skall dock identifieras redan under uppstartsmötena och hanteras av projektet. 5 (9)
Produktionssättningdatum skall vara bestämt i förväg, men det krävs också ett godkänt acceptanstest minst en vecka innan dag för produktionssättning. Driftsättning i PRODmiljön görs i huvudsak tisdag förmiddagar, i vissa fall även torsdagar då bakomliggande verksamhetssytem kräver det. 3.2 LEVERANS AV SOA-TJÄNSTEPAKET 3.2.1 PAKET PÅ TEAMPLACE Varje SOA-tjänsteleverantör kommer att få tillgång till TeamPlace och en yta dit leveranser av SOA-tjänster skall läggas i en mapp som kallas Leveranspaket. Varje paket skall versionshanteras och innehålla nedan beskrivna filer eller dokument. Dessa är obligatoriska för leveransen. På TeamPlace finns det mallar som skall användas. SOA-tjänsteleverantören skall uppge i god tid när leverans till TeamPlace sker. Detta för att aktiviteter som källkodsgransning etc skall kunna reursplaneras i god tid. Installationspaket Installationspaketet innehåller filer för installation, i en egen zipfil. Installationsdokument Leveransen skall innehålla en installationsbeskrivning för SOA-tjänsten. Det finns en obligatorisk mall för installationsdokumentet, som återfinns i det Teamplace som skapas för varje projekt. 6 (9)
Källkod En zipfil med källkoden för SOA-tjänsten. Källkoden kommer att granskas tillsammans med granskning av användargränssnittet om sådant finns. Bägge aktiviteterna kommer genomföras med hjälp av kontrollmallar och en rapport kommer att skrivas, där eventuella felaktigheter kan komma att behöva åtgärdas. Testdokument Dokument innehållandes testfall för SOA-tjänsten. Det finns en obligatorisk mall för testfall, som återfinns i det Teamplace som skapas för varje projekt. Systemdokumentation Detta dokument skall ge en djupare beskrivning av systemet än vad tidigare har levererats i beställningsdokumentet. Ansökan om access till testmiljön Dokument för att specifiera de inloggningskonton som behövs för att kunna utföra systemtest i testmiljön. Tjänstekontrakt Ett dokument som beskriver vilka tjänster SOA-tjänsten använder sig av. Vilka brandväggsöppningar som skall göras samt vilka endpoints som används för respektive miljö. Säkerhetsgranskning, säkerhetsklassificering, autentisering och auktorisering av tjänster och kryptering/signering av data skall också beskrivas. Det finns en obligatorisk mall för tjänstekontrakt, som återfinns i det Teamplace som skapas för varje projekt. 3.2.2 GATE PAKETLEVERANS Granskning av leveransen påbörjas när alla filer och dokument finns på Teamplace. En gransning görs av flera team och tar normalt ca 2-4 dagar. Utfallet av granskningarna, publiceras på Teamplace i ett granskningsprotokoll för respektive tjänst, som utvecklaren eller leverantören kan ta del av. Granskningen kräver oftast någon åtgärd av SOAtjänsteutvecklaren, vilket man bör ta höjd för i tidplanen för en SOA-tjänst. När hela leveransen är godkänd görs installation i TEST-miljön. 3.3 SYSTEMTEST I TESTMILJÖ 7 (9)
3.3.1 INSTALLATION Volvo IT installerar SOA-tjänsten i testmiljön efter de installationsinstruktioner som följer med paketleveransen. 3.3.2 SYSTEMTEST SOA-tjänsteutvecklaren genomför systemtest genom att utföra de testfall som tillhör SOA-tjänsten. Kontroll av användargränssnittet kommer att göras av Volvo IT. 3.3.3 GATE TESTMILJÖ När systemtesten är genomförd, utvärderas resultatet av testerna och beslut tas om processen kan gå vidare till nästa huvudsteg eller om det behövs ett nytt uppdaterat paket. 3.4 ACCEPTANSTESTER I PREPROD 3.4.1 INSTALLATION Volvo IT installerar SOA-tjänsten i PREPROF efter de installationsinstruktioner som finns med i paketleveransen. 3.4.2 ACCEPTANSTESTER SOA-tjänsteägaren genomför acceptanstest genom att utföra de testfall som tillhör SOAtjänsten. 3.4.3 GATE PREPRODMILJÖ När acceptanstesterna är genomförda, utvärderas resultatet av testerna och beslut tas om processen kan gå vidare till nästa huvudsteg eller om det behövs ett nytt uppdaterat paket. 8 (9)
3.5 VERIFIERINGS I PRODUKTIONSMILJÖ 3.5.1 INSTALLATION Volvo IT installerar SOA-tjänsten i PROD efter de installationsinstruktioner som finns med i paketleveransen. 3.5.2 ACCEPTANSTESTER SOA-tjänsteägaren verifierar att SOA-tjänsten fungerar som tänkt, genom att utföra de testfall som tillhör SOA-tjänsten. 3.5.3 GATE PRODMILJÖ När testfallen i PROD är genomförda, utvärderas resultatet av testerna och beslut tas om SOA-tjänsten kan godkännas eller om det behövs ett nytt uppdaterat paket. 9 (9)