Indhold

Introduktion

Formål

Dette dokument indeholder en beskrivelse af hvordan EAS 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
Driften	NSP Leverandøren og NSP Driftleverandøren
SDS	Sundhedsdatastyrelsen
EAS	EHMI Sundhedsadresseringsservice

Installation

EAS anvender NSP's Continuous Integration og Continuous Deployment miljøer til byg og leverance af komponenten.

Jenkins

EAS bygges med NSP's Jenkins server via følgende jobs:

EAS build: Bygger koden og pusher det nyeste snapshot image til NSP Docker Registry.

NSP-Leverandøren er selv ansvarlig for at pushe release versioner af DDTV til NSP Docker Registry igennem Jenkins

Docker

EAS består af følgende Docker image, som pushes til NSP Docker Registry:

registry.nspop.dk/components/eas:<docker-tag>

Docker Compose

DDTV leveres samtidig som et sæt af Docker Compose filer i folderen https://git.nspop.dk/projects/COM/repos/din-digitale-tandlaegevaelger /browse/compose.

En leverance af DDTV består af en compose folder som beskrevet ovenfor samt tilhørende tags af det byggede Docker image.

Compose folderen indeholder tre underfoldere:

configuration

Her ligger alle de konfigurationsfiler som det forventes af driften tilretter til det anvendte miljø. Se EAS Driftsvejledning.

development

Her ligger en Docker Compose fil til brug for udvikling. Se EAS - Guide til udviklere.

release

Her ligger Docker Compose-filen, som forventes at driften anvender på både test og produktionsmiljøerne.

docker-compose.yml

Krav til miljø

Krav til applikationsservere

TODO

Komponenternes konfiguration er tilpasset deployment på WildFly 34.0.0 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

EAS kræver adgang til "Personinformation", "SikredeInformation", "SORES" og Keycloak.

Eksternt kræves adgang til EER, som findes på SDN.

Konfiguration

I folderen "compose/configuration" findes følgende konfigurationsfiler:

TODO

Alle filer skal tilrettes til de forskellige miljøer som EAS installeres på. Filerne indeholder en konfiguration der passer til EAS i en standalone test konfiguration.

I EAS - Driftsvejledning er de enkelte filer gennemgået i detaljer.

SLA logning

TODO

Afvikling

EAS startes og stoppes med Docker Compose kommandoer.

NSP Miljø

På et NSP miljø hentes "compose" folderen for den ønskede version og kommandoen "docker-compose -f <compose-file> up" køres i folderen "release".