前言
本文通过 Docker 部署 SpringBoot 带你快速了解 Docker 简单使用 Demo 级别操作。谨以此文献给刚入门的小白,大牛勿喷。
通过本文你将了解到如下内容:
-
Docker 是什么以及 Docker专用名词
-
Docker 安装
-
快速创建SprngBoot项目
-
SprngBoot项目 Docker化
了解 Docker 以及相关的专有名词
学习一门东西你要先搞懂怎么使用它。以及使用它的一些操作用语。
就好比你去驾校学车,教练首先给你讲这个是方向盘,那个个是油门、还有就是这个刹车一定要记住,关键时刻可以保命!
介绍完汽车基本操作东西后,教练才会具体教你怎么让车启动并慢慢跑起来。
首先需要说明一下 Docker 是将程序隔离打包的一种容器技术,也被称为“轻量级”虚拟化技术。
关于容器技术与物理机和虚拟机的区别可以参考 yibuchen 的 2 篇关于这块内容介绍:
-
物理机、虚拟机、容器的比较(一)
-
物理机、虚拟机、容器的比较(二)
其次是 Docker 就不得不提三个知识点:镜像、容器、仓库,Docker 必学的三要素,那它们具体代码什么意思呢?听小奎给你慢慢道来。
-
镜像:就相当于是一个 root 文件系统。比如官方镜像 ubuntu:16.04 就包含了完整的一套 Ubuntu16.04 最小系统的 root 文件系统。可以理解成启动容器的模板
-
容器:容器,其实是一种特殊的进程而已。Docker 为该进程划分一个独立空间
-
仓库:是用来存储镜像的,可以理解成专门存储镜像的仓库。
镜像(Image)和容器(Container)的关系,就像是面向对象程序设计中的类和实例一样。
镜像是静态的定义,我们一般是通过 Dockerfile 来构建文件创建自定义镜像。
容器是镜像运行时的实体。容器可以被创建、启动、停止、删除、暂停等。
实战操作
安装Docker
可以直接去 https://hub.docker.com/ 下载安装包进行下载安装,前提是需要注册一个账号。
❝官方提供了2个安装包连接分别为:edge 和 stable,这2个安装包区别如下:edge:尝鲜版 每个月发布一次 可能存在一定问题 stable:稳定版 每个季度更新一次 相对稳定的版本 初学者建议下载stable进行安装。
配置Docker镜像加速
点击任务栏中docker图标然后点击 Settings 后如下图所示配置镜像加速地址
图片由程序员小奎创作
其他镜像配置也可以参考菜鸟教程:
https://www.runoob.com/docker/docker-mirror-acceleration.html
可选的镜像加速地址如下:
-
Docker官方提供的中国镜像库地址:https://registry.docker-cn.com
-
七牛云加速器地址:https://reg-mirror.qiniu.com
-
网易的镜像地址:http://hub-mirror.c.163.com
-
阿里云镜像地址:每个阿里云账号提供一个唯一的地址
关于阿里云镜像操作请参考:Docker(二)使用阿里云docker镜像加速 By 路西法_Lucifer
搭建SpringBoot 项目并将其 Docker化
第一步:创建 maven 项目然后引入 SpringBoot的 Parent 依赖。
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.0.RELEASE</version>
<relativePath/>
</parent>
第二步:引入 SpringBoot web stater 依赖。
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
第三步:在 build 标签内添加 finalName标签配置SpringBoot项目可执行jar包的名称。具体代码如下:
<finalName>demo</finalName>
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>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.0.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>org.example</groupId>
<artifactId>demo</artifactId>
<version>1.0-SNAPSHOT</version>
<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>
<finalName>demo</finalName>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
<!-- 5、添加插件指定jdk -->
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
<fork>true</fork>
</configuration>
</plugin>
</plugins>
</build>
</project>
第四步:创建 SpringBoot的启动类 在src/main/java 目录下,具体代码如下:
package cn.cxyxiaokui.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
第五步:创建用于测试的Controller,具体代码如下:
package cn.cxyxiaokui.demo.controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HelloDockerController {
@GetMapping("/hello")
public String hello(){
return "hello docker";
}
}
第六步:在demo项目中创建 Dockerfile,具体内容如下:
FROM openjdk:8
MAINTAINER zhuoqianmingyue ljk126wy@126.com
COPY target/demo.jar /demo.jar
ENTRYPOINT ["java", "-jar", "/demo.jar"]
Dockerfile 内容介绍
# FROM 自定义的镜像基于 java:8镜像创建。
FROM openjdk:8
# MAINTAINER 作者的信息
MAINTAINER zhuoqianmingyue ljk126wy@126.com
# COPY 拷贝target目录下的demo.jar 到自定义镜像中。
COPY target/demo.jar /demo.jar
# 运行程序执行的命令,相当于在命令窗口中执行 java -jar demo.jar
ENTRYPOINT ["java", "-jar", "/demo.jar"]
第七步:在 demo项目中创建构建镜像的脚本 build.sh,具体内容如下:
#!/usr/bin/env bash
# 将SpringBoot 项目打包
mvn package
# 根据当前目录下Dockerfile配置文件创建镜像
docker build -t demo:latest .
demo:latest :demo 表示镜像的名称,latest 表示版本号。
项目的目录结构如下图所示:
├── Dockerfile
├── README.md
├── build.sh
├── pom.xml
└── src
├── main
│ ├── java
│ │ └── cn
│ │ └── cxyxiaokui
│ │ └── demo
│ │ ├── DemoApplication.java
│ │ └── controller
│ │ └── HelloDockerController.java
│ └── resources
│ └── application.properties
└── test
└── java
└── cn
└── cxyxiaokui
└── demo
└── DemoApplicationTests.java
第八步:选中 build.sh 然后右击选择Run build.sh 执行脚本,或者通过 sh build.sh 执行该脚本。打包过程会有点慢,执行过程中请耐心等待。
tomlee@MacBook-Pro-3 demo % sh build.sh
如出现如下所示内容表示执行成功!
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 8.336 s
[INFO] Finished at: 2023-10-29T10:25:55+08:00
[INFO] ------------------------------------------------------------------------
Sending build context to Docker daemon 16.71MB
Step 1/4 : FROM openjdk:8
8: Pulling from library/openjdk
Digest: sha256:86e863cc57215cfb181bd319736d0baf625fe8f150577f9eb58bd937f5452cb8
Status: Downloaded newer image for openjdk:8
---> b273004037cc
Step 2/4 : MAINTAINER cxyxiaokui ljk126wy@126.com
---> Running in e5d6be851ad3
Removing intermediate container e5d6be851ad3
---> 6978f6d0bc81
Step 3/4 : COPY target/demo.jar /demo.jar
---> a2aefab244c3
Step 4/4 : ENTRYPOINT ["java", "-jar", "/demo.jar"]
---> Running in 55854ea57bee
Removing intermediate container 55854ea57bee
---> 151bc5c33e07
Successfully built 151bc5c33e07
Successfully tagged demo:latest
执行成功后可以通过 docker images 查看生成的镜像。
tomlee@MacBook-Pro-3 demo % docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
demo latest 151bc5c33e07 About a minute ago 543MB
通过 demo:latest 镜像启动一个容器,执行的命令如下:
docker run -idt -p 8080:8080 demo:latest
如下所示表示执行成功
tomlee@MacBook-Pro-3 demo % docker run -idt -p 8080:8080 demo:latest
c5d686654d9134db642428073a69c2062de473c9b96bef553e184b79762f05d3
启动 demo 项目镜像参数介绍
docker run 根据镜像启动容器
-
-i 以交互模式运行容器,通常与 -t 同时使用。
-
-t 为容器重新分配一个伪输入终端,通常与 -i 同时使用。
-
-d 后台运行容器,并返回容器ID。
-
-p 指定端口映射,格式为:主机(宿主)端口:容器端口。
-
demo:latest 镜像名称:镜像版本号。
docker ps 查看正在运行的镜像
tomlee@MacBook-Pro-3 demo % docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
f242ab8fb29f demo:latest "java -jar /demo.jar" 2 minutes ago Up 2 minutes 0.0.0.0:8080->8080/tcp
-
CONTAINER_ID:容器ID
-
IMAGE:具体的镜像
-
COMMOND:运行程序执行的命令
-
STATUS:容器的状态
-
PORTS:容器映射的端口
-
NAMES:容器的名称
通过 docker logs -f 容器ID 查看 SpringBoot 项目启动日志,具体操作如下。
tomlee@MacBook-Pro-3 demo % docker logs -f c5d686654d9134d
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.1.0.RELEASE)
2023-10-29 02:28:44.622 INFO 1 --- [ main] cn.cxyxiaokui.demo.DemoApplication : Starting DemoApplication v1.0-SNAPSHOT on f242ab8fb29f with PID 1 (/demo.jar started by root in /)
2023-10-29 02:28:44.631 INFO 1 --- [ main] cn.cxyxiaokui.demo.DemoApplication : No active profile set, falling back to default profiles: default
2023-10-29 02:28:47.105 INFO 1 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8080 (http)
2023-10-29 02:28:47.146 INFO 1 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat]
2023-10-29 02:28:47.147 INFO 1 --- [ main] org.apache.catalina.core.StandardEngine : Starting Servlet Engine: Apache Tomcat/9.0.12
2023-10-29 02:28:47.168 INFO 1 --- [ main] o.a.catalina.core.AprLifecycleListener : The APR based Apache Tomcat Native library which allows optimal performance in production environments was not found on the java.library.path: [/usr/java/packages/lib/amd64:/usr/lib64:/lib64:/lib:/usr/lib]
2023-10-29 02:28:47.309 INFO 1 --- [ main] o.a.c.c.C.[Tomcat].[localhost].[/sbe] : Initializing Spring embedded WebApplicationContext
2023-10-29 02:28:47.309 INFO 1 --- [ main] o.s.web.context.ContextLoader : Root WebApplicationContext: initialization completed in 2584 ms
2023-10-29 02:28:47.361 INFO 1 --- [ main] o.s.b.w.servlet.ServletRegistrationBean : Servlet dispatcherServlet mapped to [/]
2023-10-29 02:28:47.369 INFO 1 --- [ main] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter: 'characterEncodingFilter' to: [/*]
2023-10-29 02:28:47.369 INFO 1 --- [ main] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter: 'hiddenHttpMethodFilter' to: [/*]
2023-10-29 02:28:47.369 INFO 1 --- [ main] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter: 'formContentFilter' to: [/*]
2023-10-29 02:28:47.370 INFO 1 --- [ main] o.s.b.w.servlet.FilterRegistrationBean : Mapping filter: 'requestContextFilter' to: [/*]
2023-10-29 02:28:47.725 INFO 1 --- [ main] o.s.s.concurrent.ThreadPoolTaskExecutor : Initializing ExecutorService 'applicationTaskExecutor'
2023-10-29 02:28:48.291 INFO 1 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path ''
2023-10-29 02:28:48.299 INFO 1 --- [ main] cn.cxyxiaokui.demo.DemoApplication : Started DemoApplication in 4.481 seconds (JVM running for 5.866)
通过 Docker 启动一个容器可以理解成创建了一个Linux的虚拟机,并在该虚拟机中运行我们的程序。
可以通过 docker exec -it 容器ID /bin/bash
进入容器(也可以理解成进入Linux的虚拟机)。
执行 curl localhost:8080/hello
在虚拟机本地访问运行SpringBoot 项目,具体操作如下:
tomlee@MacBook-Pro-3 demo % docker exec -it c5d686654d91 /bin/bash
root@c5d686654d91:/# curl localhost:8080/hello
hello docker
退出可以通过 exit 退出该容器。
通过游览器可以直接访问镜像部署的 SpringBoot 项目,具体效果如下所示:
图片由程序员小奎创作
关于使用 Windows 系统的坑
小奎之前使用 Windows 机器直接通过游览器执行 localhost是访问不了的。
这个问题各种百度大部分介绍都是通过执行docker-machine ip default 查看虚拟机的 ip 但是我执行后是这样的
图片由程序员小奎创作
命令建议我们通过 docker-machine ls 查看,具体操作如下:
图片由程序员小奎创作
自己对 docker-machine 操作不是很熟,希望有解决了的小伙伴私信我。
Windows 系统下虽然通过 docker-machine 没有获取到虚拟机的 ip ,但是我通过另外的方式获取到了,具体操作如下:
执行ipconfig 查看Docker 虚拟主机的 ip,具体操作如下:
图片由程序员小奎创作
然后通过ip 访问以SpringBoot 搭建的 Demo 项目。
❝需要说明的是我目前使用机器操作系统是 MacOS
小结
到这里所有操作执行完毕!接下来开始做一个简单的总结,将一个 SpringBoot Docker 化的具体操作步骤如下:
-
创建SpringBoot项目
-
定义Dockerfile 文件来创建自定义镜像
-
通过自定义镜像启动容器。
-
查看容器中应用程序的日志以及访问运行中的程序
关于镜像、容器、Dockerfile 常用的操作命令如下:
命令 | 用途 | 示例 |
---|---|---|
docker images | 查看主机上的镜像列表 | docker images |
docker pull | 下载镜像到本地主机 | docker pull redis:latest |
docker search | 查找镜像 | docker search redis |
docker rmi 镜像名称 | 删除镜像 | docker rmi demo |
docker tag 镜像ID 用户名称/镜像源名(repository name):新的标签名(tag) | 为镜像打标签 | docker tag 860c279d2fec zqmy/demo:5.3 |
docker ps | 查看启动中的容器 | docker ps |
docker ps -a | 查看启动容器历史记录 | docker ps -a |
docker run | 启动容器 | docker run -itd --name redis-test -p 6379:6379 redis |
docker stop <容器 ID> | 停止容器 | docker stop a750ccbcad88 |
docker restart <容器 ID> | 重启容器 | docker restart a750ccbcad88 |
docker exec -it <容器 ID> /bin/bash | 进入容器 | docker exec -it a750ccbcad88 /bin/bash |
docker rm -f <容器 ID> | 删除容器 | docker rm -f a750ccbcad88 |
docker log -f <容器 ID> | 查看容器日志输出 | docker log -f a750ccbcad88 |