speccore 8.3.290 → 8.3.296

package/templates/deploy-java/README.md

@@ -0,0 +1,212 @@
+# Java 后端部署指南
+
+> 本目录提供 Java（Spring Boot）后端服务的部署模板和示例脚本。
+
+---
+
+## 目录结构
+
+```
+deploy-java/
+├── spring-boot.service    # systemd service 文件模板
+├── deploy.sh              # 服务器端部署脚本（备份 → 替换 → 重启 → 健康检查）
+├── Dockerfile             # 多阶段构建 Dockerfile 示例
+└── README.md              # 本文件
+```
+
+---
+
+## 部署方式一：systemd + SSH（推荐测试环境）
+
+### 1. 服务器端准备（只需一次）
+
+```bash
+# 创建部署目录
+sudo mkdir -p /opt/services/order-service
+sudo mkdir -p /var/log/order-service
+
+# 复制 service 文件（将 spring-boot.service 中的占位符替换后复制）
+# 注意：文件名必须与 PROJECT.yaml 中的 platform.name 一致
+sudo cp spring-boot.service /etc/systemd/system/order-service.service
+
+# 重载 systemd
+sudo systemctl daemon-reload
+sudo systemctl enable order-service
+```
+
+### 2. 替换 service 文件中的占位符
+
+| 占位符 | 示例值 | 说明 |
+|--------|--------|------|
+| `{{APP_NAME}}` | `order-service` | 应用名，与 platform.name 一致 |
+| `{{DEPLOY_USER}}` | `deployer` | 运行服务的系统用户 |
+| `{{DEPLOY_DIR}}` | `/opt/services/order-service` | jar 文件所在目录 |
+| `{{PROFILE}}` | `staging` | Spring Boot profile |
+| `{{JVM_XMS}}` | `512m` | JVM 初始堆内存 |
+| `{{JVM_XMX}}` | `1024m` | JVM 最大堆内存 |
+
+### 3. PROJECT.yaml 配置
+
+```yaml
+platforms:
+  - name: order-service
+    type: backend
+    code_path: ./order-service
+    default_branch: main
+    deploy:
+      staging:
+        type: ssh
+        build_cmd: mvn clean package -DskipTests -P staging
+        output_dir: target
+        host: deployer@staging-server.example.com:22
+        key: ~/.ssh/id_rsa
+        remote_dir: /opt/services/order-service
+        script: sudo systemctl restart order-service
+```
+
+### 4. 数据库 / Redis 配置切换
+
+**方式 A：Spring Boot Profiles（推荐）**
+
+```yaml
+# src/main/resources/application-staging.yml
+spring:
+  datasource:
+    url: jdbc:mysql://staging-db:3306/order_db
+    username: ${DB_USER}
+    password: ${DB_PASS}
+  data:
+    redis:
+      host: staging-redis
+      port: 6379
+      password: ${REDIS_PASS}
+```
+
+**方式 B：环境变量注入（配合 systemd）**
+
+在 `spring-boot.service` 的 `[Service]` 段增加：
+```ini
+Environment="DB_USER=order_user"
+Environment="DB_PASS=secret"
+Environment="REDIS_PASS=redis_secret"
+```
+
+在 `application.yml` 中引用：
+```yaml
+spring:
+  datasource:
+    username: ${DB_USER}
+    password: ${DB_PASS}
+```
+
+### 5. 部署流程
+
+```bash
+speccore deploy --env staging --platform order-service
+```
+
+执行流程：
+1. 本地执行 `mvn clean package -DskipTests -P staging`
+2. SCP 上传 `target/*.jar` 到服务器 `/opt/services/order-service/`
+3. SSH 执行 `sudo systemctl restart order-service`
+4. systemd 自动完成：停止旧进程 → 启动新 jar → 写入日志
+
+---
+
+## 部署方式二：Docker（推荐生产环境）
+
+### 1. 准备 Dockerfile
+
+将 `Dockerfile` 复制到 Java 工程根目录（与 `pom.xml` 同级）。
+
+### 2. PROJECT.yaml 配置
+
+```yaml
+platforms:
+  - name: order-service
+    type: backend
+    code_path: ./order-service
+    default_branch: main
+    deploy:
+      production:
+        type: docker
+        dockerfile: ./Dockerfile
+        registry: registry.example.com
+        image: my-project/order-service
+        tag: production
+```
+
+### 3. 部署流程
+
+```bash
+speccore deploy --env production --platform order-service
+```
+
+执行流程：
+1. 本地 `docker build`
+2. 推送到镜像仓库 `registry.example.com/my-project/order-service:production`
+3. 服务器端拉取镜像并运行（需配合额外的部署脚本或 CI/CD）
+
+> 提示：如果服务器需要 SSH 登录后执行 `docker pull && docker run`，可将 deploy 类型改为 `script`，编写自定义脚本。
+
+---
+
+## 部署方式三：自定义脚本（最灵活）
+
+如果 systemd 和 Docker 都不满足需求，使用 `script` 类型：
+
+```yaml
+deploy:
+  staging:
+    type: script
+    build_cmd: mvn clean package -DskipTests
+    script: ./scripts/deploy-custom.sh
+```
+
+---
+
+## 数据库 / Redis 连接检查清单
+
+| 检查项 | 说明 |
+|--------|------|
+| 网络连通性 | 服务器能否 ping 通数据库和 Redis 主机 |
+| 防火墙 / 安全组 | 数据库端口（3306/5432）和 Redis 端口（6379）是否开放 |
+| 用户名密码 | 确认 staging / production 环境的凭据正确 |
+| 数据库存在性 | 目标数据库是否已创建 |
+| 连接池配置 | HikariCP 的最大连接数是否超过数据库限制 |
+| 时区 | JVM 时区、数据库时区、应用时区是否一致 |
+
+---
+
+## 常见问题
+
+**Q: 部署后服务起不来，怎么排查？**
+
+```bash
+# 查看服务状态
+sudo systemctl status order-service --no-pager
+
+# 查看日志
+sudo journalctl -u order-service -f
+
+# 查看应用日志
+tail -f /var/log/order-service/app.log
+```
+
+**Q: 如何回滚到上一个版本？**
+
+```bash
+cd /opt/services/order-service
+# 找到最新备份
+LATEST=$(ls -t backups/*.jar | head -1)
+cp "$LATEST" order-service.jar
+sudo systemctl restart order-service
+```
+
+**Q: 多个环境（staging / production）如何管理配置？**
+
+使用 Spring Boot profiles：
+- `application-staging.yml` — 测试环境
+- `application-production.yml` — 生产环境
+- 打包时激活 profile：`-P staging`
+- 运行时激活 profile：`--spring.profiles.active=staging`

