7.idea 使用 docker 构建 spring boot 项目

  使用 idea 能构建镜像的 maven 插件，推荐使用 Spotify 的 dockerfile-maven-plugin，它是专门基于 Dockerfile 构建镜像的插件，也是目前市面上用的比较多的镜像构建方式之一。

step 1：编写 Dockerfile 文件

在代码 src 同级，创建名称为 Dockerfile 的文件。

内容如下：

## 基础镜像
FROM openjdk:17

## 作者
MAINTAINER lzb <xxx@qq.com>

## 定义参数
ARG JAR_FILE

## 创建并进入工作目录
RUN mkdir -p /portal-site
WORKDIR /portal-site

## maven 插件构建时得到 buildArgs 种的值
COPY ${JAR_FILE} portal-site.jar

## 设置 TZ 时区
## 设置 JAVA_OPTS 环境变量，可通过 docker run -e "JAVA_OPTS=" 进行覆盖
ENV TZ=Asia/Shanghai JAVA_OPTS="-Xms256m -Xmx256m"

## 暴露端口
EXPOSE 8080

## 容器启动命令
## CMD 第一个参数之后的命令可以在运行时被替换
CMD java ${JAVA_OPTS} -jar portal-site.jar

step 2：pom.xml 中添加如下配置

<plugin>
    <groupId>com.spotify</groupId>
    <artifactId>dockerfile-maven-plugin</artifactId>
    <version>1.4.13</version>
    <executions>
        <execution>
            <id>default</id>
            <!-- 自定义构建、推送命令 -->
            <goals>
                <goal>build</goal>
                <goal>push</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <!-- 打包后的完整镜像名：仓库路径/项目名称/镜像名 -->
        <repository>192.168.204.102:8858/portal-site/${project.artifactId}</repository>
        <!-- 镜像版本号 -->
        <tag>${project.version}</tag>
        <!-- 读取 settings.xml 文件中的认证信息 -->
        <useMavenSettingsForAuth>true</useMavenSettingsForAuth>
        <buildArgs>
            <!-- jar 所在目录(JAR_FILE 为 Dockerfile文件中的参数) -->
            <JAR_FILE>target/${project.artifactId}-${project.version}.jar</JAR_FILE>
        </buildArgs>
    </configuration>
</plugin>

step 3：maven仓库 setting.xml <servers> 模块下，添加访问自定义仓库的用户名，密码

<!-- 在 maven 的 settings.xml 文件的 servers 标签中，增加服务认证配置信息-->
<server>
	<id>192.168.204.102:8858</id>   <!-- id中的内容与 configuration 中 的repository中的地址一致-->
	<username>用户名</username>
	<password>密码</password>
</server>

step 4：使用 maven命令开始 clean、package

提示：如果使用本地 docker 打包镜像，Window 本地需安装 Docker Desktop。
执行 clean 操作，然后执行 package 即可
package 打包操作，会在打完包的同时，生成本地 docker 镜像。

---

错误问题：Connect to localhost:2375 [localhost/127.0.0.1, localhost/0:0:0:0:0:0:0:1] failed: Connection refused: no further information
解决方式：我使用的是 Docker Desktop 4.23.0，截至 2023-09-15是最新的，需要开启2375端口，如下图所示：
 
 
1.执行 package 命令，开始构建镜像
 

 

 
2.本地通过 docker images 命令查看，本地镜像构建成功
 

step 5：使用 maven dockerfile 插件，推送镜像至本地仓库

step 6：看是否成功推送镜像至 Harbor 本地仓库

step 7：linux环境，创建/opt/docker/portal-site文件夹，编写 docker-deploy.sh 脚本

脚本内容如下，以下内容需要根据自己项目来小修改一下

#!/bin/bash

## 第一个参数：up|start|stop|restart|rm
COMMAND=$1
## app 名称
APP_NAME=$2

## 如果没有给 app 名称，默认就叫 app
if [ -z $APP_NAME ]; then
  APP_NAME="portal-site"
fi

## 暴露的端口
EXPOSE_PORT=8081:8081
## 项目/组织
NAMESPACE=portal-site
## 版本号
TAG=1.0

## 仓库地址
REGISTRY_SERVER=192.168.204.102:8858

## 用户名
USERNAME=admin
## 密码
PASSWORD=Harbor12345

## 镜像名称
IMAGE_NAME="$REGISTRY_SERVER/$NAMESPACE/$APP_NAME:$TAG"

## 使用说明，用来提示输入参数
function usage() {
	echo "Usage: sh docker-deploy.sh [up|start|stop|restart|rm]"
	exit 1
}

## 登录仓库
function login() {
  echo "docker login -u $USERNAME --password-stdin $REGISTRY_SERVER"
  echo "$PASSWORD" | docker login -u $USERNAME --password-stdin $REGISTRY_SERVER
}

## 启动容器
function start() {
  # 检查容器是否存在
  CONTAINER_NAME=$(docker ps | grep "$APP_NAME" | awk '{print $NF}')
  # 存在就不启动了
  if [ -n "$CONTAINER_NAME" ]; then
    echo "container $CONTAINER_NAME already started..."
    exit 1
  fi
  # 镜像如果不存在需要先登录
  IMAGE=$(docker images | grep "$APP_NAME" | awk '{print $3}')
  if [ -z "$IMAGE" ]; then
    login
  fi
  # 容器不存在就启动
  echo "starting container $APP_NAME..."
  docker run -d --restart=always --name $APP_NAME -p $EXPOSE_PORT $IMAGE_NAME
  echo "container $APP_NAME started..."
}

## 停止容器
function stop() {
  # 检查容器是否存在
  CONTAINER_NAME=$(docker ps | grep "$APP_NAME" | awk '{print $NF}')

  # 不存在就不需要停止
  if [ -z "$CONTAINER_NAME" ]; then
    echo "container $CONTAINER_NAME not running..."
    exit 1
  fi

  # 存在就停止容器
  echo "stopping container $APP_NAME..."
  docker stop $CONTAINER_NAME
  echo "container $APP_NAME stopped..."
}

## 重启容器
function restart() {
  # 先停止
  stop
  # 再启动
  start
}

## 删除容器、镜像
function rm() {
  # 获取容器名称
  CONTAINER_NAME=$(docker ps | grep "$APP_NAME" | awk '{print $NF}')
  if [ -n "$CONTAINER_NAME" ]; then
    # 停止容器
    stop
    # 删除容器
    echo "removing container $APP_NAME..."
    docker rm $CONTAINER_NAME
    echo "container $APP_NAME removed..."
  fi

  # 获取镜像 id
  IMAGE=$(docker images | grep "$APP_NAME" | awk '{print $3}')
  if [ -n "$IMAGE" ]; then
    # 删除镜像
    echo "removing image $IMAGE..."
    docker rmi $IMAGE
    echo "image $IMAGE removed..."
  fi
}

# 重新拉取镜像并启动容器
function up() {
  # 删除旧的镜像与容器
  rm
  # 拉取新的镜像并启动容器
  start
}

# 根据输入参数，选择执行对应方法，不输入则执行使用说明
case "$COMMAND" in
"up")
	up
;;
"start")
	start
;;
"stop")
	stop
;;
"restart")
	restart
;;
"rm")
	rm
;;
*)
	usage
;;
esac

step 8：执行脚本启动容器

sh docker-deploy.sh up

step 9：推荐在 idea 中使用 Alibaba Cloud View 插件

可以在 idea 中就可以解决应用的部署启动，省去一步使用连接linux服务器去操作的繁琐。贼拉好用哦

---

本文结束，谢谢