To forskellige former. Er det folk der skal bruge produktet eller integrere op mod en service

SDK guide til de folk der skal anvende sdket

fx hvordan finder man dokumentation
Det kan være godt at skrive i kode nær dokumentation.
evt. linke til arkitektur beskrivelse, så man kan forstå, hvordan tingene hænger sammen.

End web projekter - de folk der skal bruge produktet. Altså bruge websitet

Introduktion

Formål

Formålet med dette dokument er at beskrive hvordan et udviklingsmiljø, til videreudvikling af NAP ref-implementation, skal sættes op, samt hvordan koden bygges, deployes og testes.

Forudsætninger

Det lokale udviklingsmiljø er opsat med docker. For at kunne køre de compose filer, der bliver beskrevet nedenfor kræves et docker netværk kaldet nap_net. Hvis dette ikke allerede er lavet kør `docker network create nap_net`.

Der udstilles ingen porte på docker-hosten, og alt trafik routes således igennem en lokal reverse proxy https://svn.nspop.dk/svn/components/nap/nap-compose/ på localhost:8080 som skal køres parallelt på samme netværk.

Nap-ref-web

Udviklingsmiljø

Installer dependencies med `npm i` i rodfolderen.

Under compose/-folderen findes forskellige compose-filer til udvikling, test og release.

Vær opmærksom på, at kun at køre en service ved navn naprefweb ved køre `docker-compose down`.

For at opsætte en webpack dev server i docker køres `docker-compose build && docker-compose up` fra compose/develop.

Hvis dependencies ændres skal containeren bygges igen, ellers er det fremover nok bare at køre `docker-compose up`.

Compose-up setup volume mapper ./src folderen og ændringer i kildekoden vil blive compilet med det samme.

Applikationen kan nu nåes internt i docker på netværket nap_net på http://naprefweb:8080 (såfremt yderlige porte ikke eksponeres) og på http://localhost:8080/nap/reference/web/.

Jenkins bygget kan testes ved at køre at `docker-compose up` i compose/test.