package/templates/deploy-java/deploy.sh

@@ -0,0 +1,120 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════
+# Java 后端部署脚本（服务器端执行）
+# ═══════════════════════════════════════════════════════════
+#
+# 用法：
+#   ./deploy.sh <app-name> [profile]
+#
+# 示例：
+#   ./deploy.sh order-service staging
+#   ./deploy.sh order-service production
+#
+# 该脚本由 speccore deploy 通过 SSH 调用，也可手动在服务器上执行。
+# 功能：备份旧 jar → 替换新 jar → 重启 systemd 服务 → 健康检查
+# ═══════════════════════════════════════════════════════════
+
+set -euo pipefail
+
+APP_NAME="${1:-}"
+PROFILE="${2:-staging}"
+
+if [ -z "$APP_NAME" ]; then
+  echo "用法: $0 <app-name> [profile]"
+  echo "示例: $0 order-service staging"
+  exit 1
+fi
+
+DEPLOY_DIR="/opt/services/$APP_NAME"
+BACKUP_DIR="$DEPLOY_DIR/backups"
+LOG_DIR="/var/log/$APP_NAME"
+JAR_FILE="$DEPLOY_DIR/$APP_NAME.jar"
+NEW_JAR="$DEPLOY_DIR/$APP_NAME-new.jar"
+HEALTH_URL="http://localhost:8080/actuator/health"  # 根据实际端口和路径修改
+
+echo "========================================"
+echo "部署应用: $APP_NAME"
+echo "环境: $PROFILE"
+echo "========================================"
+
+# ── 1. 预检 ──
+if [ ! -f "$NEW_JAR" ]; then
+  echo "❌ 错误：未找到新 jar 文件: $NEW_JAR"
+  echo "   请确保 speccore deploy 已成功上传 jar 到该路径"
+  exit 1
+fi
+
+# ── 2. 创建必要目录 ──
+mkdir -p "$BACKUP_DIR" "$LOG_DIR"
+
+# ── 3. 备份旧版本 ──
+if [ -f "$JAR_FILE" ]; then
+  BACKUP_NAME="$BACKUP_DIR/$APP_NAME-$(date +%Y%m%d-%H%M%S).jar"
+  cp "$JAR_FILE" "$BACKUP_NAME"
+  echo "✅ 旧版本已备份: $BACKUP_NAME"
+
+  # 只保留最近 5 个备份
+  ls -t "$BACKUP_DIR"/*.jar 2>/dev/null | tail -n +6 | xargs -r rm -f
+  echo "🧹 已清理旧备份（保留最近 5 个）"
+else
+  echo "ℹ️ 首次部署，无旧版本需要备份"
+fi
+
+# ── 4. 替换 jar ──
+mv "$NEW_JAR" "$JAR_FILE"
+echo "✅ 已替换 jar: $JAR_FILE"
+
+# ── 5. 确保 systemd service 文件存在 ──
+SERVICE_FILE="/etc/systemd/system/$APP_NAME.service"
+if [ ! -f "$SERVICE_FILE" ]; then
+  echo "⚠️ 警告：systemd service 文件不存在: $SERVICE_FILE"
+  echo "   请从 templates/deploy-java/spring-boot.service 复制并修改后部署到该路径"
+  echo "   然后执行: sudo systemctl daemon-reload && sudo systemctl enable $APP_NAME"
+  exit 1
+fi
+
+# ── 6. 重启服务 ──
+echo "🔄 重启服务..."
+sudo systemctl daemon-reload
+sudo systemctl restart "$APP_NAME"
+
+# ── 7. 等待启动 ──
+echo "⏳ 等待服务启动（最多 30 秒）..."
+for i in {1..30}; do
+  sleep 1
+  if systemctl is-active --quiet "$APP_NAME"; then
+    echo "✅ 服务已启动"
+    break
+  fi
+  if [ "$i" -eq 30 ]; then
+    echo "❌ 服务启动超时"
+    echo "📋 日志 tail -n 50:"
+    sudo journalctl -u "$APP_NAME" --no-pager -n 50 || true
+    exit 1
+  fi
+done
+
+# ── 8. 健康检查 ──
+echo "🏥 执行健康检查..."
+for i in {1..10}; do
+  sleep 2
+  if curl -sf "$HEALTH_URL" >/dev/null 2>&1; then
+    echo "✅ 健康检查通过: $HEALTH_URL"
+    break
+  fi
+  if [ "$i" -eq 10 ]; then
+    echo "⚠️ 健康检查未通过，但服务已启动"
+    echo "   请手动检查: curl $HEALTH_URL"
+  fi
+done
+
+# ── 9. 显示状态 ──
+echo ""
+echo "========================================"
+echo "📋 部署完成"
+echo "========================================"
+sudo systemctl status "$APP_NAME" --no-pager || true
+echo ""
+echo "日志查看:"
+echo "  journalctl -u $APP_NAME -f"
+echo "  tail -f $LOG_DIR/app.log"

package/templates/deploy-java/spring-boot.service

@@ -0,0 +1,35 @@
+[Unit]
+Description={{APP_NAME}}
+After=network.target
+
+[Service]
+Type=simple
+User={{DEPLOY_USER}}
+Group={{DEPLOY_USER}}
+WorkingDirectory={{DEPLOY_DIR}}
+
+# Spring Boot Profile（按环境切换：staging / production / test）
+Environment="SPRING_PROFILES_ACTIVE={{PROFILE}}"
+
+# JVM 参数
+Environment="JAVA_OPTS=-Xms{{JVM_XMS}} -Xmx{{JVM_XMX}} -Dfile.encoding=UTF-8 -Djava.security.egd=file:/dev/./urandom"
+
+# 启动命令
+ExecStart=/usr/bin/java $JAVA_OPTS -jar {{APP_NAME}}.jar
+
+# 优雅停止（SIGTERM 触发 Spring Boot 的 shutdown hook）
+ExecStop=/bin/kill -SIGTERM $MAINPID
+
+# 进程管理
+Restart=on-failure
+RestartSec=10
+StartLimitInterval=60s
+StartLimitBurst=3
+
+# 日志输出（systemd 240+ 支持 append 模式）
+# 旧版本 systemd 可改用：StandardOutput=file:/var/log/{{APP_NAME}}/app.log
+StandardOutput=append:/var/log/{{APP_NAME}}/app.log
+StandardError=append:/var/log/{{APP_NAME}}/error.log
+
+[Install]
+WantedBy=multi-user.target

package/templates/deploy-nginx/README.md

@@ -0,0 +1,59 @@
+# Nginx 服务器部署指南（纯服务器，非 Docker）
+
+> 本目录提供 **ssh 类型部署**场景下前端站点的 Nginx 服务器端配置模板。
+> Docker 场景（Nginx 容器托管前端）请使用 `templates/deploy-docker/nginx.conf`。
+
+---
+
+## 两种 Nginx 场景怎么选
+
+| 场景 | 部署类型 | 配置文件 | Nginx 位置 |
+|:---|:---|:---|:---|
+| **纯服务器**：构建产物上传到服务器 Nginx 静态目录，后端跑进程/systemd | `ssh`（推荐）/ `sftp` | 本目录 `nginx-site.conf` | 服务器 `/etc/nginx/conf.d/` |
+| **容器化**：前端打成镜像由 Nginx 容器托管 | `docker` | `deploy-docker/nginx.conf` | 镜像内 `/etc/nginx/conf.d/` |
+
+## 快速开始（前端 ssh 部署 + 服务器 Nginx 托管）
+
+```bash
+# 1. 服务器端（只需一次）：复制站点配置并替换占位符
+sudo cp nginx-site.conf /etc/nginx/conf.d/admin-web.conf
+sudo sed -i 's/{{DOMAIN}}/admin.example.com/; s|{{APP_DIR}}|/var/www/html/admin-web|; s|{{BACKEND_HOST}}|127.0.0.1:8080|' /etc/nginx/conf.d/admin-web.conf
+sudo nginx -t && sudo nginx -s reload
+
+# 2. PROJECT.yaml 配置 ssh 类型部署
+#    remote_dir: /var/www/html/admin-web
+#    script: sudo nginx -s reload
+
+# 3. 部署（构建 → 上传 → 重载 Nginx）
+speccore deploy --env staging --platform admin-web
+```
+
+## 模板包含内容
+
+- SPA 路由回退（`try_files` → `/index.html`）
+- gzip 压缩
+- 静态资源长期缓存（`immutable`）
+- `/api/` 反向代理到后端（同机 `127.0.0.1:8080` 或跨机内网地址）
+- WebSocket 升级（注释备用）
+- 健康检查端点透传（`/healthz` → 后端 `/actuator/health`，注释备用）
+- HTTPS server 块（证书就绪后启用）
+- 隐藏文件访问拦截
+
+## 占位符
+
+| 占位符 | 说明 | 示例 |
+|:---|:---|:---|
+| `{{DOMAIN}}` | 站点域名或 IP | `admin.example.com` |
+| `{{APP_DIR}}` | 静态资源目录（= `remote_dir`） | `/var/www/html/admin-web` |
+| `{{BACKEND_HOST}}` | 后端地址 | `127.0.0.1:8080` |
+
+## 与冒烟测试联动
+
+部署完成后可在 `.speccore/environments/{env}.yaml` 的 `tests.base_urls` 配置站点地址，
+`speccore verify` 的部署后冒烟将自动访问验证：
+
+```yaml
+tests:
+  base_urls:
+    admin-web: https://admin.example.com
+```

package/templates/deploy-nginx/nginx-site.conf

@@ -0,0 +1,103 @@
+# ═══════════════════════════════════════════════════════════
+# Nginx 服务器站点配置模板（纯服务器部署，非 Docker 场景）
+# ═══════════════════════════════════════════════════════════
+#
+# 适用场景：speccore deploy 的 ssh 类型部署，前端构建产物
+#   上传到 Nginx 服务器静态目录，后端以进程/服务方式跑在
+#   同一台（或另一台）服务器上。
+#
+# 用法：
+#   1. 复制本文件到服务器: /etc/nginx/conf.d/<your-site>.conf
+#      （或 /etc/nginx/sites-available/ + sites-enabled 软链）
+#   2. 替换 {{占位符}}
+#   3. 校验并重载: sudo nginx -t && sudo nginx -s reload
+#
+# 与 PROJECT.yaml 的对应关系（ssh 类型部署）：
+#   remote_dir  → 下方 root 指向的目录
+#   script      → sudo nginx -s reload（部署完成后重载配置）
+#
+# 占位符说明：
+#   {{DOMAIN}}        站点域名（或服务器 IP）
+#   {{APP_DIR}}       静态资源目录（= remote_dir，如 /var/www/html/admin-web）
+#   {{BACKEND_HOST}}  后端地址（同机为 127.0.0.1:8080，跨机为内网 IP:端口）
+# ═══════════════════════════════════════════════════════════
+
+# ── HTTP（开发/测试环境，或 HTTPS 前的重定向入口）──
+server {
+    listen 80;
+    server_name {{DOMAIN}};
+
+    # 有证书后启用 HTTPS，取消注释并将整块 HTTP 改为重定向：
+    # return 301 https://$host$request_uri;
+
+    include /etc/nginx/conf.d/_site-common.conf;
+}
+
+# ── HTTPS（生产环境，证书就绪后启用）──
+# server {
+#     listen 443 ssl http2;
+#     server_name {{DOMAIN}};
+#
+#     ssl_certificate     /etc/nginx/ssl/{{DOMAIN}}.pem;
+#     ssl_certificate_key /etc/nginx/ssl/{{DOMAIN}}.key;
+#     ssl_protocols       TLSv1.2 TLSv1.3;
+#     ssl_session_cache   shared:SSL:10m;
+#
+#     include /etc/nginx/conf.d/_site-common.conf;
+# }
+
+# ── 站点公共配置（HTTP/HTTPS 共用，独立成文件避免重复）──
+# 保存为 /etc/nginx/conf.d/_site-common.conf 后 include，
+# 或直接展开合并进上方 server 块。
+
+# 静态资源根目录（= PROJECT.yaml 中 ssh 类型的 remote_dir）
+root {{APP_DIR}};
+index index.html;
+
+# gzip 压缩（减少传输体积）
+gzip on;
+gzip_min_length 1k;
+gzip_comp_level 5;
+gzip_types text/plain text/css application/javascript application/json image/svg+xml;
+
+# ── 前端路由（SPA 应用）──
+location / {
+    try_files $uri $uri/ /index.html;
+}
+
+# ── 静态资源长期缓存 ──
+location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {
+    expires 1y;
+    add_header Cache-Control "public, immutable";
+}
+
+# ── API 反向代理到后端（同机后端）──
+location /api/ {
+    proxy_pass http://{{BACKEND_HOST}}/api/;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_connect_timeout 10s;
+    proxy_read_timeout 60s;
+}
+
+# ── WebSocket 升级（后端含长连接/推送时启用）──
+# location /ws {
+#     proxy_pass http://{{BACKEND_HOST}};
+#     proxy_http_version 1.1;
+#     proxy_set_header Upgrade $http_upgrade;
+#     proxy_set_header Connection "upgrade";
+#     proxy_read_timeout 3600s;
+# }
+
+# ── 后端健康检查端点透传（部署后验证用）──
+# location = /healthz {
+#     proxy_pass http://{{BACKEND_HOST}}/actuator/health;
+#     access_log off;
+# }
+
+# ── 禁止访问隐藏文件 ──
+location ~ /\. {
+    deny all;
+}

package/templates/deploy-scripts/README.md

@@ -0,0 +1,61 @@
+# 通用部署脚本模板
+
+> 本目录提供 `script` 类型部署的**开箱即用脚本实体**，覆盖 Jenkins 触发、FTP 上传、密码 SSH、Compose 编排、Python 服务五类场景。
+> 对应 `templates/deploy-examples.yaml` 中 script 类型各节的注释示例。
+
+---
+
+## 脚本清单
+
+| 脚本 | 场景 | 依赖 | 关键环境变量 |
+|:---|:---|:---|:---|
+| `trigger-jenkins.sh <job>` | 触发 Jenkins 构建发布 | `curl` | `JENKINS_URL` `JENKINS_USER` `JENKINS_TOKEN` |
+| `deploy-ftp.sh [dir]` | 虚拟主机 FTP 上传（无 SSH 权限） | `lftp` | `FTP_USER` `FTP_PASS` `FTP_HOST` `FTP_REMOTE_DIR` |
+| `deploy-password-ssh.sh [dir]` | 密码认证 SSH 部署（无密钥） | `sshpass` | `SSH_USER` `SSH_PASSWORD` `SSH_HOST` `SSH_REMOTE_DIR` |
+| `deploy-compose.sh [file]` | 服务器端 Compose 编排部署 | `docker-compose` | — |
+| `deploy-python.sh [dir]` | Python gunicorn + systemd 部署 | `rsync` | `DEPLOY_HOST` `DEPLOY_DIR` `SERVICE_NAME` |
+
+## 目录组织约定
+
+部署脚本按「执行位置」分三处存放，各司其职：
+
+```
+① 包内模板 templates/deploy-*/
+   ├── deploy-scripts/        ← 通用脚本实体（本目录，script 类型直接引用）
+   ├── deploy-docker/         ← Docker 构建素材 + 服务器端容器管理脚本（deploy-remote.sh）
+   ├── deploy-java/           ← Java systemd/Docker 素材 + 服务器端脚本（deploy.sh）
+   └── deploy-nginx/          ← 纯服务器 Nginx 站点配置
+         ↓（npm 安装后用户手动 cp 到工程）
+
+② 用户项目 .speccore/environments/scripts/（init 自动生成）
+   ├── deploy.sh              ← 通用 script 类型骨架（TODO 待填）
+   ├── ecosystem.config.js    ← pm2 类型
+   ├── k8s-deployment.yaml    ← k8s 类型
+   ├── java-systemd.service / java-restart.sh ← ssh 类型 Java
+   └── values-{env}.yaml      ← helm 类型（按环境生成）
+         ↓（speccore deploy 按 script/pm2_config/output_dir 字段引用）
+
+③ 端工程内 scripts/（用户自维护）
+   ← 端专属脚本，config.script 用 ./scripts/xxx.sh 相对路径引用
+```
+
+> **路径解析（v8.3.296+）**：引擎对 `script` / `pm2_config` / k8s manifest / helm values 做双基准解析——先在端目录（code_path）找，回退项目根。`./scripts/xxx.sh` 与 `.speccore/environments/scripts/xxx` 两种写法都通。
+
+## 使用方式
+
+```yaml
+# PROJECT.yaml（script 类型）
+deploy:
+  staging:
+    type: script
+    build_cmd: npm run build
+    script: ./scripts/deploy-password-ssh.sh   # 端工程内脚本（推荐）
+    # 或引用项目根资产：
+    # script: .speccore/environments/scripts/deploy.sh
+```
+
+敏感信息（密码/token）一律通过环境变量注入，勿写入配置文件或 git：
+
+```bash
+SSH_USER=deployer SSH_PASSWORD=xxx SSH_HOST=server ./scripts/deploy-password-ssh.sh dist
+```

package/templates/deploy-scripts/deploy-compose.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════
+# Docker Compose 部署脚本（服务器端执行）
+# ═══════════════════════════════════════════════════════════
+# 用途：script 类型部署，服务器端统一拉取并启动前后端编排
+# 用法：./deploy-compose.sh [compose-file]
+# 示例：./deploy-compose.sh /opt/deploy/docker-compose.yml
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+COMPOSE_FILE="${1:-/opt/deploy/docker-compose.yml}"
+
+echo "🚀 Compose 部署: $COMPOSE_FILE"
+docker-compose -f "$COMPOSE_FILE" pull
+docker-compose -f "$COMPOSE_FILE" up -d
+
+echo "📋 运行状态:"
+docker-compose -f "$COMPOSE_FILE" ps
+echo "✅ 部署完成"

package/templates/deploy-scripts/deploy-ftp.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════
+# FTP 上传部署脚本（lftp）
+# ═══════════════════════════════════════════════════════════
+# 用途：script 类型部署，无 SSH 权限只有 FTP 的虚拟主机场景
+# 环境变量（由用户 shell 环境注入，勿写入 git）：
+#   FTP_USER / FTP_PASS / FTP_HOST / FTP_REMOTE_DIR
+# 用法：FTP_USER=u FTP_PASS=p FTP_HOST=h ./deploy-ftp.sh [本地目录]
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+LOCAL_DIR="${1:-dist}"
+FTP_REMOTE_DIR="${FTP_REMOTE_DIR:-/public_html}"
+
+if [ -z "${FTP_USER:-}" ] || [ -z "${FTP_PASS:-}" ] || [ -z "${FTP_HOST:-}" ]; then
+  echo "❌ 缺少环境变量: FTP_USER / FTP_PASS / FTP_HOST"
+  exit 1
+fi
+
+echo "🚀 FTP 上传: $LOCAL_DIR → $FTP_HOST:$FTP_REMOTE_DIR"
+
+lftp -u "$FTP_USER,$FTP_PASS" "$FTP_HOST" <<INNER_EOF
+set ssl:verify-certificate no
+mirror -R "$LOCAL_DIR" "$FTP_REMOTE_DIR"
+bye
+INNER_EOF
+
+echo "✅ 上传完成"

package/templates/deploy-scripts/deploy-password-ssh.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════
+# 密码认证 SSH 部署脚本（sshpass）
+# ═══════════════════════════════════════════════════════════
+# 用途：script 类型部署，无密钥只有密码的 SSH 场景
+# 前置：安装 sshpass（macOS: brew install sshpass；Ubuntu: apt-get install sshpass）
+# 环境变量（由用户 shell 环境注入，勿写入 git）：
+#   SSH_USER / SSH_PASSWORD / SSH_HOST / SSH_REMOTE_DIR
+# 用法：SSH_USER=u SSH_PASSWORD=p ./deploy-password-ssh.sh [本地目录]
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+LOCAL_DIR="${1:-dist}"
+SSH_REMOTE_DIR="${SSH_REMOTE_DIR:-/var/www/html}"
+
+if [ -z "${SSH_USER:-}" ] || [ -z "${SSH_PASSWORD:-}" ] || [ -z "${SSH_HOST:-}" ]; then
+  echo "❌ 缺少环境变量: SSH_USER / SSH_PASSWORD / SSH_HOST"
+  exit 1
+fi
+
+echo "🚀 SSH 上传: $LOCAL_DIR → $SSH_USER@$SSH_HOST:$SSH_REMOTE_DIR"
+
+sshpass -p "$SSH_PASSWORD" scp -r "$LOCAL_DIR"/* "$SSH_USER@$SSH_HOST:$SSH_REMOTE_DIR/"
+sshpass -p "$SSH_PASSWORD" ssh "$SSH_USER@$SSH_HOST" "sudo nginx -s reload"
+
+echo "✅ 部署完成"