deploy

name	deploy
source	../../../../skills/deploy-assistant/SKILL.md
source_version	1.0.0
translation_version	1.0.0
last_synced	"2026-05-28T00:00:00.000Z"
scope	universal
description	[UDS] 無 CI/CD 平台環境下的可靠部署指引（不依賴 GitHub Actions / GitLab CI）。 Use when: deploying to VPS, air-gapped servers, or environments without CI/CD infrastructure. Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback, 無CI/CD, 部署.
allowed-tools	Read, Bash(cat VERSION:*), Bash(git describe:*), Bash(which nginx:*), Bash(which rsync:*)
argument-hint	[專案類型: node/python/docker/go]

無 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"

# 版本 tag 強制
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"
   1


 


 


 
rsync -avz --delete ./dist/ {USER}@{SERVER}:/app/

 
./verify.sh || {  ; ./rollback.sh;  1; }

  >> /var/log/deployments.jsonl