docs: legg til diagnostics-regler i GEMINI.md — aldri gjett, hent logs direkte
This commit is contained in:
parent
c4f006f5f8
commit
379bbc523d
|
|
@ -72,6 +72,69 @@ HUB_URL: https://opax.vauco.no
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## Diagnostics Rules (CRITICAL)
|
||||||
|
|
||||||
|
> **Regel: Aldri gjett. Alltid hent faktisk data før du konkluderer.**
|
||||||
|
|
||||||
|
### Ved build-feil (Cloud Build)
|
||||||
|
|
||||||
|
NÅR `gcloud builds submit` feiler → kjør ALLTID dette FØR du gjør noe annet:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Hent siste build-ID og vis logg direkte
|
||||||
|
BUILD_ID=$(gcloud builds list \
|
||||||
|
--project=propane-will-491900-m5 \
|
||||||
|
--limit=1 \
|
||||||
|
--format="value(id)")
|
||||||
|
|
||||||
|
gcloud builds log $BUILD_ID \
|
||||||
|
--project=propane-will-491900-m5 2>&1 | tail -80
|
||||||
|
```
|
||||||
|
|
||||||
|
- IKKE søk på nett før du har lest loggene.
|
||||||
|
- IKKE gjett på årsak basert på exit code alene.
|
||||||
|
- Exit code 125 = Docker-feil → les logg for å se hvilken linje som feilet.
|
||||||
|
|
||||||
|
### Ved deploy-feil (Cloud Run)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Hent Cloud Run-logger
|
||||||
|
gcloud logging read \
|
||||||
|
'resource.type=cloud_run_revision AND resource.labels.service_name=osvauco-agent' \
|
||||||
|
--project=propane-will-491900-m5 \
|
||||||
|
--limit=50 \
|
||||||
|
--format="value(textPayload)"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Ved HTTP-feil (4xx/5xx fra tjeneste)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Test direkte mot Cloud Run URL (bypasser IAP)
|
||||||
|
curl -s -o /dev/null -w "%{http_code}" \
|
||||||
|
-H "Authorization: Bearer $(gcloud auth print-identity-token)" \
|
||||||
|
https://osvauco-agent-357036551735.us-central1.run.app/ENDPOINT
|
||||||
|
```
|
||||||
|
|
||||||
|
### Ved sertifikat/DNS-feil
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Sjekk SSL-sertifikat status
|
||||||
|
gcloud compute ssl-certificates list \
|
||||||
|
--project=propane-will-491900-m5 \
|
||||||
|
--format="table(name,managed.status,managed.domainStatus)"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Generell regel
|
||||||
|
|
||||||
|
| Situasjon | Gjør DETTE | IKKE dette |
|
||||||
|
|-----------|-----------|------------|
|
||||||
|
| Build feiler | Les build-logg via `gcloud builds log` | Søk på nett |
|
||||||
|
| Runtime-feil | Les Cloud Run-logger | Gjett på koden |
|
||||||
|
| HTTP 404 | `curl` tjenesten direkte | Endre kode uten å bekrefte |
|
||||||
|
| Auth-feil | `gcloud auth list` + `gcloud auth print-identity-token` | Anta token er ugyldig |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Domain Convention
|
## Domain Convention
|
||||||
|
|
||||||
| Subdomain | Type | Purpose |
|
| Subdomain | Type | Purpose |
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue
Block a user