Liittyminen kehitysympäristöön
Tälle sivulle on koottu Palveluväylän kehitysympäristöön liittymisen vaiheet sekä aiheeseen liittyvät tukiartikkelit.
Kehitysympäristö on Suomi.fi-palveluväylän pilotointiympäristö, johon voi liittyä kuka tahansa - niin yksityishenkilöt kuin organisaatiot. Kehitysympäristössä voit esimerkiksi kokeilla Palveluväylän ominaisuuksia, testata uusia versioita tai validoida oman kehitystyösi ominaisuuksia.
Voit lukea Palveluväylän eri ympäristöistä artikkelista Palveluväylän ja Liityntäkatalogin ympäristöt.
Jos olet liittymässä Palveluväylän testi- ja tuotantoympäristöön, katso siihen liittyvät erilliset ohjeistukset hallinnollisesta ja teknisestä käyttöönotosta.
Ennen kuin aloitat kehitysympäristöön liittymisen, lue sivu Liittyminen Palveluväylän kehitysympäristöön.
1. Pystytä verkkoympäristö
Liityntäpalvelin on X-Road-ohjelmistoa käyttävä palvelin, joka liitetään osaksi Palveluväylää. Liityntäpalvelimen kautta kutsutaan Palveluväylän palveluita.
Liityntäpalvelimen voi pystyttää esimerkiksi virtuaalikoneena tai Docker-konttina fyysiselle palvelimelle tai pilviympäristöön.
Alla näet kevyet esimerkkiratkaisut FI-DEV kehitysympäristöön nopeaa liittymistä varten:
1. Pilviympäristöön (AWS) pystytetty virtuaalipalvelin, jolla tehdään suoraan testaushakuja (ei erillistä tietojärjestelmää)
2. Pilviympäristöön (AWS) pystytetty konttipalvelin, jolla tehdään suoraan testaushakuja (ei erillistä tietojärjestelmää)
Esimerkkiratkaisujen tekniset vaatimukset
Liityntäpalvelimien teknisistä vaatimuksista löydät tarkempaa sivulta Liityntäpalvelimen tekniset vaatimukset.
Esimerkki kevyestä testikäyttöön sopivasta mitoituksesta on alla olevassa taulukossa:
Ratkaisutyyppi | 1. Kevyt/minimi virtuaalipalvelin | 2. Kevyt/minimi konttipalvelin |
|---|---|---|
Käyttöjärjestel-mä | Ubuntu 22.04 LTS | Linux-pohjainen alustapalvelin konttia varten |
Prosessi | 2 vCPU Corea | 2 vCPU Corea |
Käyttömuisti (RAM) | 4GB | 4GB |
Levytila | 10GB OS 20-40GB /var/lokeja varten | 10GB OS 20-40GB /var/lokeja varten |
Verkko | 1 Gb/s - verkkokorttiyhteys | 1 Gb/s - verkkokorttiyhteys |
Kevyellä ratkaisulla toteutettu (liityntä)palvelin kykenee tekemään 50 kyselyä minuutissa (sanomakoot ≤ 500 K) jatkuvalla tasaisella kuormituksella tai siirtämään isoja tietomääriä (sanomakoot 0,5 M–10 M) normaalien SOAP-sanomien sisällä muutama kysely minuutissa.
2. Nimeä palvelin
Nimeä palvelin alla olevan esimerkin mukaisesti:
organisaatiolpdev01.org.fi
- organisaatio = oman organisaatiosi nimi tai sen lyhenne
- lp = lyhenne sanasta liityntäpalvelin
- dev = Palveluväylän ympäristön tunnus
- 01 = juokseva numerointi, jota muuttamalla voi nimetä uudet liityntäpalvelimet (esimerkiksi organisaatiolpdev01, organisaatiolpdev02, organisaatiolpdev03)
Lue lisää palvelimen nimeämisestä.
3. Täytä liittymishakemus kehitysympäristöön
Kun haluat liittyä Palveluväylän kehitysympäristöön, lataa ja täytä
Hakemus Suomi.fi-palveluväylän kehitysympäristöön (FI-DEV) (DOCX, 89,44 kt)Avautuu uuteen ikkunaan.
ja lähetä se sähköpostitse osoitteeseen palveluvayla@palveluvayla.fiAvautuu uuteen ikkunaan..
4. Asenna liityntäpalvelinohjelmisto
Seuraa alustapalvelimesi mukaisia asennusohjeita:
- Liityntäpalvelinohjelmiston asennusohjeet Ubuntu-liityntäpalvelimille
- Liityntäpalvelinohjelmiston asennusohjeet RHEL-liityntäpalvelimille
- Kontitetun liityntäpalvelimen (Docker) asentaminen
5. Rekisteröi ja konfiguroi liityntäpalvelin
Rekisteröi liityntäpalvelin Palveluväylään liityntäpalvelimen hallintakäyttöliittymässä ja konfiguroi se käyttämällä X-Road Toolkit -työkalua.
Ohjeet X-Road Toolkitin käyttöön löydät sivulta Liityntäpalvelimen konfigurointi X-Road Toolkitillä.
Perustietoa X-Road Toolkitistä löydät sivulta Palveluväylän X-Road Toolkit – liityntäpalvelimen automaattiset hallintaskriptit.
Kun olet konfiguroinut liityntäpalvelimen, voit siirtyä alijärjestelmän ja palveluiden lisäämiseen. Lue lisää: