lms/specs/001-add-dokploy-deploy/manual-deploy.md

26 lines
868 B
Markdown

# Manual Deploy: triggering a specific commit or tag
Use cases:
- Trigger a release for a specific tag.
- Re-deploy a previous commit for rollback or testing.
Via Dokploy UI:
1. Open the Dokploy project for this repository.
2. Choose "New deployment" or similar action.
3. Enter the commit SHA or select a tag.
4. Optionally override `compose_path` or environment variables.
5. Start the deployment and monitor logs.
Via HTTP (example):
```bash
WEBHOOK=https://system.cloudarix.de/api/deploy/compose/JXSdfeHdc6wBKUEiJrX_9
curl -X POST "$WEBHOOK" \
-H "Content-Type: application/json" \
-d @specs/001-add-dokploy-deploy/contracts/manual-deploy-payload.json
```
Notes:
- Ensure payload includes `ref` or `commit_sha` field for deterministic deploys.
- When using HTTP payloads, Dokploy may require authentication or a secret; use Dokploy project-level secrets.