...

Det forudsættes at læseren har læst dokumentet Design og Arkitektur (FSK).

Ændringslog

Introduktion til projektet

...

Kodebasen består af én WAR-fil / komponent fsk-service.war.

Specielle bemærkninger

Wildfly

Der benyttes Wildfly 8.2.

Databasevedligehold

Servicen benytter i udviklingssammenhæng Flyway, hvilket gør at databasen i udviklingsmiljøet automatisk opdateres til gældende version. Eneste forudsætning er at recreate_database.sql script samt recreate_service_user.sql script, som er placeret i fsk-service/etc/db/, er blevet afviklet mod databasen.På miljøer, hvor der skal være mulighed for rollback, benyttes migrerings scripts fra fsk-service/etc/db/migration.

Klienter til kald af underliggende registre

...

Der er behov for adgange til følgende systemer:

• NSP SVN-repository
for FSK 1.5: https://svn.nspop.dk/svn/trifork/fsk15
• Dependencies trækkes fra NSP's Nexus-repository: https://nexus.nspop.dk

Opsætning af udviklingsmiljø

Al kode findes i NSP SVN: https://svn.nspop.dk/svn/trifork/fsk15

Efter at projektet er checket ud vil man typisk gøre følgende:

• Opsætte udviklingsmiljø (her antages IntelliJ)

• Bygge war-filen med Maven og køre tests 

Kodestruktur

Koden er opdelt i 3 maven-moduler:

...

• tests

Bygge WAR

...

filer

Følgende software er nødvendigt for at bygge projektet

...

1. Installér og start MariaDB

2. Check Klon projektet ud fra SVN: https://svn.nspop.dk/svn/trifork/fsk15

3. Opret database via script i fsk-service/etc/dbførnævnte SQL-script

4. For at bygge projektets war-fil, samt afvikle unit- og integrationstests, foretages kommandoen: mvn clean install

Opsætning af IntelliJ Idea

Man åbner blot pom.xml fra rodbiblioteket. Efter en mvn clean install bør dependencies være på plads.

...

1. projektet, foretage unittests samt at bygge war-filer foretages kommandoen: mvn clean install

Deployment med Docker

Når man udvikler kan det være praktisk at deploye applikationen på en lokal Wildfly server, da det er denne applikationsserver som bruges i NSP produktionsmiljø. Der henvises til Installationsvejledning (FSK) for nærmere instrukser.lokalt. Dette kan gøres vha. Docker Compose-filen under compose/development/docker-compose.yml.

docker-compose up -d --build