From ece754e107709362348068124a6db2a070dce76e Mon Sep 17 00:00:00 2001
From: Thomas Brenner <t.brenner@nexus.local>
Date: Thu, 5 Feb 2026 09:30:00 +0000
Subject: [PATCH] Add deployment guide

---
 docs/deployment-guide.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 docs/deployment-guide.md

diff --git a/docs/deployment-guide.md b/docs/deployment-guide.md
new file mode 100644
index 0000000..f205716
--- /dev/null
+++ b/docs/deployment-guide.md
@@ -0,0 +1,37 @@
+# Deployment Guide
+
+## Pre-flight checklist
+
+- [ ] All tests pass in CI
+- [ ] Release tag created in Git
+- [ ] Changelog updated
+- [ ] Rollback plan documented in the release ticket
+
+## Steps
+
+1. Pull the release artifact from S3:
+   ```
+   aws s3 cp s3://nexus-releases/<version>.tar.gz ./dist.tar.gz
+   tar -xzf dist.tar.gz -C ./dist/
+   ```
+
+2. Run the deploy script:
+   ```
+   ./scripts/deploy.sh <version>
+   ```
+
+3. Verify with health checks:
+   ```
+   ./scripts/health-check.sh
+   ```
+
+4. If anything fails, roll back immediately:
+   ```
+   ./scripts/rollback.sh
+   ```
+
+## Emergency contacts
+
+- On-call engineer: PagerDuty rotation
+- Infra lead: t.brenner@nexus.local
+- SRE: o.neumann@nexus.local