如何使用Docker容器化你的Java SaaS应用:一次构建,随处运行

# 1. 检查内核版本（必须 >= 3.10）
uname -r
# 2. 检查操作系统版本
cat /etc/os-release
# 3. 卸载旧版本Docker（如有）
# Rocky Linux / CentOS:
sudo dnf remove -y docker docker-client docker-client-latest \
  docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine
# Ubuntu / Debian:
sudo apt remove -y docker docker-engine docker.io containerd runc

# 1. 安装必要依赖
sudo dnf install -y dnf-plugins-core
# 2. 添加Docker官方YUM仓库
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
# 3. 安装Docker Engine及相关组件
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# 4. 启动Docker服务并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker
# 5. 验证安装
sudo docker --version

# 1. 更新软件包列表并安装依赖
sudo apt update
sudo apt install -y ca-certificates curl
# 2. 添加Docker官方GPG密钥
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
# 3. 添加Docker官方APT仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
  https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" \
  | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 4. 安装Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# 5. 启动Docker服务并验证
sudo systemctl start docker
sudo systemctl enable docker
sudo docker --version

# 1. 将当前用户加入docker组（避免每次sudo）
sudo usermod -aG docker $USER
# ⚠️ 执行后需要退出重新登录才能生效
# 2. 配置Docker守护进程（/etc/docker/daemon.json）
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json << 'EOF'
{
  "registry-mirrors": [
    "https://your-mirror.aliyuncs.com"   # 替换为你的镜像加速器地址
  ],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  },
  "storage-driver": "overlay2"
}
EOF
# 3. 重启Docker使配置生效
sudo systemctl daemon-reload
sudo systemctl restart docker
# 4. 验证配置
docker info | grep -A 5 "Registry Mirrors"

# ============================================================
# 第一阶段：构建阶段（builder）
# 使用包含完整JDK和Maven的镜像来编译打包
# ============================================================
FROM maven:3.9-eclipse-temurin-17-alpine AS builder
# 设置工作目录
WORKDIR /build
# 先复制pom.xml——利用Docker层缓存，依赖不变时不重复下载
COPY pom.xml .
RUN mvn dependency:go-offline -B
# 再复制源代码并打包
COPY src ./src
RUN mvn package -DskipTests -B
# ============================================================
# 第二阶段：运行阶段（最终镜像）
# 只复制jar包，使用轻量级JRE镜像
# ============================================================
FROM eclipse-temurin:17-jre-alpine
# 创建应用运行用户（非root，安全加固）
RUN addgroup -S appgroup && adduser -S appuser -G appgroup
# 设置工作目录
WORKDIR /app
# 从构建阶段复制jar包
COPY --from=builder /build/target/*.jar ./app.jar
# 创建挂载点（用于日志和配置的外部挂载）
VOLUME /app/logs
VOLUME /app/config
# 暴露应用端口（根据你的应用调整）
EXPOSE 8080
# 切换到非root用户
USER appuser
# JVM参数优化（容器环境专用）
ENV JAVA_OPTS="-XX:+UseContainerSupport \
  -XX:MaxRAMPercentage=75.0 \
  -XX:InitialRAMPercentage=50.0 \
  -XX:+HeapDumpOnOutOfMemoryError \
  -XX:HeapDumpPath=/app/logs/heapdump.hprof \
  -Djava.security.egd=file:/dev/./urandom"
# 启动命令
ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar /app/app.jar"]

# Git相关
.git/
.gitignore
# 构建产物
target/
*.jar
*.war
*.log
# IDE相关
.idea/
*.iml
.vscode/
.settings/
.classpath
.project
# 系统文件
.DS_Store
Thumbs.db
# 容器相关（避免递归）
Dockerfile
.dockerignore
docker-compose*.yml
# 其他
*.md
README*

# 1. 在项目根目录执行构建
cd /path/to/your-java-project
# 2. 构建镜像（给镜像打上标签）
docker build -t myapp:1.0.0 .
# 3. 查看已构建的镜像
docker images | grep myapp
# 4. 查看镜像分层历史（理解镜像的构成）
docker history myapp:1.0.0

# 1. 基本运行（前台运行，用于调试）
docker run -p 8080:8080 myapp:1.0.0
# 2. 后台运行 + 重启策略 + 资源限制（生产环境推荐）
docker run -d \
  --name myapp \
  --restart=unless-stopped \
  -p 8080:8080 \
  -m 2g \
  --memory-reservation 1.5g \
  -e "SPRING_PROFILES_ACTIVE=prod" \
  -v /data/myapp/logs:/app/logs \
  -v /data/myapp/config:/app/config \
  myapp:1.0.0
# 3. 查看容器运行状态
docker ps
# 4. 查看容器日志
docker logs -f myapp
# 5. 进入容器内部（调试用）
docker exec -it myapp sh

version: '3.8'
services:
  # ============ MySQL 数据库 ============
  mysql:
    image: mysql:8.0
    container_name: saas-mysql
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: root_strong_passwd
      MYSQL_DATABASE: saas_db
      MYSQL_USER: saas_user
      MYSQL_PASSWORD: saas_passwd
      TZ: Asia/Shanghai
    ports:
      - "3306:3306"
    volumes:
      - mysql_data:/var/lib/mysql
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql
    command:
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_unicode_ci
      - --max_connections=500
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - saas-network
  # ============ Redis 缓存 ============
  redis:
    image: redis:7.0-alpine
    container_name: saas-redis
    restart: unless-stopped
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data
    command: redis-server --appendonly yes --requirepass redis_strong_passwd
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - saas-network
  # ============ Java 应用 ============
  app:
    build:
      context: .
      dockerfile: Dockerfile
    image: myapp:1.0.0
    container_name: saas-app
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      SPRING_PROFILES_ACTIVE: docker
      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/saas_db?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai
      SPRING_DATASOURCE_USERNAME: saas_user
      SPRING_DATASOURCE_PASSWORD: saas_passwd
      SPRING_REDIS_HOST: redis
      SPRING_REDIS_PORT: 6379
      SPRING_REDIS_PASSWORD: redis_strong_passwd
    volumes:
      - app_logs:/app/logs
    depends_on:
      mysql:
        condition: service_healthy
      redis:
        condition: service_healthy
    networks:
      - saas-network
# ============ 卷定义 ============
volumes:
  mysql_data:
  redis_data:
  app_logs:
# ============ 网络定义 ============
networks:
  saas-network:
    driver: bridge

# 1. 启动所有服务（后台运行）
docker-compose up -d
# 2. 查看所有服务状态
docker-compose ps
# 3. 查看某个服务的日志
docker-compose logs -f app
# 4. 停止所有服务
docker-compose down
# 5. 停止并删除数据卷（⚠️ 会丢失数据！）
docker-compose down -v
# 6. 重新构建并启动（代码更新后使用）
docker-compose up -d --build
# 7. 进入某个服务的容器内部
docker-compose exec app sh
docker-compose exec mysql bash

# 1. 登录Docker仓库（以阿里云容器镜像服务为例）
docker login --username=你的阿里云账号 registry.cn-hangzhou.aliyuncs.com
# 2. 给本地镜像打上仓库地址的标签
docker tag myapp:1.0.0 registry.cn-hangzhou.aliyuncs.com/你的命名空间/myapp:1.0.0
# 3. 推送镜像到仓库
docker push registry.cn-hangzhou.aliyuncs.com/你的命名空间/myapp:1.0.0
# 4. 在生产服务器上拉取镜像
docker pull registry.cn-hangzhou.aliyuncs.com/你的命名空间/myapp:1.0.0