Docs

Appearance

Back to App

Tasks ​

  • [x] Audit deployment parity and define chart behavior.
  • [x] Implement workloads, storage, routing, and migration gating.
  • [x] Add configuration examples and operator documentation.
  • [x] Verify render matrix and migration gate failure/success behavior.
  • [x] Integrate Task/CI checks and update global checklist.

Release publication ​

  • [x] Rename chart to camply-web while preserving default resource names.
  • [x] Package stable release versions with matching image defaults and add GHCR publication.
  • [x] Run chart publication only after matching images succeed; use runtime credentials.
  • [x] Add archive/render, invalid-context, and workflow publication regressions.
  • [x] Verify publication checks on Helm 3/4 and update operator documentation.

Verification ​

  • task fix, task lint, task check, and pre-commit hooks passed.
  • Full task test passed: 824 backend tests (23 opt-in skips), 68 packaging tests, 339 frontend tests, 15 release checks, and Pages configuration/bundling/HTTP checks.
  • task helm:test: 60 passed, one opt-in cluster smoke skipped, on Helm 3.19.0 and 4.3.0.
  • task helm:smoke: all 61 tests passed locally on ARM64 with Helm 3.19.0/4.3.0 and kind 0.33.0 / Kubernetes 1.37.0, using an image built from this checkout. Verified migration ordering, Helm connection checks, successful upgrade with PostgreSQL data preservation (SELECT value FROM helm_upgrade_proof returned 42), failed-migration startup blocking for backend, worker, and beat, and rollback using database checkpoints while preserving a newer revision and data (42|7).
  • task backend:check -- tests/helm deploy/helm/files and API contract checks passed.
  • Kubeconform accepted all 25 default Kubernetes resources; chart packaging passed.
  • Actionlint accepted the workflow changes with its optional ShellCheck integration disabled.
  • Registry pushes were recorded locally; actual GHCR publication runs from the stable release workflow.

Operator experience ​

  • [x] Add schema, probe, monitoring, notes/test, and readiness regressions.
  • [x] Implement schema validation and configurable probes.
  • [x] Make API readiness depend on the database while keeping liveness independent.
  • [x] Add ServiceMonitor, install notes, and a read-only Helm connection test.
  • [x] Run source-image lifecycle smoke in CI with upgrade/data preservation checks.
  • [x] Complete validation and update documentation and PR.

Operator verification: Helm 3/4 regressions cover schema failures, probe replacement/disablement, monitor selection, rendered notes, and the test hook. API readiness and liveness checks, full project checks, and the local source-image Kubernetes lifecycle smoke passed.

Local cluster testing ​

  • [x] Diagnose local storage exhaustion and document smoke-test disk requirements.
  • [x] Initialize the CI lifecycle job's Task/Python environment before installing Helm/kind.
  • [x] Reproduce the missing CI setup with a regression, then verify the fix.
  • [x] Complete the local Kubernetes lifecycle test after freeing sufficient disk space.

Follow-up validation: the source image builds and the complete local lifecycle smoke passed (55 tests, 135 seconds). Resource and log diagnostics are retained under tmp/camply-helm-c756fd0e/. The test-owned cluster was removed. The same lifecycle smoke also passed in CI on AMD64; all checks in that run passed. Approved Docker cleanup preserved the existing running services while removing unused data.

Independent review fixes ​

  • [x] Reproduce rollback gate deletion and missing Prometheus scrape reload.
  • [x] Record successful migrations in database-backed checkpoints without additional Kubernetes permissions or retained Jobs; document backup and rollback behavior.
  • [x] Hash the rendered Prometheus configuration and verify worker toggle/scale behavior.
  • [x] Extend the lifecycle test with an additive synthetic schema change, a newer revision unknown to the image, and rollback recovery using a recreated Job and the original database checkpoint.
  • [x] Preserve connection-test logs until the next hook invocation so Helm 3's helm test --logs succeeds.
  • [x] Complete live rollback verification and project quality gates; update the PR.

Review verification: all 61 Helm tests passed with Helm 3.19.0 (144 seconds) and 4.3.0 (138 seconds). Both source-image lifecycle runs recreated the original migration Job on rollback and reused its database checkpoint while preserving future_helm_revision, the additive column, and 42|7 data. The checkpoint table contained exactly two successful entries; the failed migration added none. Prometheus regressions verify that worker enablement changes the pod checksum, while scaling replicas leaves it unchanged. Full project checks and pre-commit passed (824 backend, 68 packaging, 339 frontend tests, release and Pages checks).

Matching OCI chart and image tags ​

  • [x] Audit chart/image publication and specify matching tag behavior.
  • [x] Package/publish matching release, major, SHA, and latest chart variants.
  • [x] Publish SHA/latest images and charts after successful main builds.
  • [x] Verify archives, images, invalid contexts, failures, workflow ordering, and OCI pulls.
  • [x] Update operator/release documentation and the global checklist.

Tag verification: task helm:test passed on Helm 3.19.0 and 4.3.0 (71 passed, one opt-in cluster smoke skipped), including real ORAS OCI layouts and Helm installs by digest for all aliases. task check, task lint, targeted publisher lint/types, and Actionlint passed. Release checks (15), backend tests (835, with 23 opt-in skips), packaging tests (68), and Pages checks passed. The default task test run reached the frontend and hit the existing Auth0 notification navigation timeout; it recurred in the parallel frontend rerun. The isolated App file passed (29), and the complete frontend suite passed with task frontend:test -- --maxWorkers=2 (339). No frontend files were changed. GHCR writes remain confined to the hosted publisher.

PR verification: the complete VITEST_MAX_WORKERS=2 task test command passed, including release, backend, packaging, frontend, and Pages checks. Helm 3/4 checks and pre-commit hooks also passed. A screenshot of the actual Helm test output is recorded in publication evidence.