50 lines
1023 B
Smarty
50 lines
1023 B
Smarty
# Deploy
|
|
|
|
Stack: {{STACK}}
|
|
Target: {{DEPLOY_TARGET}}<!-- e.g. Vercel, fly.io, Docker on VPS, k8s -->
|
|
|
|
## Prerequisites
|
|
|
|
- {{REQUIRED_TOOLS}}<!-- gh, fly, docker, kubectl, etc. -->
|
|
- Environment variables set in {{ENV_LOCATION}}<!-- .env / Vercel dashboard / GH secrets -->
|
|
|
|
## Build
|
|
|
|
```bash
|
|
{{BUILD_CMD}}
|
|
```
|
|
|
|
Verify the build artifact at `{{BUILD_OUTPUT_DIR}}` is non-empty before proceeding.
|
|
|
|
## Deploy
|
|
|
|
```bash
|
|
{{DEPLOY_CMD}}
|
|
```
|
|
|
|
## Verify
|
|
|
|
```bash
|
|
{{HEALTH_CHECK_CMD}}<!-- curl /healthz or equivalent -->
|
|
```
|
|
|
|
Expected response: `{{EXPECTED_RESPONSE}}`.
|
|
|
|
## Rollback
|
|
|
|
```bash
|
|
{{ROLLBACK_CMD}}<!-- e.g. fly releases rollback <id>, kubectl rollout undo, vercel rollback -->
|
|
```
|
|
|
|
## Common failures
|
|
|
|
| Symptom | Cause | Fix |
|
|
|---|---|---|
|
|
| {{SYMPTOM_1}} | {{CAUSE_1}} | {{FIX_1}} |
|
|
| Build fails on `{{COMMON_BUILD_ERR}}` | Likely env var missing | Check {{ENV_LOCATION}} has {{REQUIRED_VARS}} |
|
|
|
|
## Logs / monitoring
|
|
|
|
- Logs: `{{LOG_CMD}}`
|
|
- Monitoring: {{MONITORING_URL}}<!-- Grafana / Sentry / Vercel analytics -->
|