Execute Documenso production deployment checklist and rollback procedures.
Use when deploying Documenso integrations to production, preparing for launch,
or implementing go-live procedures.
Trigger with phrases like "documenso production", "deploy documenso",
"documenso go-live", "documenso launch checklist".
#!/bin/bash
set -euo pipefail
echo "=== Documenso Production Verification ==="
# Check API key
if [ -z "${DOCUMENSO_API_KEY:-}" ]; then
echo "FAIL: DOCUMENSO_API_KEY not set"; exit 1
fi
echo "OK: API key configured"
# Test connection
BASE="${DOCUMENSO_BASE_URL:-https://app.documenso.com/api/v1}"
STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
-H "Authorization: Bearer $DOCUMENSO_API_KEY" \
"$BASE/documents?page=1&perPage=1")
[ "$STATUS" = "200" ] && echo "OK: API connection ($STATUS)" || echo "FAIL: API connection ($STATUS)"
# Test webhook endpoint
WEBHOOK_URL="${DOCUMENSO_WEBHOOK_URL:-}"
if [ -n "$WEBHOOK_URL" ]; then
WH_STATUS=$(curl -s -o /dev/null -w "%{http_code}" "$WEBHOOK_URL")
echo "Webhook endpoint: $WH_STATUS"
fi
# Check health endpoint
HEALTH_URL="${APP_URL:-http://localhost:3000}/health/documenso"
HEALTH=$(curl -s "$HEALTH_URL" 2>/dev/null | jq -r '.status' 2>/dev/null || echo "unreachable")
echo "Health check: $HEALTH"
echo "=== Verification Complete ==="
Rollback Procedure
If issues occur after deployment:
1. Immediate: revert to previous container image / deployment
kubectl rollout undo deployment/signing-service
# or: vercel rollback
2. Verify rollback:
curl -s $APP_URL/health/documenso | jq '.status'
3. Investigate:
- Check deployment diff (what changed?)
- Review error logs for the deployment window
- Test the failed version in staging
4. Fix and re-deploy:
- Fix the root cause on a feature branch
- Test in staging
- Deploy with monitoring active
Go-Live Day Checklist
All checklist items above verified
Staging smoke test passed within last 24 hours
Team notified of deployment window
Monitoring dashboards open during deployment
Rollback procedure documented and accessible
Support contact for Documenso available (Discord or email)
First production document created and verified end-to-end
