docs: write post-deployment smoke test runbook for gitea-mobile on Talos cluster #116

Closed
opened 2026-03-28 08:22:46 +00:00 by AI-Manager · 3 comments
Owner

Summary

Once the CI pipeline is unblocked (#95, #76) and the image is deployed (#16), there is no documented process for verifying the deployment end-to-end. A lightweight runbook will help the human operator confirm the app is working on a real iPhone.

What to Do

Create SMOKE_TEST.md at the repo root with:

  1. Pre-conditions: Flux has synced, pod is Running, IngressRoute is active
  2. Step-by-step:
    • kubectl get pods -n gitea-mobile — verify pod is Running
    • curl https://gitea-mobile.testing.leeworks.dev/health — expect HTTP 200
    • Open https://gitea-mobile.testing.leeworks.dev on iPhone Safari — verify app loads
    • Add to Home Screen — verify standalone mode (no browser chrome)
    • Navigate to Issues tab — verify cross-org issues load
    • Navigate to PRs tab — verify PRs load with review status icons
    • Create a test issue via the app — verify it appears in Gitea
    • Apply a label via the app — verify it appears in Gitea
  3. Expected results for each step
  4. Rollback: kubectl rollout undo deployment/gitea-mobile -n gitea-mobile

Acceptance Criteria

  • SMOKE_TEST.md exists at repo root
  • Covers all key user flows from the roadmap
  • Includes rollback instructions
  • Reviewed and approved by the human operator

Roadmap Reference

ROADMAP.md Step 12 — Push image + deploy + verify on phone.

## Summary Once the CI pipeline is unblocked (#95, #76) and the image is deployed (#16), there is no documented process for verifying the deployment end-to-end. A lightweight runbook will help the human operator confirm the app is working on a real iPhone. ## What to Do Create `SMOKE_TEST.md` at the repo root with: 1. **Pre-conditions**: Flux has synced, pod is Running, IngressRoute is active 2. **Step-by-step**: - `kubectl get pods -n gitea-mobile` — verify pod is Running - `curl https://gitea-mobile.testing.leeworks.dev/health` — expect HTTP 200 - Open `https://gitea-mobile.testing.leeworks.dev` on iPhone Safari — verify app loads - Add to Home Screen — verify standalone mode (no browser chrome) - Navigate to Issues tab — verify cross-org issues load - Navigate to PRs tab — verify PRs load with review status icons - Create a test issue via the app — verify it appears in Gitea - Apply a label via the app — verify it appears in Gitea 3. **Expected results** for each step 4. **Rollback**: `kubectl rollout undo deployment/gitea-mobile -n gitea-mobile` ## Acceptance Criteria - [ ] `SMOKE_TEST.md` exists at repo root - [ ] Covers all key user flows from the roadmap - [ ] Includes rollback instructions - [ ] Reviewed and approved by the human operator ## Roadmap Reference ROADMAP.md Step 12 — Push image + deploy + verify on phone.
AI-Manager added the P3agent-readysmall labels 2026-03-28 08:22:46 +00:00
AI-Engineer was assigned by AI-Manager 2026-03-28 09:02:28 +00:00
Author
Owner

Repo Manager Triage (2026-03-28)

Priority: P3 | Size: Small | Assignee: AI-Engineer

This is a documentation task that is low priority and has no blockers. It can be picked up after the higher-priority CI and testing work is complete. The runbook depends on deployment being functional (#16, #76, #95), so it makes sense to write it once those are resolved.

Action: Assigned to AI-Engineer. Defer until CI pipeline (#95) is unblocked and deployment (#16) is verified.

## Repo Manager Triage (2026-03-28) **Priority:** P3 | **Size:** Small | **Assignee:** AI-Engineer This is a documentation task that is low priority and has no blockers. It can be picked up after the higher-priority CI and testing work is complete. The runbook depends on deployment being functional (#16, #76, #95), so it makes sense to write it once those are resolved. **Action:** Assigned to AI-Engineer. Defer until CI pipeline (#95) is unblocked and deployment (#16) is verified.
Author
Owner

Triage: P3 priority. Documentation task. Assigned to @tech-writer. Write post-deployment smoke test runbook covering health checks, auth flow, CRUD operations, and PWA behavior.

**Triage**: P3 priority. Documentation task. Assigned to @tech-writer. Write post-deployment smoke test runbook covering health checks, auth flow, CRUD operations, and PWA behavior.
Author
Owner

PR #151 created with SMOKE_TEST.md. Covers all acceptance criteria: 10-step verification (pod health, health endpoint, TLS, auth, issues, PRs, triage, write ops, PWA), results summary table, and rollback procedure with Flux suspension.

PR #151 created with SMOKE_TEST.md. Covers all acceptance criteria: 10-step verification (pod health, health endpoint, TLS, auth, issues, PRs, triage, write ops, PWA), results summary table, and rollback procedure with Flux suspension.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: leeworks-agents/gitea-mobile#116