Debian JSP如何进行版本控制与管理

Debian 上 JSP 项目的版本控制与管理

一 环境与基础准备

• 安装 Git：sudo apt update && sudo apt install -y git
• 配置全局身份：git config --global user.name “Your Name”；git config --global user.email “you@example.com”
• 安装 JDK 与 Tomcat（JSP 运行依赖）：sudo apt install -y openjdk-11-jdk tomcat9
• 验证环境：java -version；sudo systemctl start tomcat9 && curl -I http://localhost:8080/

二 本地版本控制流程

• 初始化仓库：cd /path/to/jsp/project && git init
• 忽略无需纳入版本控制的文件：创建 .gitignore，建议至少包含
  • .class、.war、.log、target/、build/、.idea/、.vscode/、.iml
• 纳入与提交：git add .；git commit -m “Initial commit”
• 远程仓库与推送：在 GitHub/GitLab 新建仓库后
  • git remote add origin ；git branch -M main；git push -u origin main
• 常用日常：git status、git log、git diff、git pull、git push

三 分支与发布管理

• 分支策略建议：main 保护分支（仅通过 PR/合并请求更新）、develop 集成分支、feature/* 功能分支、hotfix/* 紧急修复分支
• 示例流程
  • 开发新功能：git checkout -b feature/login；完成后 git push origin feature/login 并在 GitLab/GitHub 创建 PR 合并至 develop
  • 发布准备：从 develop 创建 release/v1.2.0；回归测试通过后合并到 main 并打标签：git tag -a v1.2.0 -m “Release 1.2.0”；git push origin v1.2.0
  • 紧急修复：git checkout -b hotfix/login-bug main；修复后合并回 main 与 develop，并打补丁标签 v1.2.1
• 版本标签用于标记可发布的稳定版本，便于回滚与追踪

四 依赖与构建管理

• 使用 Maven 或 Gradle 管理依赖与打包（推荐）：
  • Maven：在 pom.xml 声明依赖，执行 mvn clean package 生成 WAR；将 WAR 部署到 Tomcat/webapps
  • Gradle：在 build.gradle 声明依赖，执行 gradle build 生成 WAR
• 运行时依赖放置：可将共享库放入 $CATALINA_HOME/lib（全局）或在应用的 WEB-INF/lib（仅当前应用）
• 依赖与构建的变更应纳入 Git，确保团队一致与可重现构建

五 部署与持续交付

• 简单拉取部署脚本 deploy.sh（不建议直接在 webapps 下 git init）
  • 脚本示例：
    • #!/usr/bin/env bash set -e APP_DIR=/var/lib/tomcat9/webapps/ROOT git -C “$APP_DIR” pull origin main sudo systemctl restart tomcat9
  • 权限与安全：建议使用专用部署用户与受限权限，避免在生产环境启用 Git 写权限
• 更优实践：使用 Jenkins/GitLab CI 执行构建（mvn/gradle）→ 产物归档（WAR）→ 推送到制品库（如 Nexus/Artifactory）→ 通过脚本或 API 部署到 Tomcat（减少直接操作服务器与代码库的风险）
• 不建议在 /var/lib/tomcat9/webapps 内直接初始化 Git 仓库，生产环境优先采用“构建产物部署 + 自动化发布”的方式