Page History
| Navitabs | ||||
|---|---|---|---|---|
| ||||
Indholdsfortegnelse:
| Table of Contents |
|---|
Introduktion
Formål
Dette dokument indeholder en beskrivelse af hvordan erstatningsCPR2 (herefeter eCPR2Nationalt eCPR (herefter eCPR) 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
...
Installation
eCPR anvender NSP's Continuous Integration og Continuous Deployment miljøer til byg og leverance af komponenten.
Jenkins
eCPR bygges med NSP's Jenkins server via følgende jobs: registry registry.nspop.dk/platform/nsp
Bygget er defineret i Jenkinsfile i rodmappen af eCPR, hvor indholdet af docker containeren er defineret.
Svar omkring dette: Det handler om at man som leverandør selv han en jenkinsfil, hvori man kan definere indholdet af de docker-containere der senere downstream bliver pushet til NSP docker registry. Det er egentlig NSP-teamet hos os der kalder alle de jobs der hedder noget med “push release”, men for eCPR er det lavet lidt anderledes, fordi det historisk var et I selv kunne kalde (fordi det jo ikke var igennem NSP). Det mekanikken på jenkins bliver bygget automatisk, så hvis I bare har en jenkinsfil der kan lave de ønskede containere, så sker resten af sig selv.
Markus vurderer du at så er ovenstående korrekt beskrevet?
Docker
eCPR består af en service og dermed også et docker image som pushes til NSP Docker Registry. Det hedder registry.nspop.dk/components/ecpr2:
...
Compose folderen indeholder 4 underfoldere, hvor databaseligger database ligger under configuration:
| Folder navn | Beskrivelse |
| configuration/database | Her ligger alle de databasefiler som det forventes at driften lægger på en NSP database |
| development | Her ligger en Docker Compose fil til brug for udvikling. Se eCPR - Guide til udviklere |
| release | Her ligger en Docker Compose fil til brug i produktion |
eCPR leveres via en github branch, navngivet som efter den aktuelle version.
Krav til miljø
...
- Authorization View fra autorisationsregisteret
- Bemyndigelse View fra bemyndigelsesservice
- Person View fra cpr registeret
Hver Hvert view er yderligere beskrevet vist nedenfor, hvor det ses hvilke informationer, der skal udstedes gennem hvert view.
eCPR kræver derudover adgang til NAS2 for at kunne udføre de relevante adviseringer på det allerede eksisterende topic "http://sds.dk/personid/2018/01/01" , samt adgang til SCES, for at kunne verificere CPR-numre.
Authorization view
| Information |
|---|
| Authorisationsnummer |
| CPR |
| Uddannelses Kode |
| ValidFrom |
| ValidsTo |
Bemyndigelses view
| Information |
|---|
| BemyndigelsePID |
| Rettighed |
| System |
| Status |
| Arbejdsfunktion |
| Bemyndigede cvr |
| Bemyndigede cpr |
| Bemyndigende cpr |
| Gyldig fra dato |
| gyldig til dato |
| ValidFrom |
| ValidTo |
Person View
| Information |
|---|
| Status |
| CPR |
| ValidFrom |
| ValidTo |
...
Krav til hardware
Der stilles ikke nogle særlige krav til hardware. Servicen er en Java Spring Boot service, og kan dermed køre på en virtuel maskine.
...
I folderen https://svn.nspop.dk/svn/components/nas/trunk/compose/configuration findes følgende konfigurationsfiler:
ecpr2.properties | Konfiguration af ecpr2 services. Filen er gennemgået i detaljer i eCPR - Driftsvejledning hvor hver property er beskrevet separat. |
ecpr2-ds.xml | Definerer databaseadgangen, herunder URL, Username og password. Filen gennemgås ikke yderligere. |
| log4j-ecpr2.xml | Konfiguration af Log4J |
| . Log4j følger gængs standard på NSP og er kort beskrevet i eCPR - Driftsvejledning | |
FMmkVoces.p12 | Certifikat til testbrug. Det er konfigureret i ecpr.properties, hvilket certifikat der bruges |
Alle filer skal tilrettes til de forskellige miljøer som eCPR2 eCPR installeres på. Filerne indeholder en konfiguration, der passer til eCPR2 i en standalone test konfiguration.
I eCPR - Driftsvejledning er hver enkel fil gennemgået i detaljer.
SLA logning
Konfigurationsfiler til SLA logning ligger inde i de Docker images som eCPR2 producerer. De Konfigurationen af SLA logning sker i log4j-nspslalog-ecpr2.properties l i folderen https://svn.nspop.dk/svn/components/nas/trunk/compose/configuration. Knfigurationerne følger standarden for SLA logning og det bør derfor ikke være nødvendigt at ændre i disse.
...
På et NSP miljø hentes "compose" folderen for den ønskede version med git og kommandoen "docker-compose up" køres i folderen "release".
...
Ændringslog
| Version | Dato | Ændring | Ansvarlig |
| 1.0 | 13-11-2023 | Initielt dokument | Trifork |