Java 语言特定指南

Java 语言特定指南

本 Java 入门指南将教您如何使用 Docker 创建一个容器化的 Spring Boot 应用程序。在本模块中，您将学习如何：

• 使用 Maven 容器化并运行一个 Spring Boot 应用程序
• 设置本地开发环境以将数据库连接到容器、配置调试器，并使用 Compose Watch 实现实时重新加载
• 在容器中运行单元测试
• 使用 GitHub Actions 为您的应用程序配置 CI/CD 流水线
• 将容器化的应用程序本地部署到 Kubernetes 以测试和调试您的部署

完成 Java 入门模块后，您应该能够根据本指南提供的示例和说明来容器化您自己的 Java 应用程序。

容器化并运行 Spring Boot 应用程序

1. 准备现有的 Spring Boot 应用程序

确保您的项目结构类似于以下内容：

my-spring-boot-app/
├── src/
│   ├── main/
│   │   ├── java/
│   │   ├── resources/
│   ├── test/
├── pom.xml

2. 创建 Dockerfile

在项目根目录下创建一个名为 Dockerfile 的文件，并添加以下内容：

# 使用 Maven 镜像构建项目
FROM maven:3.8.4-openjdk-11 AS build
WORKDIR /app
COPY pom.xml .
COPY src ./src
RUN mvn clean package -DskipTests

# 使用 OpenJDK 镜像运行应用程序
FROM openjdk:11-jre-slim
WORKDIR /app
COPY --from=build /app/target/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]

3. 构建 Docker 镜像

在项目根目录下运行以下命令以构建 Docker 镜像：

docker build -t my-spring-boot-app .

4. 运行容器

使用以下命令运行容器：

docker run -d -p 8080:8080 my-spring-boot-app

现在，您可以通过浏览器访问 http://localhost:8080 来查看您的应用程序。

设置本地开发环境

使用 Docker 容器设置本地开发环境有助于确保开发环境与生产环境一致。

1. 创建 docker-compose.yml 文件

在项目根目录下创建一个名为 docker-compose.yml 的文件，并添加以下内容：

version: '3.8'
services:
  app:
    image: my-spring-boot-app
    ports:
      - "8080:8080"
    volumes:
      - .:/app
    command: mvn spring-boot:run
  db:
    image: postgres:13
    environment:
      POSTGRES_DB: mydb
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
    ports:
      - "5432:5432"

2. 运行 Docker Compose

在项目根目录下运行以下命令启动开发环境：

docker-compose up

现在，您的应用程序将在 http://localhost:8080 上运行，您可以进行开发并实时查看更改。

在容器中运行单元测试

1. 修改 Dockerfile 以包括测试步骤

更新 Dockerfile 文件以包括测试步骤：

# 使用 Maven 镜像构建项目
FROM maven:3.8.4-openjdk-11 AS build
WORKDIR /app
COPY pom.xml .
COPY src ./src
RUN mvn clean package

# 使用 OpenJDK 镜像运行应用程序
FROM openjdk:11-jre-slim
WORKDIR /app
COPY --from=build /app/target/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]

2. 运行测试容器

使用以下命令运行测试：

docker run --rm -v $(pwd):/app -w /app maven:3.8.4-openjdk-11 mvn test

配置 CI/CD 流水线

使用 GitHub Actions 配置 CI/CD 流水线以自动化测试和部署过程。

1. 创建 GitHub Actions 工作流文件

在项目根目录下创建 .github/workflows/ci.yml 并添加以下内容：

name: CI/CD Pipeline

on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v2

    - name: Set up JDK 11
      uses: actions/setup-java@v2
      with:
        java-version: '11'

    - name: Build with Maven
      run: mvn clean package

    - name: Build Docker image
      run: docker build -t my-spring-boot-app .

    - name: Push Docker image
      env:
        DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}
        DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
      run: |
        echo $DOCKER_PASSWORD | docker login -u $DOCKER_USERNAME --password-stdin
        docker tag my-spring-boot-app $DOCKER_USERNAME/my-spring-boot-app:latest
        docker push $DOCKER_USERNAME/my-spring-boot-app:latest

确保在 GitHub 仓库中添加 Docker Hub 凭据作为秘密（secrets）。

部署到 Kubernetes

使用 Kubernetes 部署和管理容器化的 Java 应用程序。

1. 创建 Kubernetes 部署文件

在项目根目录下创建 k8s/deployment.yml 并添加以下内容：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-spring-boot-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: my-spring-boot-app
  template:
    metadata:
      labels:
        app: my-spring-boot-app
    spec:
      containers:
      - name: my-spring-boot-app
        image: <DOCKER_USERNAME>/my-spring-boot-app:latest
        ports:
        - containerPort: 8080
---
apiVersion: v1
kind: Service
metadata:
  name: my-spring-boot-app-service
spec:
  type: NodePort
  selector:
    app: my-spring-boot-app
  ports:
    - port: 8080
      targetPort: 8080
      nodePort: 30008

2. 部署到 Kubernetes

使用 kubectl 命令将应用程序部署到 Kubernetes 集群：

kubectl apply -f k8s/deployment.yml

您可以通过访问 http://<NODE_IP>:30008 查看应用程序。

通过上述步骤，您已经学会了如何容器化并运行一个 Spring Boot 应用程序，设置本地开发环境，使用容器运行测试，配置 CI/CD 流水线，并将应用程序部署到 Kubernetes。