watson-setup

name	watson-setup
description	Sett opp watson-developer lokalmiljø fra scratch — installerer verktøy, kloner repoer, starter infrastruktur
license	MIT
compatibility	macOS with Homebrew
metadata	{"domain":"onboarding","tags":"setup onboarding watson lokalmiljø kind tilt"}

Watson Developer — Fullstendig oppsett

Denne skillen kjører hele onboarding-prosessen for watson-developer steg for steg. Etter fullført setup har utvikleren et fungerende lokalmiljø med alle verktøy, alle repoer klonet, kind-kluster oppe og Tilt klar til å starte.

Forutsetninger

• macOS
• Homebrew installert
• Docker Desktop installert og kjørende
• GitHub-tilgang til navikt/watson-* repoene
• Scriptet kjøres fra watson-developer-repoets rotkatalog

Instruksjoner til agenten

Du skal kjøre kommandoene i dette dokumentet — ikke bare vise dem til brukeren. For hvert steg:

1. Kjør kommandoen
2. Vent på output
3. Verifiser at resultatet matcher «Forventet resultat»
4. Hvis det feiler: vis feilen, foreslå løsning fra «Hvis det feiler»-seksjonen, og spør brukeren om du skal prøve løsningen
5. Ikke gå videre til neste steg før gjeldende steg er vellykket

Workflow

Kjør hvert steg sekvensielt. Stopp og rapporter status mellom hvert steg. Hvis et steg feiler, vis feilen tydelig og foreslå løsning før du fortsetter.

Steg 1: AI-verktøy (cplt + nav-pilot)

./scripts/setup-copilot.sh

Hva dette gjør:

• Installerer cplt (kernel-sandbox for AI-agenter)
• Installerer nav-pilot (Nav-kunnskap for Copilot)
• Detekterer node version manager og genererer cplt-config
• Aktiverer shell-alias slik at copilot kjører gjennom sandboxen

Forventet resultat: ✅ Ferdig! uten feil.

Hvis det feiler:

• Homebrew er ikke installert → Kjør /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• Dette scriptet støtter kun macOS → Denne skillen er kun for macOS

Steg 2: Pre-flight sjekk

./scripts/doctor.sh

Hva dette gjør:

• Verifiserer at alle nødvendige verktøy er installert
• Sjekker minsteversjonskrav (Java 21+, Node 20+)

Forventet resultat: ✅ Alt er på plass

Hvis det feiler — installer manglende verktøy:

Verktøy	Installasjonskommando
kind	brew install kind
tilt	brew install tilt
kubectl	brew install kubectl
gcloud	Se https://cloud.google.com/sdk/docs/install
java 21	brew install --cask temurin@21
node	brew install node
pnpm	corepack enable

Etter installasjon av manglende verktøy, kjør ./scripts/doctor.sh på nytt for å bekrefte.

Steg 3: Klon alle Watson-repoer

./scripts/clone-repos.sh

Hva dette gjør:

• Kloner alle Watson-porteføljens repoer til forelderkatalogen
• Hvis de allerede finnes: kjører git pull --ff-only

Forventet resultat: Alle repoer klonet/oppdatert uten feil.

Merk: Scriptet fortsetter selv om et repo feiler. Sjekk output for ✗ eller Kloning feilet — hvis du ser slike meldinger, løs problemet og kjør på nytt.

Hvis det feiler:

• Permission denied (publickey) → SSH-nøkkel er ikke konfigurert for GitHub. Kjør gh auth login eller legg til SSH-nøkkel.
• Kloning feilet → Sjekk at du har tilgang til navikt-organisasjonen.

Steg 4: Verifiser Docker

docker info > /dev/null 2>&1 && echo "Docker kjører" || echo "Docker kjører IKKE"

Forventet resultat: Docker kjører

Hvis det feiler:

• Start Docker Desktop manuelt (åpne Finder → Applications → Docker)
• Vent 10–15 sekunder og prøv igjen

Steg 5: Opprett kind-kluster

./scripts/setup-kind.sh

Hva dette gjør:

