speccore 8.3.285 → 8.3.295

package/templates/deploy-examples.yaml

@@ -0,0 +1,436 @@
+# ═══════════════════════════════════════════════════════════
+# SpecCore 部署配置示例（v8.3.91+）
+# ═══════════════════════════════════════════════════════════
+#
+# 使用方式：
+#   1. 复制你需要的配置块到 PROJECT.yaml 的 platform.deploy 段
+#   2. 或复制到 .speccore/environments/{env}.yaml 的 platform 段
+#
+# 部署命令：
+#   speccore deploy --env staging --platform <端名>
+#   speccore deploy --env staging --all
+#   speccore deploy --env production --platform h5 --dry-run   # 预览模式
+#
+# ═══════════════════════════════════════════════════════════
+
+# ─────────────────────────────────────────
+# 1. SSH 部署（推荐：有独立服务器的场景）
+# ─────────────────────────────────────────
+#
+# 适用场景：前端构建后上传到 Nginx/Apache 静态目录，或后端上传到服务器重启
+#
+# 认证方式：
+#   方式 A — 密钥认证（推荐，更安全）：
+#     1) 本地生成密钥：ssh-keygen -t rsa -b 4096
+#     2) 上传公钥到服务器：ssh-copy-id -i ~/.ssh/id_rsa.pub user@host
+#     3) 配置 key 字段指向私钥路径
+#
+#   方式 B — 密码认证（v8.3.91+）：
+#     1) 安装 sshpass：
+#        macOS: brew install sshpass
+#        Ubuntu/Debian: apt-get install sshpass
+#     2) 配置 password 字段
+#
+ssh_key_example:
+  type: ssh
+  build_cmd: npm run build:staging
+  output_dir: dist
+  host: deployer@192.168.1.100:22
+  key: ~/.ssh/id_rsa
+  remote_dir: /var/www/html/h5
+  script: sudo nginx -s reload
+  pre_deploy:
+    - echo "开始部署到 staging..."
+  post_deploy:
+    - echo "部署完成"
+
+# SSH 密码认证示例
+ssh_password_example:
+  type: ssh
+  build_cmd: npm run build:staging
+  output_dir: dist
+  host: deployer@192.168.1.100:22
+  password: your-password-here          # SSH 密码（v8.3.91+，需安装 sshpass）
+  remote_dir: /var/www/html/h5
+  script: sudo nginx -s reload
+
+# ─────────────────────────────────────────
+# 2. SFTP 部署（无 SSH 权限，只有 SFTP）
+# ─────────────────────────────────────────
+#
+# 适用场景：共享主机、虚拟主机，只有 SFTP 权限无 SSH 登录权限
+#
+sftp_example:
+  type: sftp
+  build_cmd: npm run build
+  output_dir: dist
+  host: deployer@192.168.1.100           # SFTP 地址（格式 user@host）
+  key: ~/.ssh/id_rsa                     # SSH 私钥路径
+  remote_dir: /var/www/html/h5           # 远程目录（SFTP 必须有写权限）
+
+# ─────────────────────────────────────────
+# 3. 静态资源部署（local / S3 / rsync）
+# ─────────────────────────────────────────
+#
+# 适用场景：CDN、对象存储、共享文件系统、本地目录
+#
+# target 格式：
+#   - 本地路径：/var/www/html/h5
+#   - S3 桶：s3://my-bucket/h5/
+#   - rsync 远程：rsync://user@host:/var/www/html/h5
+#   - rsync 远程（简写）：user@host:/var/www/html/h5
+#
+static_local_example:
+  type: static
+  build_cmd: npm run build
+  output_dir: dist
+  target: /var/www/html/h5               # 本地或挂载的共享目录
+
+static_s3_example:
+  type: static
+  build_cmd: npm run build
+  output_dir: dist
+  target: s3://my-cdn-bucket/h5-staging/  # AWS S3（需安装 AWS CLI）
+
+static_rsync_example:
+  type: static
+  build_cmd: npm run build
+  output_dir: dist
+  target: deployer@cdn-server:/var/www/html/h5   # rsync 远程同步
+
+# ─────────────────────────────────────────
+# 4. 自定义脚本部署（最灵活）
+# ─────────────────────────────────────────
+#
+# 适用场景：Jenkins 触发、FTP 上传、复杂部署流程
+#
+# script 字段可以是：
+#   - 脚本文件路径（相对于 code_path）：./scripts/deploy-staging.sh
+#   - 直接命令：curl -X POST http://jenkins/job/build/build
+#
+script_jenkins_example:
+  type: script
+  build_cmd: npm run build
+  script: ./scripts/trigger-jenkins.sh   # 脚本文件（存在则执行 bash）
+  # 或直接写命令：
+  # script: "curl -X POST -u user:token http://jenkins.example.com/job/my-job/build"
+
+script_ftp_example:
+  type: script
+  build_cmd: npm run build
+  output_dir: dist
+  script: ./scripts/deploy-ftp.sh        # 脚本内容示例见下文
+
+# ─────────────────────────────────────────
+# 5. Docker 部署
+# ─────────────────────────────────────────
+#
+# 适用场景：容器化部署，支持本地构建 + 镜像仓库推送 + 远程服务器部署
+#
+# 远程部署说明（v8.3.96+）：
+#   - 配置 host 后，speccore 会自动 SSH 到远程服务器执行 docker pull && run
+#   - 远程部署必须配置 registry（否则远程服务器无法获取镜像）
+#   - 可通过 script 字段自定义远程命令（默认：stop → rm → pull → run）
+#   - 支持密钥认证（key）和密码认证（password + sshpass）
+#
+# 完整模板见 templates/deploy-docker/（含前端 Dockerfile、Nginx 配置、Compose 编排）
+
+# 基础 Docker：仅本地构建并推送到仓库（适合 CI/CD 场景）
+docker_push_only:
+  type: docker
+  dockerfile: ./Dockerfile
+  registry: registry.example.com
+  image: my-project/h5
+  tag: staging
+
+# 前端 Docker + 远程部署（Nginx 托管）
+docker_frontend_remote:
+  type: docker
+  build_cmd: npm run build:staging              # 前置构建（可选）
+  dockerfile: ./Dockerfile                      # 多阶段构建：Node → Nginx
+  registry: registry.example.com
+  image: my-project/admin-web
+  tag: staging
+  host: deployer@staging-server.example.com     # 远程服务器（v8.3.96+）
+  key: ~/.ssh/id_rsa
+  # script 自定义远程命令（可选，以下为默认值示例）
+  # script: "docker pull registry.example.com/my-project/admin-web:staging && docker stop admin-web 2>/dev/null; docker rm admin-web 2>/dev/null; docker run -d --name admin-web --restart always -p 80:80 registry.example.com/my-project/admin-web:staging"
+
+# 后端 Java Docker + 远程部署
+docker_backend_remote:
+  type: docker
+  dockerfile: ./Dockerfile                      # 多阶段构建：Maven → JRE
+  registry: registry.example.com
+  image: my-project/order-service
+  tag: staging
+  host: deployer@staging-server.example.com
+  key: ~/.ssh/id_rsa
+
+# Docker Compose 统一部署（使用 script 类型调用 compose）
+docker_compose_example:
+  type: script
+  script: ./scripts/deploy-compose.sh
+  # deploy-compose.sh 内容示例：
+  #   cd /opt/deploy && docker-compose pull && docker-compose up -d
+
+# ─────────────────────────────────────────
+# 6. PM2 部署（Node.js 后端）
+# ─────────────────────────────────────────
+#
+# 适用场景：Node.js 服务，本地或远程 PM2 进程管理
+#
+pm2_local_example:
+  type: pm2
+  build_cmd: npm run build
+  output_dir: .
+  pm2_config: ecosystem.config.js        # PM2 配置文件（默认 ecosystem.config.js）
+
+pm2_remote_example:
+  type: pm2
+  build_cmd: npm run build
+  pm2_config: ecosystem.config.js
+  host: deployer@192.168.1.100           # 远程服务器（可选，配置则 SSH 远程重启）
+  key: ~/.ssh/id_rsa
+  remote_dir: /opt/services/api
+
+# ─────────────────────────────────────────
+# 7. Kubernetes 部署
+# ─────────────────────────────────────────
+#
+# 适用场景：K8s 集群
+#
+k8s_example:
+  type: k8s
+  target: staging                        # namespace（默认 default）
+  script: k8s/deployment.yaml            # K8s manifest 文件路径（默认 k8s-deployment.yaml）
+
+# ─────────────────────────────────────────
+# 8. Helm 部署
+# ─────────────────────────────────────────
+#
+# 适用场景：使用 Helm 管理 K8s 应用
+#
+helm_example:
+  type: helm
+  target: staging                        # namespace（默认环境名）
+  script: ./helm/h5                      # Chart 路径（默认 ./helm/<端名>）
+  output_dir: values-staging.yaml        # values 文件路径（默认 values-<env>.yaml）
+
+# ─────────────────────────────────────────
+# 9. Vercel 部署
+# ─────────────────────────────────────────
+#
+# 适用场景：前端项目快速部署到 Vercel
+#
+vercel_example:
+  type: vercel
+  # 无需额外配置，执行 npx vercel --prod（production）或 npx vercel（preview）
+  # 需提前安装 Vercel CLI 并登录：npm i -g vercel && vercel login
+
+# ─────────────────────────────────────────
+# 10. Serverless 部署（函数计算）
+# ─────────────────────────────────────────
+#
+# 适用场景：函数计算、无服务器架构
+#
+serverless_aliyun_example:
+  type: serverless
+  provider: aliyun-fc                    # 阿里云函数计算
+  target: my-func-name                   # 函数名（默认使用端名）
+
+serverless_aws_example:
+  type: serverless
+  provider: aws-lambda                   # AWS Lambda
+  target: my-lambda-func
+
+serverless_tencent_example:
+  type: serverless
+  provider: tencent-scf                  # 腾讯云云函数
+  target: my-scf-func
+
+# ─────────────────────────────────────────
+# 11. Java 后端部署（Spring Boot + systemd）
+# ─────────────────────────────────────────
+#
+# 适用场景：Java 后端服务，通过 systemd 管理 jar 进程
+#
+# 服务器端准备（只需一次）：
+#   1) 将 templates/deploy-java/spring-boot.service 复制到服务器：
+#      /etc/systemd/system/order-service.service
+#      （文件名必须与 platform.name 一致）
+#   2) 创建部署目录：mkdir -p /opt/services/order-service
+#   3) 创建日志目录：mkdir -p /var/log/order-service
+#   4) 重载 systemd：sudo systemctl daemon-reload
+#   5) 启用开机自启：sudo systemctl enable order-service
+#
+# 数据库 / Redis 配置：
+#   通过 Spring Boot profiles 切换，如 application-staging.yml
+#   部署时激活 profile：script 中传入 --spring.profiles.active=staging
+#
+java_systemd_example:
+  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
+  # 部署后执行：停止服务 → 替换 jar → 启动服务
+  script: sudo systemctl restart order-service
+  pre_deploy:
+    - echo "开始部署 Java 后端..."
+  post_deploy:
+    - echo "部署完成，检查状态..."
+    - ssh deployer@staging-server.example.com "sudo systemctl status order-service --no-pager"
+
+# ─────────────────────────────────────────
+# 12. Java 后端部署（Spring Boot + Docker）
+# ─────────────────────────────────────────
+#
+# 适用场景：Java 服务容器化部署
+#
+# Dockerfile 示例见 templates/deploy-java/Dockerfile
+#
+java_docker_example:
+  type: docker
+  dockerfile: ./Dockerfile
+  registry: registry.example.com
+  image: my-project/order-service
+  tag: staging
+
+# ═══════════════════════════════════════════════════════════
+# 完整 PROJECT.yaml 示例（含部署配置）
+# ═══════════════════════════════════════════════════════════
+
+platforms:
+  - name: sr-web-operation
+    type: frontend
+    description: 运营管理前端
+    code_path: ./sr-web-operation
+    default_branch: main
+    requirement_unit: 运营管理
+    deploy:
+      staging:
+        type: ssh
+        build_cmd: npm run build:staging
+        output_dir: dist
+        host: deployer@staging-server.example.com
+        key: ~/.ssh/id_rsa
+        remote_dir: /var/www/html/sr-web-operation
+        script: sudo nginx -s reload
+      production:
+        type: ssh
+        build_cmd: npm run build:prod
+        output_dir: dist
+        host: deployer@prod-server.example.com
+        key: ~/.ssh/id_rsa_production
+        remote_dir: /var/www/html/sr-web-operation
+        script: sudo nginx -s reload
+
+  - name: api-service
+    type: backend
+    description: API 服务
+    code_path: ./api-service
+    default_branch: main
+    deploy:
+      staging:
+        type: pm2
+        build_cmd: npm run build
+        pm2_config: ecosystem.config.js
+        host: deployer@staging-server.example.com
+        key: ~/.ssh/id_rsa
+        remote_dir: /opt/services/api-service
+
+# ═══════════════════════════════════════════════════════════
+# 环境配置文件示例（.speccore/environments/staging.yaml）
+# ═══════════════════════════════════════════════════════════
+#
+# 环境配置会与 PROJECT.yaml 的 deploy 段合并，优先级：环境配置 > PROJECT.yaml
+#
+
+branch: develop                          # pipeline 命令的目标分支
+build_cmd: npm run build:staging         # 覆盖 PROJECT.yaml 的构建命令
+
+deploy:
+  type: ssh
+  host: deployer@staging-server.example.com:22
+  key: ~/.ssh/id_rsa
+  remote_dir: /var/www/html/sr-web-operation
+
+# ═══════════════════════════════════════════════════════════
+# 常用脚本示例
+# ═══════════════════════════════════════════════════════════
+
+# --- scripts/trigger-jenkins.sh ---
+# #!/bin/bash
+# curl -X POST \
+#   -u "$JENKINS_USER:$JENKINS_TOKEN" \
+#   "http://jenkins.example.com/job/my-project-$1/build"
+
+# --- scripts/deploy-ftp.sh ---
+# #!/bin/bash
+# # 使用 lftp 进行 FTP 上传（支持密码）
+# lftp -u "$FTP_USER,$FTP_PASS" "$FTP_HOST" <<EOF
+# set ssl:verify-certificate no
+# mirror -R dist /public_html/h5
+# bye
+# EOF
+
+# --- scripts/deploy-password-ssh.sh ---
+# #!/bin/bash
+# # 使用 sshpass 进行密码认证的 SSH 部署（需安装 sshpass）
+# # macOS: brew install sshpass
+# # Ubuntu: apt-get install sshpass
+# sshpass -p "$SSH_PASSWORD" scp -r dist/* "$SSH_USER@$SSH_HOST:$REMOTE_DIR/"
+# sshpass -p "$SSH_PASSWORD" ssh "$SSH_USER@$SSH_HOST" "sudo nginx -s reload"
+
+# --- scripts/deploy-java.sh（服务器端执行） ---
+# #!/bin/bash
+# # Java 后端部署脚本（放在服务器上，由 SSH 调用或手动执行）
+# APP_NAME="${1:-order-service}"
+# DEPLOY_DIR="/opt/services/$APP_NAME"
+# BACKUP_DIR="/opt/services/$APP_NAME/backups"
+# JAR_FILE="$DEPLOY_DIR/$APP_NAME.jar"
+# NEW_JAR="$DEPLOY_DIR/$APP_NAME-new.jar"
+#
+# # 1. 备份旧版本
+# mkdir -p "$BACKUP_DIR"
+# if [ -f "$JAR_FILE" ]; then
+#   cp "$JAR_FILE" "$BACKUP_DIR/$APP_NAME-$(date +%Y%m%d-%H%M%S).jar"
+#   # 只保留最近 5 个备份
+#   ls -t "$BACKUP_DIR"/*.jar | tail -n +6 | xargs -r rm -f
+# fi
+#
+# # 2. 替换 jar
+# if [ -f "$NEW_JAR" ]; then
+#   mv "$NEW_JAR" "$JAR_FILE"
+# else
+#   echo "错误：未找到新 jar 文件 $NEW_JAR"
+#   exit 1
+# fi
+#
+# # 3. 重启服务
+# sudo systemctl restart "$APP_NAME"
+# sleep 2
+# sudo systemctl status "$APP_NAME" --no-pager
+
+# --- systemd service 文件示例（/etc/systemd/system/order-service.service） ---
+# [Unit]
+# Description=Order Service
+# After=network.target
+#
+# [Service]
+# Type=simple
+# User=deployer
+# Group=deployer
+# WorkingDirectory=/opt/services/order-service
+# Environment="SPRING_PROFILES_ACTIVE=staging"
+# Environment="JAVA_OPTS=-Xms512m -Xmx1024m -Dfile.encoding=UTF-8"
+# ExecStart=/usr/bin/java $JAVA_OPTS -jar order-service.jar
+# ExecStop=/bin/kill -SIGTERM $MAINPID
+# Restart=on-failure
+# RestartSec=10
+# StandardOutput=append:/var/log/order-service/app.log
+# StandardError=append:/var/log/order-service/error.log
+#
+# [Install]
+# WantedBy=multi-user.target

