Skip to content

README.md

Latest commit

 

History

History
27 lines (19 loc) · 1.57 KB

README.md

File metadata and controls

27 lines (19 loc) · 1.57 KB

deploy

Automated Continuous Deployment (CD) framework for Windows/Linux. Designed around a Push/Pull model: includes a Puller agent that orchestrates updates on the server, and multiple Pusher implementations (Cloudflare, SSH, Webhooks) to trigger or execute deployments. Features automatic health checks and rollbacks.

Documentation

Document Description
Architecture & Design Executive summary, security model, workflow, and setup
Implementation Guide [TEMPORARY] Phase 1 Windows work prompt
System Components Directory layout, keyring, and network ports
Process Flow High-level deployment flow on Windows Server
Deployment Workflow Detailed sequence diagram (GitHub Actions → Windows)
Setup Flow Interactive first-run setup wizard flow

Quick Summary

  • Push/Pull Model: Decoupled architecture where a local Puller agent handles the lifecycle, triggered by external Pushers.
  • Security: HMAC-SHA256 request validation + cross-platform keyring for multi-service secret storage.
  • Resilient: Automatic health-check verification and atomic rollback if the new version fails.
  • Zero-dependency binary: Single .exe, no runtime required

Dependencies

  • tinywasm/keyring — Cross-platform secret storage (DPAPI on Windows, Keychain on macOS, Secret Service on Linux)