无 CI/CD 部署助手
语言: English | 简体中文
引导无 CI/CD 平台环境下的可靠部署，采用三层架构：防错、验证、快速恢复。
三层部署架构
Layer 1：防止错误部署 Layer 2：验证正确性 Layer 3：快速恢复
set -euo pipefail Smoke Test + /health Blue-Green 切换
版本 tag 强制 版本号比对 rollback.sh < 30s
deploy.lock 并发守卫 验证失败自动回滚
引导式问答
| 问题 | 选项 | 影响 |
|---|
| 项目类型 | node / python / go / docker | 构建命令 |
| 部署目标 | SSH+rsync / Docker Compose | 传输方式 |
| Blue-Green 支持 | yes / no | rollback.sh 是否生成 |
| 健康检查 URL | URL 输入 | verify.sh 目标 |
| 版本来源 | VERSION 文件 / package.json / git tag | 版本比对逻辑 |
生成的脚本组
deploy.sh — 主要部署脚本
#!/usr/bin/env bash
set -euo pipefail
LOCK_FILE="/tmp/deploy.lock"
trap "rm -f $LOCK_FILE" EXIT
if [ -f "$LOCK_FILE" ]; then
echo "❌ 已有部署进行中（PID: $(cat $LOCK_FILE)）"
exit 1
fi
echo $$ > "$LOCK_FILE"
CURRENT_TAG=$(git describe --exact-match --tags HEAD 2>/dev/null || echo "")
if [ -z "$CURRENT_TAG" ]; then
echo "❌ HEAD 没有版本 tag。请执行：git tag vX.Y.Z && git push --tags"
exit 1
fi
echo "[1/4] 执行测试..."
echo "[2/4] 构建产物..."
echo "[3/4] 同步至服务器..."
rsync -avz --delete ./dist/ {USER}@{SERVER}:/app/
echo "[4/4] 验证部署..."
./verify.sh || { echo "验证失败，启动回滚..."; ./rollback.sh; exit 1; }
echo "{\"timestamp\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"version\":\"$CURRENT_TAG\",\"operator\":\"$(whoami)\",\"result\":\"success\"}" >> /var/log/deployments.jsonl
echo "✅ 部署成功：$CURRENT_TAG"
verify.sh — Smoke Test
#!/usr/bin/env bash
set -euo pipefail
HEALTH_URL="${HEALTH_URL:-{HEALTH_URL}}"
EXPECTED_VERSION=$(cat VERSION)
for i in $(seq 1 3); do
RESPONSE=$(curl -sf --max-time 10 "$HEALTH_URL" 2>/dev/null) && break
echo "健康检查第 $i/3 次失败，5 秒后重试..."
sleep 5
done
ACTUAL_VERSION=$(echo "$RESPONSE" | python3 -c "import json,sys; print(json.load(sys.stdin)['version'])")
if [ "$ACTUAL_VERSION" != "$EXPECTED_VERSION" ]; then
echo "❌ 版本不符！预期 $EXPECTED_VERSION，实际 $ACTUAL_VERSION"
exit 1
fi
echo "✅ 版本验证通过：$ACTUAL_VERSION"
rollback.sh — Blue-Green 回滚
#!/usr/bin/env bash
set -euo pipefail
CURRENT=$(readlink /app/current 2>/dev/null || echo "/app/blue")
TARGET=$([[ "$CURRENT" == *"green"* ]] && echo "/app/blue" || echo "/app/green")
ln -sfn "$TARGET" /app/current
nginx -s reload
echo "✅ 已回滚至 $TARGET ($(date -u +%Y-%m-%dT%H:%M:%SZ))"
echo "{\"timestamp\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"event\":\"rollback\",\"from\":\"$CURRENT\",\"to\":\"$TARGET\",\"operator\":\"$(whoami)\"}" >> /var/log/deployments.jsonl
Makefile
.PHONY: deploy rollback verify status
deploy:
@./deploy.sh
rollback:
@./rollback.sh
verify:
@./verify.sh
status:
@echo "当前 slot：$$(readlink /app/current 2>/dev/null || echo 'N/A')"
@curl -s $${HEALTH_URL:-http://localhost/health} | python3 -m json.tool 2>/dev/null || echo "健康检查失败"
输出确认清单
脚本生成后，AI 助手必须确认：
使用方式
/deploy
/deploy node
/deploy docker
/deploy --verify-only
下一步引导
/deploy 完成后，AI 助手应建议：
部署脚本已生成，建议下一步：
chmod +x deploy.sh verify.sh rollback.sh — 设置执行权限make verify — 测试健康检查配置git tag v1.0.0 && git push --tags — 创建版本 tagmake deploy — 执行第一次部署
参考
版本历史
| 版本 | 日期 | 变更说明 |
|---|
| 1.0.0 | 2026-04-26 | 初始版本 — XSPEC-085 Phase 1b |
授权
CC BY 4.0 — 文档内容