package/templates/deploy-java/Dockerfile

@@ -0,0 +1,50 @@
+# ═══════════════════════════════════════════════════════════
+# Spring Boot Docker 构建示例
+# ═══════════════════════════════════════════════════════════
+#
+# 用法：
+#   1. 将本文件复制到 Java 工程根目录（与 pom.xml 同级）
+#   2. 在 PROJECT.yaml 中配置 docker 类型部署：
+#      deploy:
+#        staging:
+#          type: docker
+#          dockerfile: ./Dockerfile
+#          registry: registry.example.com
+#          image: my-project/order-service
+#          tag: staging
+#   3. 执行: speccore deploy --env staging --platform order-service
+#
+# 多阶段构建：先编译，再复制 jar 到精简镜像
+# ═══════════════════════════════════════════════════════════
+
+# ── 阶段 1：构建 ──
+FROM maven:3.9-eclipse-temurin-17-alpine AS builder
+WORKDIR /build
+COPY pom.xml .
+COPY src ./src
+RUN mvn clean package -DskipTests -P docker
+
+# ── 阶段 2：运行 ──
+FROM eclipse-temurin:17-jre-alpine
+WORKDIR /app
+
+# 创建非 root 用户（安全最佳实践）
+RUN addgroup -S appgroup && adduser -S appuser -G appgroup
+
+# 复制构建产物
+COPY --from=builder /build/target/*.jar app.jar
+
+# 环境变量（可在运行时通过 -e 覆盖）
+ENV SPRING_PROFILES_ACTIVE=staging
+ENV JAVA_OPTS="-Xms512m -Xmx1024m -Dfile.encoding=UTF-8 -Djava.security.egd=file:/dev/./urandom"
+
+# 暴露端口（根据实际应用修改）
+EXPOSE 8080
+
+# 健康检查
+HEALTHCHECK --interval=30s --timeout=3s --start-period=60s --retries=3 \
+  CMD wget --no-verbose --tries=1 --spider http://localhost:8080/actuator/health || exit 1
+
+USER appuser
+
+ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]

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`