pensjon-etterlatte-saksbehandling

Ny saksbehandlingsløsning for ytelser til etterlatte

Monorepoet bruker husky for pre-commit-hooks. Denne kjører Prettier for frontend og ktlint for backend. Før man starter å kode er det derfor viktig å kjøre bash get-started.sh fra Root. Da vil alle de tre overnevnte bli installert.

Lokal utvikling

Hvordan kjøre en eller flere apper

Forutsetning: Man må installere pluginen EnvFile i IntelliJ.

Det enkleste er å kjøre opp frontend og valgfri backend med docker compose som starter alt man trenger for at APIet skal fungere.

1. Hent secrets

   Kjør scriptet get-secret.sh og velg applikasjon fra listen

2. Kjør docker compose

   docker compose up -d

   Legg til --build hvis du trenger å bygge imaget på nytt. Mer info her: docker compose up
   NB: Hvis du vil kjøre frontend mot lokal backend kan du lese mer her: #frontend-mot-lokal-backend

3. Kjør run config
   Config for å kjøre appen (i IntelliJ) ligger i .run. Denne skal dukke opp automatisk under Run configurations i IntelliJ.

Feilsøking

• Not logged in or lacking rights. Ensure you're connected to naisdevice and gcp.
  • Hvis du er sikker på du er tilkoblet både naisdevice og gcp, kan det være at du må sette default namespace på context:
    kubectl config set-context --current --namespace=etterlatte
• Error occurred while proxying request 0.0.0.0:8080/api/... to host.docker.internal:8090 [ECONNREFUSED]
  • Kan oppstå hvis protokoll (http://) ikke er satt.
• Run config for backend bruker EnvFile i IntelliJ, så pass på at denne pluginen er installert før kjøring.

Frontend mot lokal backend

Frontend kommuniserer med backend via host.docker.internal.
Du må derfor legge til legge til 127.0.0.1 host.docker.internal i /etc/hosts

Om du skal kjøre med frontend og wonderwall mot lokal backend må du overskrive backend-appen sin *_API_URL i ./apps/etterlatte-saksbehandling-ui/.env.dev-gcp.

Se i filen config.ts for å se hvilke _API_URL verdier som kan overskrives.

Eksempel på overskrevet verdi:
BEHANDLING_API_URL=http://host.docker.internal:8090

Postgres (DB)

Apper som har en database vil få dette opprettet ved å kjøre docker-compose up -d. Alternativt er det mulig å kjøre en proxy mot gcp-dev ved å kjøre nais postgres proxy <appnavn>. Merk at for at dette skal fungere kan det ikke sendes passord ved opprettelse av database-kobling.

OBS: Ved bruk av proxy til lokal kjøring må du passe på å ikke endre på Flyway-scripts i prosjektet.

Bygg og deploy

En app bygges og deployes automatisk når en endring legges til i main.

For å trigge manuell deploy kan du gå til Actions -> (velg workflow) -> Run workflow from <branch>

Gradle

Vi bruker personal access token (PAT) til autentisering for å hente intern pakker til prosjektet. Se opprett nytt personlig token.
Legg til token i $HOME/.zshrc t.d export GITHUB_TOKEN=<TOKEN> for å opprette miljøvariabel. NB! Husk å autorisere tokenet mot navikt i Github

Lokal bygg/test - docker

Docker må være installert og kjørende for at lokal bygg/test skal fungere. Hvis man bruker docker desktop så klarer testene å finne docker socket automatisk. Hvis man har colima kjørende så må man sette opp noen miljøvariabler.

DOCKER_HOST=unix://${HOME}/.colima/default/docker.sock
TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE=/var/run/docker.sock

• DOCKER_HOST peker docker app osv mot sock filen fra colima
• TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE setter sock adressen på innsiden av kontainere

Arbeidsflyter og bygging

Foruten lokal Gradle-bruk skjer bygging via Github Actions. Vi har definert flere arbeidsflyter (workflows) som spiller sammen. Hver app har sin app-etterlatte-[appnavn].yaml i .github/workflows. Denne fila må ha samme navn som appen har under apps/

Denne spesifiserer noen parametre og kaller igjen videre. I en pull request blir test-bygget kjørt, ved merge til main blir bygg- og deploy-bygga kjørt Vi har én .test.yaml og én .build-and-deploy.yaml som alle apps bruker. build tagger imaget med sha samt hvilken git-grein det blir bygga fra (oftest main).

Fra GitHub er det også mulig å kjøre et bygg for en enkelt app på valgfri git-grein. Denne bruker samme byggejobb som nevnt over.

For å sette alle applikasjonene i dev tilbake til main, har vi en egen byggejobb etterlatte-tilbakestill-alle.yaml. Denne deployer for kvar applikasjon nyaste image som er tagga med main.

For frontend-appen saksbehandling-ui gjør vi det litt annerledes, så den har sine egne byggejobber deklarert i si yaml-fil.

Sjekker

Vi bruker gradle.pluginen Gradle License Report for å sjekke lisensene til avhengighetene våre. Denne kjøres per nå manuelt, med kommandoen gradle generateLicenseReport.

I frontend bruker vi license-checker-rseidelsohn, som kjøres automatisk i GitHub-actions-byggejobben, og som kan køyrast manuelt med yarn lisenssjekk

Varsling

Det legges ut varsler om feilmeldinger i appene på Slack i kanalen #team-etterlatte-alerts-dev og #team-etterlatte-alerts-prod

Henvendelser

Spørsmål knyttet til koden eller prosjektet kan stilles som issues her på GitHub.

For Nav-ansatte

Interne henvendelser kan sendes via Slack i kanalen #po-pensjon-team-etterlatte.

Feature toggling

For å kunne bruke unleash så må apiToken ressurs være deployet til GCP miljøene med kubectl apply:

kubectl apply -f unleash-api-token-(development|production).yaml

Dette oppretter en envFile som lastes i app/*/.nais/(dev|prod).yaml filene og som gir to miljøvariabler:

• UNLEASH_SERVER_API_URL (husk å legge til /api)
• UNLEASH_SERVER_API_TOKEN (API token for miljøet)

Kode generert av GitHub Copilot

Dette repoet inneholder forekomster av kode generert av GitHub Copilot.