Tuotantokelpoinen serverless-arkkitehtuuri: sopimuslähtöinen rajapinta OpenAPI:n ja AWS CDK:n avulla
Selin, Patrick (2026)
Selin, Patrick
2026
All rights reserved. This publication is copyrighted. You may download, display and print it for Your own personal use. Commercial use is prohibited.
Julkaisun pysyvä osoite on
https://urn.fi/URN:NBN:fi:amk-202601191508
https://urn.fi/URN:NBN:fi:amk-202601191508
Tiivistelmä
Tässä insinöörityössä tarkasteltiin, miten OpenAPI-standardiin perustuva suunnittelulähtöinen menetelmä (design first) ja AWS Cloud Development Kit (CDK) -työkalulla toteutettu infrastruktuurikoodi (Infrastructure as Code, IaC) voidaan yhdistää tuotantokelpoisen serverless-datarajapinnan toteutukseen. Työ toteutettiin toimeksiantona Alma Medialle datan jakelun ja automaation tarpeisiin.
Kehitystyön lähtökohtana oli pörssisähkön hintatietoja tarjoava rajapinta. Arkkitehtuuri suunniteltiin uudelleenkäytettäväksi siten, että uusia tietolähteitä ja aineistokokonaisuuksia voidaan ottaa käyttöön samaa toteutusmallia noudattaen.
Toteutuksessa hyödynnettiin sopimuslähtöistä työnkulkua: OpenAPI-määrittely rajasi rajapinnan rakenteen, tietoturvamallin ja validointisäännöt, ja AWS CDK automatisoi infrastruktuurin käyttöönoton Alma Median pilviympäristöön. Ratkaisua arvioitiin kehitysympäristössä kohdennetuilla skenaarioilla viiden tuotantokelpoisuuden periaatteen näkökulmasta (hallintamalli, tietoturva, suorituskyky, operoitavuus ja laajennettavuus).
Tulokset osoittivat, että ratkaisu täytti keskeiset tuotantokelpoisuuden vaatimukset arvioidussa laajuudessa. Tietoturva-, välimuisti-, valvonta- ja käyttöönotto-ominaisuudet toimivat suunnitellusti, ja mittaukset osoittivat toiminnan vakaaksi sekä vasteajat lyhyiksi. Laajennettavuus validoitiin lisäämällä järjestelmään uusi asuntojen hintatietoaineisto samaa sopimus- ja infrastruktuurimallia hyödyntäen ilman muutoksia arkkitehtuurin perusrakenteeseen. Johtopäätöksenä todettiin, että sopimuskeskeisen lähestymistavan ja infrastruktuurikoodin yhdistäminen parantaa pilvipohjaisten rajapintojen hallittavuutta ja ylläpidettävyyttä sekä tarjoaa toistettavan mallin uusien aineistojen käyttöönottoon.
Kehitystyön lähtökohtana oli pörssisähkön hintatietoja tarjoava rajapinta. Arkkitehtuuri suunniteltiin uudelleenkäytettäväksi siten, että uusia tietolähteitä ja aineistokokonaisuuksia voidaan ottaa käyttöön samaa toteutusmallia noudattaen.
Toteutuksessa hyödynnettiin sopimuslähtöistä työnkulkua: OpenAPI-määrittely rajasi rajapinnan rakenteen, tietoturvamallin ja validointisäännöt, ja AWS CDK automatisoi infrastruktuurin käyttöönoton Alma Median pilviympäristöön. Ratkaisua arvioitiin kehitysympäristössä kohdennetuilla skenaarioilla viiden tuotantokelpoisuuden periaatteen näkökulmasta (hallintamalli, tietoturva, suorituskyky, operoitavuus ja laajennettavuus).
Tulokset osoittivat, että ratkaisu täytti keskeiset tuotantokelpoisuuden vaatimukset arvioidussa laajuudessa. Tietoturva-, välimuisti-, valvonta- ja käyttöönotto-ominaisuudet toimivat suunnitellusti, ja mittaukset osoittivat toiminnan vakaaksi sekä vasteajat lyhyiksi. Laajennettavuus validoitiin lisäämällä järjestelmään uusi asuntojen hintatietoaineisto samaa sopimus- ja infrastruktuurimallia hyödyntäen ilman muutoksia arkkitehtuurin perusrakenteeseen. Johtopäätöksenä todettiin, että sopimuskeskeisen lähestymistavan ja infrastruktuurikoodin yhdistäminen parantaa pilvipohjaisten rajapintojen hallittavuutta ja ylläpidettävyyttä sekä tarjoaa toistettavan mallin uusien aineistojen käyttöönottoon.
