Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

Docker Compose

CRA leveres samtidig som et sæt af Docker Compose filer i folderen https://svn.nspop.dk/svn/components/cra/trunk/compose.

...

Compose folderen indeholder 5 underfoldere:

configurationHer ligger alle de konfigurationsfiler som det forventes af driften tilretter til det anvendte miljø. Se CRA - Driftsvejledning
developmentHer ligger en Docker Compose fil til brug for udvikling. Se Guide til Udviklere.
jobcronHer ligger en Dockerfil til afvikling af de forskellige cron-jobs, som kan anvendes til test af servicen.
testHer ligger en Docker Compose fil der kan starte CRA i en standalone test konfiguration.
releaseHer ligger den Docker Compose fil som det forventes driften anvender på både test og produktionsmiljøerne.

Krav til miljø

Krav til applikationsservere

...

I folderen https://svn.nspop.dk/svn/components/cra/trunk/compose/configuration findes følgende konfigurationsfiler:

...

Code Block
titleSpring konfiguration
compose/configuration/cra/bootstrap.xml
compose/configuration/cra/config.xml
compose/configuration/cra/seal.xml
compose/configuration/cra/services.xml
Code Block
titleLog konfiguration
compose/configuration/log4j-cra.xml
compose/configuration/log4j-nspslalog-cra.properties
compose/configuration/nspslalog-cra.properties

bootstrap

XML filen bootstrap.xml indeholder et eksempel på en opsætning af et antal CRS’er. Dette eksempel skal slettes og korrekte CRS’er skal konfigureres inden selve applikationen deployes.
En detaljeret gennemgang af filerne og opsætningen heri kan findes i afsnittet Opsætning.

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

DROS CRA - Driftsvejledning er hver enkel fil gennemgået i detaljer.

...

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-
dros
cra.propertiesPropertyfil, der udpeger den konkrete SLA log konfigurationsfil, der anvendes
log4j-nspslalog-
dros
cra.propertiesSLA log konfigurationsfil

Database

Under  deployment  vha. docker-compose, så bliver filen cra-ds.xml placeret i /pack/wildfly8/standalone/deployments.

CRA-databasen bliver bygget under deployment - eller et image af bygget biver hentet fra repo. Opskriften på byg af cradb findesi filen Dockerfile under cra-db modulet.
Det image som bygges til  cradb basere sig på 'mariadb:10.1' og indeholder 2 sql-filer:

  • drop-create-db.sql: anvendes til at oprette databasen
  • create-test-data.sql:  indsætter testdata i databasen.

Både cra-ds.xml og drop-create-db.sql  indeholder et simpelt brugernavn og kodeord for databasebrugeren og skal derfor rettes inden de anvendes i et produktionsmiljø. Vær også opmærksom på at værdien af connection property rewriteBatchedStatements skal passe med den tilsvarende i services.xml som beskrevet nedenfor

Applikation

Samtidigt med at alle konfigurationsfilerne er placeres korrekt og databasen er startes op kan, så bygges cra-app modulet.
I cra-app kopieres filen target/cra.war kopieres over i /pack/wildfly8/standalone/deployments/.

Konfigurationsfilen bootstrap.xml skal opdateres inden CRA deployes.

Afvikling

DROS startes og stoppes med Docker Compose kommandoer.

...

For en standalone test af DROS CRA hentes "compose" folderen for den ønskede version med Subversion og kommandoen "docker-compose up" køres i folderen "test".

...