Gå til hovedinnhold

Admissio Eksempeldata

Admissio er rigget opp med et eget miljø som skal brukes for å forvalte eksempeldata. Dette miljøet er tilgjengelig hele tiden og er tilgjengelig med både Min kompetanse og FS-Admin på følgende adresser:

Man bør i hovedsak bruke brukerflatene for å forvalte og legge til relevant eksempeldata!

Eksempeldata-miljøet er konfigurert her: https://gitlab.sikt.no/studieadm/adhoc-env. Det lages en dump av dataen hver natt. Ved resetting av test-miljø for Admissio blir siste dump brukt. Utviklere kan også selv lett bruke dumper fra eksempeldatamiljøet i sine lokale miljø.

Innhold

Hvordan forvalte eksempeldata​

Vi bør som sagt hovedsaklig bruke brukerflatene (Min kompetanse og FS Admin) for å forvalte og legge til relevant eksempeldata. Dette bør gjøres av domene-eksperter og personer som vet hvordan “riktig” data skal se ut.

I noen tilfeller er det relevant å koble rett på databasen for å gjøre justeringer eller legge inn data. Det gjelder for eksempel der det ikke ennå finnes grensesnitt for ting. Merk at data som legges til direkte med sql også bør være kvalitetssikret av domene-eksperter!

Den enkleste måte å koble på databasen direkte er å bruke studieadm-cli slik - det vil logge deg rett på automagisk:

studieadm-cli sql admissio review eksempeldata

Alternativt kan man gjøre det mer manuelt, slik:

psql --host admissio-dev-rds.clkhploit493.eu-north-1.rds.amazonaws.com \
  --user admissio_review_graphql_api \
  --port 5432 \
  eksempeldata

Da trenger man passordet til brukeren admissio_review_graphql_api, det finner man fra Vault (her). Om man gjør dette ofte kan det anbefales å lage en ~/.pgpass-fil med en relevant oppføring, noe à la dette (passordet må erstattes):

admissio-dev-rds.clkhploit493.eu-north-1.rds.amazonaws.com:5432:*:admissio_review_graphql_api:PASSORD-HER

For de som bruker IntelliJ kan det være praktisk å sette opp eksempeldata som datakilde. Det kan man gjøre slik:

IntelliJ-oppsett av datakilde

Her bør man legge passordet i ~/.pgpass som foreslått over. I tillegg bør man sette Time zone: Europe/Oslo under Options.

Lokale miljøer​

For utviklere som jobber med Admissio er det nyttige å dra opp lokale miljøer med relevant eksempeldata. Til dette har vi et lite sett med mise-tasks som gjør det lett å få ting til å kjøre raskt.

Kjør opp databasen i docker og restore fra siste eksempeldata​

Om man bare ønsker å få opp en lokal postgres som har siste versjon av eksempeldata kan man gjør dette:

mise run db-local-restore-eksempeldata

Restore fra en spesifikk eksempeldata-versjon​

# Lister ut de tilgjengelige eksempeldata-dumpene
mise run db-eksempeldata-list

# Henter siste eller spesifisert dump
mise run db-eksempeldata-download [yyyymmdd_hhmmss_UTC]

# Restore fra spesifisert dump-fil
mise run db-local-restore DUMP-FILNAVN

Mer avansert dump og restore​

Vi kan også gjøre en dump og restore fra og til databasene i RDS. For eksempel kan man starte et review-miljø og fylle det med eksempeldata slik:

mise run db-eksempeldata-download 20250817_025017_UTC

# Lister opp eksisterende review-miljøer
mise run db-review-list

mise run db-rds-restore REVIEW-NAVN DUMP-FILNAVN