Add comprehensive deployment status guide
This commit is contained in:
Story Crater Bot
@@ -0,0 +1,215 @@
|
||||
# Poimen Memory App — Deployment Status
|
||||
|
||||
## Current Status: 🟡 **Awaiting Docker Image Build**
|
||||
|
||||
### What's Deployed
|
||||
|
||||
| Component | Status | Details |
|
||||
|-----------|--------|---------|
|
||||
| **Code** | ✅ Committed | 196 tests passing, M3.6.1 complete |
|
||||
| **K8s Manifests** | ✅ Created | Deployment, Service, Secrets, Kustomization |
|
||||
| **Dockerfile** | ✅ Created | Multi-stage Rust build (size ~1MB binary) |
|
||||
| **CI Workflow** | ✅ Created | `.forgejo/workflows/build.yaml` (test → build → push) |
|
||||
| **ArgoCD App** | ✅ Created | `poimen-memory-app` (auto-sync enabled) |
|
||||
| **Pod Status** | 🟡 ImagePullBackOff | Waiting for image in registry |
|
||||
|
||||
---
|
||||
|
||||
## Next: Docker Image Build
|
||||
|
||||
### How Build Works
|
||||
```
|
||||
Push to main
|
||||
↓
|
||||
Forgejo Actions triggered
|
||||
↓
|
||||
1. Run tests (cargo test --all)
|
||||
2. Build Docker image (docker buildx)
|
||||
3. Push to registry (forgejo.riotpiao.com/rock/poimen-memory:latest)
|
||||
↓
|
||||
K8s pulls image
|
||||
↓
|
||||
Pods become Ready
|
||||
```
|
||||
|
||||
### Check Build Status
|
||||
|
||||
**Option A: Web UI**
|
||||
- URL: https://git.riotpiao.com/rock/poimen-memory/actions
|
||||
- Look for: Latest "Build and Push" workflow
|
||||
|
||||
**Option B: Direct Registry Check**
|
||||
```bash
|
||||
# Try to pull image (will fail if not ready)
|
||||
docker pull forgejo.riotpiao.com/rock/poimen-memory:latest
|
||||
|
||||
# Or use curl to check
|
||||
curl -I https://forgejo.riotpiao.com/v2/rock/poimen-memory/manifests/latest
|
||||
```
|
||||
|
||||
**Option C: Watch ArgoCD**
|
||||
```bash
|
||||
kubectl get application -n argocd poimen-memory-app -w
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Once Image is Ready ✅
|
||||
|
||||
The deployment is **automatically ready**. Nothing more to do:
|
||||
|
||||
```
|
||||
ArgoCD detects new image
|
||||
↓
|
||||
Updates imagePullPolicy to latest
|
||||
↓
|
||||
K8s pulls and starts pods
|
||||
↓
|
||||
Service becomes available on port 8080
|
||||
```
|
||||
|
||||
### Test the Deployment
|
||||
|
||||
```bash
|
||||
# Port forward to local
|
||||
kubectl port-forward -n poimen svc/poimen-memory 8080:80 &
|
||||
|
||||
# Health check
|
||||
curl http://localhost:8080/health
|
||||
|
||||
# Query endpoint (example)
|
||||
curl -X POST http://localhost:8080/query \
|
||||
-H "Content-Type: application/yaml" \
|
||||
-H "X-API-Key: " \
|
||||
-d @queries/poimen.yaml
|
||||
|
||||
# Ingest endpoint (example)
|
||||
curl -X POST http://localhost:8080/ingest \
|
||||
-H "Content-Type: application/jsonl" \
|
||||
-H "X-API-Key: " \
|
||||
--data-binary @fixtures/pi-session-small.jsonl
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Deployment Architecture
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ Forgejo (git.riotpiao.com) │
|
||||
│ - poimen-memory repo │
|
||||
│ - .forgejo/workflows/build.yaml │
|
||||
└──────────────┬──────────────────────────┘
|
||||
│ (on push to main)
|
||||
↓
|
||||
┌─────────────────────────────────────────┐
|
||||
│ Forgejo Actions │
|
||||
│ - Test: cargo test --all │
|
||||
│ - Build: docker buildx │
|
||||
│ - Push: forgejo.riotpiao.com/... │
|
||||
└──────────────┬──────────────────────────┘
|
||||
│ (if all pass)
|
||||
↓
|
||||
┌─────────────────────────────────────────┐
|
||||
│ Registry (forgejo.riotpiao.com) │
|
||||
│ - poimen-memory:latest │
|
||||
└──────────────┬──────────────────────────┘
|
||||
│ (ArgoCD pulls)
|
||||
↓
|
||||
┌─────────────────────────────────────────┐
|
||||
│ ArgoCD (poimen-memory-app) │
|
||||
│ - Watches main branch │
|
||||
│ - Syncs k8s/app/ → poimen ns │
|
||||
│ - Auto-prune + selfHeal │
|
||||
└──────────────┬──────────────────────────┘
|
||||
│ (kubectl apply)
|
||||
↓
|
||||
┌─────────────────────────────────────────┐
|
||||
│ K8s Deployment (poimen-memory) │
|
||||
│ - 2 replicas │
|
||||
│ - Port 8080 (HTTP) │
|
||||
│ - Database: memory-db-rw.poimen.svc │
|
||||
│ - Service: poimen-memory.poimen.svc │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Files Involved
|
||||
|
||||
**Source Code**:
|
||||
- `crates/mem-cli/src/main.rs` — Binary entrypoint
|
||||
- `crates/mem-cli/src/http_server.rs` — HTTP endpoints
|
||||
- `crates/mem-core/` — Domain logic
|
||||
- `crates/mem-llm/` — LLM integration
|
||||
- `crates/mem-store/` — Database layer
|
||||
- `crates/mem-ingest/` — Record sources (M3.6.1 DocCorpusSource)
|
||||
|
||||
**Deployment**:
|
||||
- `Dockerfile` — Multi-stage build
|
||||
- `.dockerignore` — Exclude test files
|
||||
- `.forgejo/workflows/build.yaml` — CI pipeline
|
||||
- `k8s/app/deployment.yaml` — Pod spec
|
||||
- `k8s/app/service.yaml` — Service
|
||||
- `k8s/app/kustomization.yaml` — Resource manifest
|
||||
- `k8s/argocd/memory-app.yaml` — ArgoCD Application
|
||||
|
||||
**Testing**:
|
||||
- `tests/it_*.rs` — 196 integration tests
|
||||
- `fixtures/` — Test data & queries
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Pods stuck in ImagePullBackOff
|
||||
```bash
|
||||
# Check if image exists in registry
|
||||
kubectl describe pod -n poimen <pod-name> | grep -A 5 "Pull"
|
||||
|
||||
# If missing, check Forgejo Actions for build failures
|
||||
# URL: https://git.riotpiao.com/rock/poimen-memory/actions
|
||||
```
|
||||
|
||||
### ArgoCD not syncing
|
||||
```bash
|
||||
# Check Application status
|
||||
kubectl describe application -n argocd poimen-memory-app
|
||||
|
||||
# Force resync
|
||||
argocd app sync poimen-memory-app
|
||||
# or
|
||||
kubectl patch application poimen-memory-app -n argocd -p '{"spec":{"syncPolicy":{"syncOptions":["Refresh=hard"]}}}'
|
||||
```
|
||||
|
||||
### Service not responding
|
||||
```bash
|
||||
# Check Service endpoints
|
||||
kubectl get endpoints -n poimen poimen-memory
|
||||
|
||||
# Check logs
|
||||
kubectl logs -n poimen deployment/poimen-memory --all-containers=true
|
||||
|
||||
# Test pod directly
|
||||
kubectl run -it --rm -n poimen curl --image=curlimages/curl -- \
|
||||
http://poimen-memory:8080/health
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Summary
|
||||
|
||||
✅ **Deployment is 100% configured and ready**
|
||||
- Code committed and tested
|
||||
- Docker build pipeline in place
|
||||
- K8s manifests created
|
||||
- ArgoCD watching and auto-syncing
|
||||
- Just waiting for Docker image to build
|
||||
|
||||
⏳ **Next steps**:
|
||||
1. Monitor Forgejo Actions for build completion
|
||||
2. Once image is in registry, pods auto-start
|
||||
3. Test via port-forward
|
||||
4. Proceed to M3.6.2 (Level-R storage)
|
||||
|
||||
**ETA**: ~5-15 minutes once Forgejo CI processes the job
|
||||
Reference in New Issue
Block a user