一、私有化部署前的核心准备工作

1.1 硬件与网络环境规划

私有化部署需根据项目规模选择物理服务器或虚拟化方案。对于中小型项目，建议采用2核4G以上配置的虚拟机，存储空间需预留项目依赖库、日志和临时文件的3倍容量。网络架构需设计内外网隔离方案，例如通过VLAN划分开发、测试、生产环境，并配置防火墙规则限制非授权IP访问。

1.2 基础软件栈安装

• JDK安装：推荐使用LTS版本（如JDK 11/17），通过java -version验证安装。需配置JAVA_HOME环境变量，并在/etc/profile中添加export PATH=$JAVA_HOME/bin:$PATH。
• 数据库部署：MySQL需配置innodb_buffer_pool_size为物理内存的50%-70%，并通过my.cnf优化参数。PostgreSQL需调整shared_buffers和work_mem参数。
• 中间件选择：Tomcat需配置server.xml中的连接器参数（如maxThreads="200"），Nginx需优化worker_processes和keepalive_timeout。

1.3 依赖管理优化

使用Nexus或Artifactory搭建私有Maven仓库，通过settings.xml配置镜像地址：

<mirrors>
    <mirror>
        <id>nexus</id>
        <url>http://repo.example.com/repository/maven-public/</url>
        <mirrorOf>central</mirrorOf>
    </mirror>
</mirrors>

建议将第三方JAR包统一存放至/opt/libs目录，并通过mvn install:install-file命令安装到本地仓库。

二、私有化部署实施步骤

2.1 代码与配置管理

• 分支策略：采用Git Flow模型，维护develop、release、hotfix分支。配置文件需按环境拆分，例如application-dev.yml、application-prod.yml。
• 敏感信息处理：使用Jasypt加密配置文件中的数据库密码，示例加密命令：

  java -cp jasypt-1.9.3.jar org.jasypt.intf.cli.JasyptPBEStringEncryptionCLI \
  input="your_password" password=your_secret_key algorithm=PBEWithMD5AndDES

2.2 构建与打包规范

Maven构建时需指定环境参数：

mvn clean package -Pprod -DskipTests

生成的JAR包应包含版本号（如app-1.0.0.jar），并通过MANIFEST.MF文件记录构建信息。

2.3 部署脚本设计

编写deploy.sh脚本实现自动化部署，核心逻辑包括：

#!/bin/bash
# 停止旧服务
pid=$(ps -ef | grep 'app-.*\.jar' | grep -v grep | awk '{print $2}')
[ -n "$pid" ] && kill -9 $pid
# 备份旧版本
backup_dir="/opt/backup/$(date +%Y%m%d)"
mkdir -p $backup_dir
cp /opt/app/app-*.jar $backup_dir/
# 部署新版本
cp target/app-*.jar /opt/app/
cd /opt/app
nohup java -jar app-*.jar --spring.profiles.active=prod > app.log 2>&1 &

三、关键配置优化

3.1 JVM参数调优

生产环境推荐配置：

-Xms2g -Xmx2g -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m \
-XX:+UseG1GC -XX:InitiatingHeapOccupancyPercent=35 \
-XX:G1HeapRegionSize=16m -XX:+DisableExplicitGC

通过jstat -gcutil <pid> 1000监控GC情况。

3.2 日志系统集成

配置Logback时需区分环境：

<springProfile name="prod">
    <root level="INFO">
        <appender-ref ref="FILE" />
        <appender-ref ref="ASYNC" />
    </root>
</springProfile>

日志文件按日期滚动，保留30天历史：

<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
    <fileNamePattern>/var/log/app/%d{yyyy-MM-dd}.log</fileNamePattern>
    <maxHistory>30</maxHistory>
</rollingPolicy>

3.3 安全加固措施

• SSL配置：生成自签名证书或申请CA证书，配置Tomcat的server.xml：

  <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
    maxThreads="150" scheme="https" secure="true"
    keystoreFile="/etc/tomcat/keystore.jks"
    keystorePass="your_password" clientAuth="false"
    sslProtocol="TLS" />

• 权限控制：数据库用户仅授予必要权限，示例MySQL授权：

  GRANT SELECT, INSERT, UPDATE, DELETE ON app_db.* TO 'app_user'@'%' IDENTIFIED BY 'secure_password';

四、部署后验证与维护

4.1 健康检查机制

实现Spring Boot Actuator端点，配置/actuator/health检查服务状态。Nginx需配置健康检查：

upstream app_server {
    server 127.0.0.1:8080 max_fails=3 fail_timeout=30s;
}
server {
    location / {
        proxy_pass http://app_server;
        proxy_next_upstream error timeout invalid_header http_500;
    }
}

4.2 监控告警体系

集成Prometheus+Grafana监控JVM指标，关键告警规则包括：

• 堆内存使用率>85%持续5分钟
• GC停顿时间>500ms
• 线程阻塞数>10

4.3 回滚方案

维护最近3个稳定版本的备份，回滚步骤：

1. 停止当前服务
2. 从备份目录恢复JAR包
3. 重启服务并验证
4. 记录回滚原因至知识库

五、常见问题解决方案

5.1 端口冲突处理

使用netstat -tulnp | grep <port>定位占用进程，通过lsof -i:<port>获取详细信息。修改应用配置或终止冲突进程。

5.2 依赖冲突解决

通过mvn dependency:tree分析依赖树，使用<exclusions>排除冲突版本。示例：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <exclusions>
        <exclusion>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>

5.3 性能瓶颈定位

使用Arthas进行在线诊断，常见命令包括：

• dashboard：查看实时监控
• thread：分析线程状态
• trace：跟踪方法调用链

六、最佳实践建议

1. 环境标准化：使用Docker容器化部署，通过Dockerfile定义环境：

   FROM openjdk:11-jre-slim
   VOLUME /tmp
   ARG JAR_FILE=target/*.jar
   COPY ${JAR_FILE} app.jar
   ENTRYPOINT ["java","-jar","/app.jar"]

2. 配置管理：采用Spring Cloud Config或Apollo实现集中式配置管理。
3. CI/CD集成：通过Jenkins构建流水线，实现代码提交→单元测试→构建→部署的全自动化。

私有化部署是一个系统工程，需要从环境准备、配置优化、安全加固到监控维护形成完整闭环。建议企业建立部署检查清单（Checklist），涵盖硬件验收、软件安装、配置验证等12个关键环节，确保每次部署的可重复性和可靠性。通过持续优化部署流程，可将平均部署时间从4小时缩短至30分钟，显著提升业务响应能力。