欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  网络运营

Docker容器化spring boot应用详解

程序员文章站 2022-12-06 20:47:16
前置条件 容器化spring boot应用所需环境: jdk 1.8 + maven 3.0 + 我们的需求是:使用maven打包,将sprin...

前置条件

容器化spring boot应用所需环境:

  1. jdk 1.8 +
  2. maven 3.0 +

我们的需求是:使用maven打包,将spring boot应用制作成docker镜像并上传到docker hub。在其他机器上,可以直接docker pull并运行容器。

创建spring boot应用

spring boot 包结构为:

└── src
  └── main
    └── java
      └── me
        └── ithakar

创建spring boot application主类,src/main/java/me/ithakar/application.java

package me.ithakar;

import org.springframework.boot.springapplication;
import org.springframework.boot.autoconfigure.springbootapplication;
import org.springframework.web.bind.annotation.requestmapping;
import org.springframework.web.bind.annotation.restcontroller;

@springbootapplication
@restcontroller
public class application {

  @requestmapping("/")
  public string home() {
    return "docker app running";
  }

  public static void main(string[] args) {
    springapplication.run(application.class, args);
  }

}

pom.xml:

<?xml version="1.0" encoding="utf-8"?>
<project xmlns="http://maven.apache.org/pom/4.0.0" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
  xsi:schemalocation="http://maven.apache.org/pom/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelversion>4.0.0</modelversion>

  <groupid>me.ithakar</groupid>
  <artifactid>docker-app</artifactid>
  <version>0.1.0</version>

  <parent>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-parent</artifactid>
    <version>1.5.3.release</version>
  </parent>

  <properties>
    <java.version>1.8</java.version>
  </properties>

  <dependencies>
    <dependency>
      <groupid>org.springframework.boot</groupid>
      <artifactid>spring-boot-starter-web</artifactid>
    </dependency>
    <dependency>
      <groupid>org.springframework.boot</groupid>
      <artifactid>spring-boot-starter-test</artifactid>
      <scope>test</scope>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupid>org.springframework.boot</groupid>
        <artifactid>spring-boot-maven-plugin</artifactid>
      </plugin>
    </plugins>
  </build>

</project>

打包并启动应用

mvn package && java -jar target/docker-app-0.1.0.jar

访问 http://localhost:8080/ ,获得响应:

docker app running

则spring boot应用启动成功

创建dockerfile文件

dockerfile是一个文本文件,类似shell脚本,其内包含了一条条的指令。每一条指令的内容,就是描述对应的镜像层应当如何构建。

dockerfile位置:src/main/docker/dockerfile

from frolvlad/alpine-oraclejdk8:slim 
volume /tmp 
add docker-app-0.1.0.jar app.jar 
run sh -c 'touch /app.jar' 
env java_opts="" 
entrypoint [ "sh", "-c", "java $java_opts -djava.security.egd=file:/dev/./urandom -jar /app.jar" ]
  1. from 命令指定基础镜像,以一个镜像为基础,在其上进行定制。在这里我们的基础镜像是frolvlad/alpine-oraclejdk8:slim。
  2. volume 定义匿名卷。对于可能需要操作数据库类需要保存动态数据的应用,其数据文件应该保存在主句的卷,而不是容器的储存层。在这里我们是将其挂载在了/tmp这个位置,从而保证了容器的无状态化。
  3. add 命令是较高级的复制命令,将jar包复制到/app.jar
  4. entrypoint 容器运行后默认执行的命令

添加maven docker插件

是为了方便java开发者,由spotify公司开发的一款maven插件。添加以下代码至pom.xml文件中。

<properties>
  <docker.image.prefix>ithaka</docker.image.prefix>
</properties>
<build>
  <plugins>
    <plugin>
      <groupid>com.spotify</groupid>
      <artifactid>docker-maven-plugin</artifactid>
      <version>0.4.11</version>
      <configuration>
        <imagename>${docker.image.prefix}/${project.artifactid}:${project.version}</imagename>
        <dockerdirectory>src/main/docker</dockerdirectory>
        <pushimage>true</pushimage>
        <resources>
          <resource>
            <targetpath>/</targetpath>
            <directory>${project.build.directory}</directory>
            <include>${project.build.finalname}.jar</include>
          </resource>
        </resources>
      </configuration>
    </plugin>
  </plugins>
</build>

注意,docker.image.prefix中的ithaka为我的docker hub 账户,使用时将其换成自己的

使用maven命令打包应用、构建docker镜像并上传镜像到docker hub:

mvn package docker:build -dpushimage

此时我们将得到一个报错:

[error] failed to execute goal com.spotify:docker-maven-plugin:0.4.11:build (default-cli) on project docker-app: exception caught: denied: requested access to the resource is denied

这是因为我们在maven中push时,并没有包含docker的用户信息,所以权限校验失败。

解决方法为,在maven全局setting.xml配置中,添加docker hub server信息

<server>
    <id>docker-hub</id>
    <username>ithaka</username>
    <password>密码</password>
    <configuration>
      <email>邮箱</email>
    </configuration>
</server>

在pom.xml中的docker-maven-plugi插件中,指定server

<plugin>
  <groupid>com.spotify</groupid>
  <artifactid>docker-maven-plugin</artifactid>
  <configuration>
    <serverid>docker-hub</serverid>
  </configuration>
</plugin>

再继续执行

mvn package docker:build -dpushimage

出现

the push refers to a repository [docker.io/ithaka/docker-app]
8c02854cd300: pushed
a03c3b5dbe04: pushed
8018d52798bb: pushed
1e6468b956ae: pushed
3fb66f713c9f: pushed

0.0.1: digest: sha256:63456345745755577c19103dcf4838894e34d45a68a1ec23b2f69d6f059 size: 1375

即为上传docker hub成功。

启动docker容器

在另外一台机器上,执行命令

docker run -p 8080:8080 -t ithaka/docker-app

访问http://ip:8080/ ,获得响应:

docker app running

docker应用启动成功

参考文档:

spring boot with docker


以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。