Page History
...
Software | Version |
---|---|
Java | 8 |
Docker Engine | 18.02.0+ |
node | 10+ |
Installation
Nap Reference implementation anvender Continuous Integration og Continuous Deployment miljøer til byg og leverance af komponenten.
nap-reference-web og nap-reference-facade ligger som repositories på svn.nspop.dk. Disse skal hentes for anvende de foreslåede compose-setup.
...
Build-nap-reference-facade - bygger nap-reference-facade. I denne bygge fase byggefase kan det vælges at bygge nap-reference-web, hvis dette ønskes inkluderet.
...
Nap reference kan findes på registry.nspop.dk/playground/nap/reference
Docker Compose
Nap-reference leveres som et sæt af Docker Compose filer i folderen https://svn.nspop.dk/
...
src/components/nap/nap-reference-facade/trunk/compose/
For release x.y.z findes Docker Compose filerne i folderen https://svn.nspop.dk/
...
src/components/nap/nap-reference-facade/tags/release-x.y.z/
En leverance af nap-reference består af en compose folder som beskrevet ovenfor samt tilhørende tags.
Compose folderen indeholder
...
4 underfoldere:
Folder | Indhold |
---|---|
configuration | Her ligger alle de konfigurationsfiler som det forventes af driften tilretter til det anvendte miljø. Se Driftvejledningen |
development | Her ligger en Docker Compose fil til brug for udvikling. Se Guide til Udviklere. |
test | Her ligger en Docker Compose fil der kan starte NAS2 i en standalone test konfiguration. |
release | Her ligger den Docker Compose fil som det forventes driften anvender på både test og produktionsmiljøerne. |
Krav til applikationsservere
Nap-reference-facade er udviklet i Docker ved anvendelse af imaget "registry.nspop.dk/platform/nsp:1".
Nap-reference-web er udviklet i Docker ved anvendelse af node:12-alpine.
Den samlede deployment unit, nap-reference, er bygget til og testet i Docker med imaget "registry.nspop.dk/platform/nsp:1"
Konfigurationen er således tilpasset deployering på WildFly 8.2 applikationsservere med OpenJDK 8.
...
Herefter er containeren tilgængelig http://localhost:8080/reference/ såfremt (https://svn.nspop.dk/svnsrc/components/nap/nap-compose/) kører på samme netværk som en reverse proxy.
...
Servicen benytter sig i sin web komponentent komponent (nap-reference-web) af nap-angular-sdk og nap-typescript-sdk og er udviklet til at være indlejret i et værtssytem (eksempelvis nap-java-host), hvor den får alt sin kontekst.
Det meste funktionalitet er bundet op på denne kontekst og det skal derfor opsættes, for at få det fulde ud af nap-reference-web.
Dokument delings servicenDokumentdelingsservicen
Servicen benytter sig af dokumentdelingsservicen og det er et krav, at denne kan nåes på den url, der er specificeret i properties.
...
Derfor skal de følgende konfigurationsfiler, som findes i https://svn.nspop.dk/svnsrc/components/nap/nap-reference-facade/trunk/compose/configuration/, således volume mappes ind i modulet "dk/sds/nsp/nap/reference/facade/main/" på applikations serveren (/pack/wildfly8/modules/ i docker).
Konfigurationsfiler | |
---|---|
Filnavn | Beskrivelse |
log4j-nap-reference-facade.xml | Konfiguration af log-4j. |
log4j-nspslalog.properties | Konfiguration af nap-reference sla-log. |
napref- |
test. |
jks | Konfiguration af nap-reference. |
funktionscertifikat | JKS fil indeholdende Sundhedsdatastyrelsen nap reference funktionscertifikat certifikat |
oiosaml | Konfiguration af OIOSAML |
Ved konfigurationsændringer skal wildfly serveren genstartes.
Alle filer skal tilrettes til de forskellige miljøer som nap-
...
reference installeres på.
I Driftvejledningen er hver enkel fil gennemgået i detaljer.
Standalone test
For en standalone test af nap-reference hentes "compose" folderen for den ønskede version med Subversion og kommandoen "docker-compose up" køres i folderen "test".
Logfiler
Servicen kan logge kald til følgende logs:
...