|
| 1 | +Virtuell Tjeneste Plattform (VTP) |
| 2 | +================================= |
| 3 | + |
| 4 | + |
| 5 | + |
| 6 | +VTP hjelper deg med å: |
| 7 | +- virtualisere grensesnitt rundt applikasjonene i FP-familien. |
| 8 | +- instansierer og holde testdata konsistente på tvers av grensesnittene |
| 9 | +- ha en plattform for å simulere grensesnitt over REST, SOAP, Kafka, LDAP. |
| 10 | +- sikkerhetshåndtering over OAuth2 |
| 11 | +- REST-grensesnitt for å programatisk opprette testdata (for automatiske tester) |
| 12 | +- GUI for å opprette testdata for mennesker. |
| 13 | + |
| 14 | +# Henvendelser |
| 15 | + |
| 16 | +Team Foreldrepenger <teamforeldrepenger(at)nav.no> |
| 17 | + |
| 18 | +## For NAV-ansatte |
| 19 | + |
| 20 | +Interne henvendelser kan sendes via Slack i kanalen #vtp-chatten |
| 21 | + |
| 22 | + |
| 23 | +# Hvordan komme igang - Oppsett og konfigurasjon |
| 24 | + |
| 25 | + |
| 26 | +Starte server |
| 27 | +---- |
| 28 | +* Start mock serveren ved å kjøre MockServer (lokalt). |
| 29 | +* Trenger parameter -Dscenarios.dir="../model/scenarios" dersom denne ikke ligger under working dir (dvs. i IDE). |
| 30 | +* Swagger UI: https://localhost:8063/swagger/ - Bruk HTTP for kall |
| 31 | +* SoapWebServiceConfig.java inneholder endepunker for virtuelle tjenester. |
| 32 | +* VTP trenger Keystore og Truststore liggende i mappe .modig på brukerens hjemme-mappe, eller konfigurert gjennom verdier angitt i avsnitt om sikkerhet. |
| 33 | + |
| 34 | +Front-end |
| 35 | +--- |
| 36 | +* I mappen frontend kjør yarn run serve. Når VTP bygges så pakkes det også med en statisk versjon av front-end som er tilgjengelig på rot av localhost:8060 eller https://localhost:8063. |
| 37 | +* Dersom bygg feiler på utviklerimage, forsøk å oppdater node / yarn. Oppdaterte versjoner ligger på http://a34apvl063.devillo.no:81/software/. |
| 38 | + |
| 39 | + |
| 40 | +Opprette testdata |
| 41 | +---- |
| 42 | +* Opprett testdata ved å lage scenario i /model/scenarios. Innledende tall brukes som referanse for å få instansiert scenario fra Autotest. |
| 43 | + |
| 44 | +Kjør tester |
| 45 | +---- |
| 46 | +* Automatiske tester for FPSAK (og andre FP*-familieapplikasjoner) ligger i eget repo på GitHub (private): [fpsak-autotest link](https://github.com/navikt/fpsak-autotest) |
| 47 | + |
| 48 | +Koble FP*-applikasjoner til VTP |
| 49 | +------ |
| 50 | + |
| 51 | +* Start applikasjonen med --vtp i oppstartsparameterne for å gå mot VTP istedet for testmiljø. |
| 52 | + |
| 53 | +Sikkerhet |
| 54 | +---- |
| 55 | +For å få VTP til å kjøre med SSL/TLS forbindelse over SOAP, REST og Kafka må keystore angitt i VTP være tilgjengelig i SUT (System under test) sin Truststore. |
| 56 | +For lokal utvikling på Team Foreldrepenger er trust- og keystore distribuert. På laptop kan disse genereres selv. Følgende systemvariabler kan defineres for å overstyre defaults i VTP. |
| 57 | +Alias for sertifikatet er localhost-ssl |
| 58 | + |
| 59 | +```bash |
| 60 | +JAVAX_NET_SSL_TRUSTSTORE |
| 61 | +JAVAX_NET_SSL_TRUSTSTOREPASSWORD |
| 62 | +NO_NAV_MODIG_SECURITY_APPCERT_KEYSTORE |
| 63 | +NO_NAV_MODIG_SECURITY_APPCERT_PASSWORD |
| 64 | +``` |
| 65 | + |
| 66 | + |
| 67 | +Utvikling, wsdl |
| 68 | +---- |
| 69 | +Se SoapWebServerConfig for liste over url til genererte wsdl'er. Nye webtjenester registreres her. |
| 70 | +Se ApplicationConfig for liste over registrerte REST-tjenester. Nye REST-tjenester registreres her. |
| 71 | + |
| 72 | + |
| 73 | +### Kjøre via docker run / docker-compose |
| 74 | +Lagt til noen forenklinger på environment variabler når vi kjører opp VTP + Autotest i docker. Se |
| 75 | +`./resources/pipeline/readme.md` for mer info. Test certifikater er allerede lagt inn i imaget. Men man må |
| 76 | +fortsatt sette path riktig. |
| 77 | + |
| 78 | + |
| 79 | +Bygge fpmock lokalt. Imaget blir da tilgjengelig som fpmock2:latest |
| 80 | +``` |
| 81 | +docker build -t fpmock2 . |
| 82 | +``` |
0 commit comments