Skip to content

Commit

Permalink
Oppdaterer readme for oppsett av lokal kjøring
Browse files Browse the repository at this point in the history
  • Loading branch information
anders-nom committed Jan 17, 2025
1 parent 27ffaa4 commit 2566450
Showing 1 changed file with 15 additions and 38 deletions.
53 changes: 15 additions & 38 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
tiltakspenger-saksbehandling-api
================

Håndterer vedtak om [tiltakspenger](https://www.nav.no/no/person/arbeid/oppfolging-og-tiltak-for-a-komme-i-jobb/stonader-ved-tiltak).
Håndterer vedtak om [tiltakspenger](https://www.nav.no/no/person/arbeid/oppfolging-og-tiltak-for-a-komme-i-jobb/stonader-ved-tiltak). Backend for [tiltakspenger-saksbehandling](https://github.com/navikt/tiltakspenger-saksbehandling).

En del av satsningen ["Flere i arbeid – P4"](https://memu.no/artikler/stor-satsing-skal-fornye-navs-utdaterte-it-losninger-og-digitale-verktoy/)

Expand All @@ -12,54 +12,31 @@ En del av satsningen ["Flere i arbeid – P4"](https://memu.no/artikler/stor-sat
- [Kotlin](https://kotlinlang.org/)
- [Gradle](https://gradle.org/) brukes som byggeverktøy og er inkludert i oppsettet

For hvilke versjoner som brukes, [se byggefilen](build.gradle.kts)

## Bygging og denslags
For å bygge artifaktene:
## Lokal kjøring

Appen kan kjøres opp lokalt med `main`-funksjonen i ([LokalMain.kt](https://github.com/navikt/tiltakspenger-saksbehandling-api/blob/main/app/src/test/kotlin/no/nav/tiltakspenger/LokalMain.kt)). Denne bruker mocks for de fleste tjenester, og krever kun en lokal database kjørende i tillegg.

Databasen kan startes med docker-compose i [meta-repoet for tiltakspenger](https://github.com/navikt/tiltakspenger). Se README der for fremgangsmåte og import av data.

```sh
./gradlew build
```
For å gjøre spørringer mot GCP-databasene (DEV eller PROD) fra lokal maskin, må [Cloud SQL Proxy](https://cloud.google.com/sql/docs/postgres/sql-proxy) kjøre:

```sh
cloud_sql_proxy -instances=tpts-dev-6211:europe-north1:tiltakspenger-saksbehandling-api=tcp:5432 -enable_iam_login
```

### Kjøre opp appen lokalt

For å kjøre opp tiltakspenger-saksbehandling-api lokalt fra et IDE som for eksempel IntelliJ, kan man kjøre opp `main`-funksjonen
som ligger i `App.kt` ([link](https://github.com/navikt/tiltakspenger-saksbehandling-api/blob/main/app/src/main/kotlin/no/nav/tiltakspenger/vedtak/App.kt)).
## Spørringer mot database
GCP-databasene (dev eller prod) kan nåes fra lokal maskin på ulike måter:

For at det skal funke å kjøre opp appen fra IntelliJ eller tilsvarende IDE må man sette opp noen miljøvariabler. I IntelliJ kan
de konfigureres opp i relevant Run Configuration som blir lagd når man kjører opp App.kt for første gang.

Miljøvariabler som må settes (be om hjelp av en annen utvikler på teamet til å få satt riktige miljøvariabler på din maskin):
Med [nais cli](https://docs.nais.io/persistence/postgres/how-to/personal-access/). Se doc'en for førstegangsoppsett, senere kan du kjøre disse kommandoene:
```
AZURE_APP_CLIENT_ID=
AZURE_APP_CLIENT_SECRET=
AZURE_APP_WELL_KNOWN_URL=
AZURE_OPENID_CONFIG_ISSUER=
AZURE_OPENID_CONFIG_JWKS_URI=
DB_JDBC_URL=
KAFKA_BROKERS=
KAFKA_CREDSTORE_PASSWORD=
KAFKA_KEYSTORE_PATH=
KAFKA_TRUSTSTORE_PATH=
NAIS_CLUSTER_NAME=
TPTS_TOPIC=
kubectl config use-context (dev|prod)-gcp
nais postgres proxy [-p <port>] tiltakspenger-saksbehandling-api
```

**OBS!** `tiltakspenger-saksbehandling-api` er avhengig av at man har en større verdikjede kjørende i miljø for å kunne kjøres opp
lokalt, f.eks. ting som Kafka og postgres. Man anbefales å se i [meta-repoet for tiltakspenger](https://github.com/navikt/tiltakspenger)
for hvordan man kan få kjørt opp de greiene lokalt. Meta-repoet er også behjelpelig med å få kjørt opp `tiltakspenger-saksbehandling-api` i en docker-container.
Med [Cloud SQL Proxy](https://cloud.google.com/sql/docs/postgres/sql-proxy)
```
cloud_sql_proxy -instances=tpts-dev-6211:europe-north1:tiltakspenger-saksbehandling-api=tcp:5432 -enable_iam_login
```

## Arkitekturbeslutninger
Se [docs/adr/index.md](docs/adr/index.md)
Eventuelt med [Cloud SQL Studio](https://console.cloud.google.com/sql/instances/tiltakspenger-saksbehandling-api/studio) web UI.

---

# Henvendelser

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

0 comments on commit 2566450

Please sign in to comment.