1. Indholdsfortegnelse

2. Indledning

Front-end er opdelt i 2 dele. Facade og klient. Guide til klienten findes her: NADM - NAK (Web App) - Guide til udviklere

2.1. Formål og sammenhæng med andre dokumenter

Formålet med dette dokument er at beskrive hvordan et udviklingsmiljø, til videreudvikling af NADM-NAF Web Facade skal sættes op, kodens struktur, samt hvordan koden bygges, deployeres og testes.

Dette dokument er en del af den samlede dokumentation for NADM-NAF web facade.

Dokumentet er udformet, så det i videst muligt omfang opfylder sit formål uafhængigt af de øvrige dokumenter.

2.2. Forudsætninger

Krav til software:

Software

Version

Java8
Docker Engine18.02.0+
Git 2.30.0+
Maven3.5+


3. Udvikling


Kildekoden til NAF findes på https://git.nspop.dk/scm/com/nsp-administrationsfacade.git og checkes ud med:

git clone https://git.nspop.dk/scm/com/nsp-administrationsfacade.git

Følgende forhold gør sig gældende:

  • Der udvikles på develop branch, features laves som feature branches på develop.
  • Under udvikling bygges og deployeres der ved hjælp af docker.

Før første deployment skal der oprettes to netværk, dette skal kun udføres første gang, eller hvis netværket er blevet fjernet:

docker network create nadm_net
docker network create nsp_net

NAF til udviklings formål bygges og startes med:

mvn package 
docker-compose -f compose/development/docker-compose.yml build 
docker-compose -f compose/development/docker-compose.yml up

For at kunne logge ind via SEB integration i development skal man tilføje følgende til maskinens /etc/hosts fil:

127.0.0.1 dev.nadm.dk

Denne fil ligger i roden af *nix filsystemet.
På Mac kan du eks få adgang via: sudo nano /etc/hosts

API'et kan efter opsætning f.eks. tilgås på følgende adresse:

https://dev.nadm.dk:8080/nadm/api/person/1111111111

Certifikatet, der anvendes under udvikling er udsted automatisk af Caddy, som indgår i docker compose setup'et. Dette skal accepteres af browseren.

Herefter kan guide til klienten findes her: NADM - NAK (Web App) - Guide til udviklere



  • No labels