VTP hjelper deg med å:
- virtualisere grensesnitt rundt applikasjonene i FP-familien.
- instansierer og holde testdata konsistente på tvers av grensesnittene
- ha en plattform for å simulere grensesnitt over REST, SOAP, Kafka, LDAP.
- sikkerhetshåndtering over OAuth2
- REST-grensesnitt for å programatisk opprette testdata (for automatiske tester)
- GUI for å opprette testdata for mennesker.
Team Foreldrepenger <teamforeldrepenger(at)nav.no>
Interne henvendelser kan sendes via Slack i kanalen #vtp-chatten
- VTP trenger Keystore og Truststore liggende i mappe .modig på brukerens hjemme-mappe, eller konfigurert gjennom verdier angitt i avsnitt om sikkerhet.
- Start mock serveren ved å kjøre MockServer (lokalt).
- Trenger parameter -Dscenarios.dir="../model/scenarios" dersom denne ikke ligger under working dir (dvs. i IDE).
- Swagger UI: https://localhost:8063/swagger/ - Bruk HTTP for kall
- SoapWebServiceConfig.java inneholder endepunker for virtuelle tjenester.
- Kjør run-java.sh (denne fungerer også for Git-Bash)
- 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.
- Dersom bygg feiler på utviklerimage, forsøk å oppdater node / yarn. Oppdaterte versjoner ligger på http://a34apvl063.devillo.no:81/software/.
- Opprett testdata ved å lage scenario i /model/scenarios. Innledende tall brukes som referanse for å få instansiert scenario fra Autotest.
- Automatiske tester for FPSAK (og andre FP*-familieapplikasjoner) ligger i eget repo på GitHub (private): fpsak-autotest link
- Start applikasjonen med --vtp i oppstartsparameterne for å gå mot VTP istedet for testmiljø.
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. 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. Alias for sertifikatet er localhost-ssl
JAVAX_NET_SSL_TRUSTSTORE
JAVAX_NET_SSL_TRUSTSTOREPASSWORD
NO_NAV_MODIG_SECURITY_APPCERT_KEYSTORE
NO_NAV_MODIG_SECURITY_APPCERT_PASSWORD
Se SoapWebServerConfig for liste over url til genererte wsdl'er. Nye webtjenester registreres her. Se ApplicationConfig for liste over registrerte REST-tjenester. Nye REST-tjenester registreres her.
Lagt til noen forenklinger på environment variabler når vi kjører opp VTP + Autotest i docker. Se
./resources/pipeline/readme.md
for mer info. Test certifikater er allerede lagt inn i imaget. Men man må
fortsatt sette path riktig.
Bygge vtp lokalt. Imaget blir da tilgjengelig som vtp:latest
docker build -t vtp .