• Oppretter et Kubernetes-kluster kalt watson via kind
• Setter kubectl-kontekst til kind-watson

Forventet resultat: ✓ Klar — kjør 'tilt up' for å starte lokalmiljøet

Hvis det feiler:

• Docker må kjøre (se steg 4).
• Hvis kind finnes men Docker er nede: kind delete cluster --name watson og prøv igjen.

Steg 6: Start Tilt

Start Tilt i bakgrunnen (non-interaktiv modus). Viktig: Tilt er en long-running prosess. Kjør den i en egen async-shell eller bakgrunn slik at du kan fortsette med verifisering i hovedshellen.

tilt up --stream &
TILT_PID=$!
sleep 5
echo "Tilt startet (PID: $TILT_PID)"

Hva dette gjør:

• Starter lokalt utviklingsmiljø med PostgreSQL og mock-oauth2-server i kind
• Starter watson-admin-api og watson-sak-frontend som lokale prosesser
• --stream kjører uten interaktivt UI (logger til stdout)

Vent til infrastrukturen er oppe (opptil 60 sek), deretter verifiser:

# Vent på mock-oauth2-server (maks 60 forsøk à 2 sek)
for i in $(seq 1 60); do
  curl -sf http://localhost:8090/azuread/.well-known/openid-configuration > /dev/null && break
  sleep 2
done

# Sjekk at mock-oauth2-server svarer
curl -sf http://localhost:8090/azuread/.well-known/openid-configuration | head -1

# Vent på watson-admin-api (kan ta opptil 60 sek pga Gradle-oppstart)
for i in $(seq 1 60); do
  curl -sf http://localhost:8080/actuator/health > /dev/null && break
  sleep 2
done

# Sjekk at watson-admin-api svarer
curl -sf http://localhost:8080/actuator/health | head -1

Forventet resultat: Begge curl-kommandoene returnerer JSON.

Hvis det feiler:

• Sjekk Tilt-logger: tilt logs (i en annen terminal)
• Sjekk Tilt UI: http://localhost:10350
• Restart: tilt down && tilt up --stream &

Steg 7: Verifiser med testtoken

Hent token-instruksjonene fra README (se seksjonen «Hent token for lokal testing»):

TOKEN=$(curl -sf -X POST http://localhost:8090/azuread/token \
  -d "grant_type=client_credentials&client_id=watson-admin-api&client_secret=mock" \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['access_token'])")

curl -sf -H "Authorization: Bearer $TOKEN" http://localhost:8080/api/kontrollsaker | head -1

Forventet resultat: JSON-respons (tom liste [] er OK for nytt miljø).

Merk: Dersom token-endepunkt eller parametere har endret seg, se README.md seksjonen «Hent token for lokal testing» for oppdatert info.

Etter fullført setup

Vis denne oppsummeringen:

────────────────────────────────────────
✅ Watson-lokalmiljø er klart!

Nyttige lenker:
  • Tilt UI:          http://localhost:10350
  • Swagger UI:       http://localhost:8080/swagger-ui/index.html
  • Watson Sak:       http://localhost:5174
  • mock-oauth2:      http://localhost:8090

Neste steg:
  • Les arkitekturkartet:  docs/arkitektur/README.md
  • Les domeneordbok:      docs/domene/ordbok.md
  • Spør i Slack:          #team-holmes

Tips:
  • Start Copilot med sandbox: copilot
  • Restart shell først for å aktivere cplt-alias
────────────────────────────────────────

Feilsøking

Hvis noe feiler underveis:

Problem	Løsning
Docker kjører ikke	Start Docker Desktop
Port opptatt (5432, 8080, 8090)	Stopp prosessen som bruker porten: lsof -i :<port>
kind-kluster i dårlig tilstand	kind delete cluster --name watson && ./scripts/setup-kind.sh
Tilt viser røde ressurser	Sjekk logger i Tilt UI, restart med tilt down && tilt up
npm/pnpm feil i frontend	cd ../watson-sak-frontend && pnpm install
Gradle-feil i backend	cd ../watson-admin-api && ./gradlew clean build