Indholdsfortegnelse
Introduktion
Formål
Dette dokument indeholder en beskrivelse af hvordan installeres på et NSP Backend miljø.
Læsevejledning
Læseren forventes at have kendskab til Sundhedsdatastyrelsens platform NSP, samt generelt kendskab til WildFly applikation server, Docker, Docker Compose samt Ubuntu Linux operativ system.
Definitioner og referencer
| NSP | Den nationale service platform |
| SDS | Sundhedsdatastyrelsen |
| Driftsvejledning | GM-Facade - Driftsvejledning |
Installation
GM-Facade anvender NSP's Continuous Integration og Continuous Deployment miljøer til byg og leverance af komponenten.
Jenkins
GM-Facade bygges med Jenkins server via følgende jobs:
- GMAF_build - Bygger koden
- GMAF_push_snapshot - Pusher det nyeste snapshot image til NSP Docker Registry.
NSP Leverandøren er selv ansvarlige for at pushe release versioner af GM-Facade til NSP Docker Registry igennem Jenkins.
Docker
GM-Facade består af følgende Docker image som pushes til GMAF Docker Registry:
Krav til miljø
Krav til applikationsservere
Komponenten er udviklet og testet i Docker ved anvendelse af imaget "registry.nspop.dk/platform/nsp:4-latest".
Komponentens konfiguration er tilpasset deployment på WildFly 34 applikationsservere med OpenJDK 21.
Krav til operativsystem
Der stilles ingen krav til operativsystemet udover, at det skal være Linux, og docker skal være installeret.
Krav til adgang til andre services
GM-Facade kræver adgang til:
Krav til hardware
Der stilles ingen krav til hardware.
Konfiguration
I folderen "compose/configuration" findes følgende konfigurationsfiler:
| gmaf.properties | |
test_gm_keystore.jks | |
| access-handler/ | Konfiguration relateret til NSP Access Handler til validering af jtph (se NSP Access Handler - Installationsvejledning) |
| access-handler/jtph.properties | |
| access-handler/test-jtph.jks | Keystore skal indeholde public key udsteder af jtph og ligge under alias der matcher kid, som angives i jtph.properties, men med maksimal længe på 32 tegn og kun med små bogstaver. |
| access-handler/crl.skip | |
| access-handler/log.skip | |
| access-handler/security.skip |
Alle filer skal tilrettes til de forskellige miljøer som GM-Facade installeres på. Filerne indeholder en konfiguration der passer til GM-Facade i en standalone test konfiguration.
I GM-Facade - Driftsvejledning er hver enkel fil gennemgået i detaljer.
SLA logning
Konfigurationsfiler til SLA logning konfigureres i nedenstående filer. De følger standarden for SLA logning og det bør derfor ikke være nødvendigt at ændre i disse.
| nspslalog-GM-Facade.properties | Propertyfil, der udpeger den konkrete SLA log konfigurationsfil, der anvendes |
| log4j-nspslalog-GM-Facade.properties | SLA log konfigurationsfil |
Afvikling
GM-Facade startes og stoppes med ??? kommandoer.
Dokument Historik
| 3/4 2025 | Martin Henriksen/SDS | Etablering af dokumentation |