https://github.com/tinywasm/deploy
Automated deployment service for Go applications. Receives webhooks from GitHub Actions, downloads releases, performs health checks, and handles automatic rollbacks.
https://github.com/tinywasm/deploy
Last synced: 4 months ago
JSON representation
Automated deployment service for Go applications. Receives webhooks from GitHub Actions, downloads releases, performs health checks, and handles automatic rollbacks.
- Host: GitHub
- URL: https://github.com/tinywasm/deploy
- Owner: tinywasm
- License: mit
- Created: 2026-02-14T12:46:18.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-14T21:35:52.000Z (4 months ago)
- Last Synced: 2026-02-15T03:43:05.464Z (4 months ago)
- Language: Go
- Size: 45.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# deploy
Automated Continuous Deployment (CD) agent for Windows/Linux Server. Receives webhooks from GitHub Actions via a configurable public Endpoint, downloads releases, performs health checks, and executes automatic rollbacks.
## Documentation
| Document | Description |
|---|---|
| [Architecture & Design](docs/ARQUITECTURE_DESIGN.md) | Executive summary, security model, workflow, and setup |
| [Implementation Guide](docs/IMPLEMENTATION_GUIDE.md) | **[TEMPORARY]** Phase 1 Windows work prompt |
| [System Components](docs/diagrams/COMPONENTS.md) | Directory layout, keyring, and network ports |
| [Process Flow](docs/diagrams/PROCESS_FLOW.md) | High-level deployment flow on Windows Server |
| [Deployment Workflow](docs/diagrams/WORKFLOW.md) | Detailed sequence diagram (GitHub Actions → Windows) |
| [Setup Flow](docs/diagrams/SETUP_FLOW.md) | Interactive first-run setup wizard flow |
## Quick Summary
- **Push-based**: GitHub Actions triggers deployment via POST to a configurable endpoint (set via the `DEPLOY_ENDPOINT` secret)
- **Security**: HMAC-SHA256 request validation + cross-platform keyring for secret storage
- **Resilient**: Automatic rollback if health check fails after deploy
- **Zero-dependency binary**: Single `.exe`, no runtime required
## Dependencies
- [`tinywasm/keyring`](../keyring) — Cross-platform secret storage (DPAPI on Windows, Keychain on macOS, Secret Service on Linux)