使用 Docker 部署 Spring Boot 項目
Docker 介紹
Docker 屬于 Linux 容器的一種封裝,提供簡單易用的容器使用接口。它是目前最流行的 Linux 容器解決方案。
Docker 将應用程式與該程式的依賴,打包在一個檔案裡面。運作這個檔案,就會生成一個虛拟容器。程式在這個虛拟容器裡運作,就好像在真實的實體機上運作一樣。有了 Docker,就不用擔心環境問題。
總體來說,Docker 的接口相當簡單,使用者可以友善地建立和使用容器,把自己的應用放入容器。容器還可以進行版本管理、複制、分享、修改,就像管理普通的代碼一樣。
Docker 的主要用途
(1)提供一次性的環境。比如,本地測試他人的軟體、持續內建的時候提供單元測試和建構的環境。
(2)提供彈性的雲服務。因為 Docker 容器可以随開随關,很适合動态擴容和縮容。
(3)組建微服務架構。通過多個容器,一台機器可以跑多個服務,是以在本機就可以模拟出微服務架構。
Docker 的安裝(CentOS環境)
安裝指令
yum install docker
安裝完成後,使用下面的指令來啟動 docker 服務,并将其設定為開機啟動
service docker start
chkconfig docker on
LCTT 譯注:此處采用了舊式的 sysv 文法,如采用CentOS 7中支援的新式 systemd 文法,如下:
systemctl start docker.service
systemctl enable docker.service
使用Docker 中國加速器
vi /etc/docker/daemon.json
添加後:
{
"registry-mirrors": ["https://registry.docker-cn.com"],
"live-restore": true
}
重新啟動docker
systemctl restart docker
輸入 docker version 傳回版本資訊則安裝正常。
安裝JDK
yum -y install java-1.8.0-openjdk*
配置環境變量 打開 vim /etc/profile 添加一下内容
export JAVA_HOME=/usr/lib/jvm/jre-1.8.0-openjdk-1.8.0.242.b08-0.el7_7.x86_64
export CLASSPATH=.:$JAVA_HOME/jre/lib/rt.jar:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
export PATH=$PATH:$JAVA_HOME/bin
修改完成之後,使其生效
source /etc/profile
輸入java -version 傳回版本資訊則安裝正常。
安裝 MAVEN
下載下傳:
https://mirror.bit.edu.cn/apache/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz解壓
tar vxf apache-maven-3.6.3-bin.tar.gz
移動
mv apache-maven-3.6.3 /usr/local/maven3
修改環境變量, 在/etc/
MAVEN_HOME=/usr/local/maven3
export MAVEN_HOME
export PATH=${PATH}:${MAVEN_HOME}/bin
執行source /etc/profile使環境變量生效。
輸入mvn -version 傳回版本資訊則安裝正常。
到止,通過docker,jdk,maven的安裝,整個建構環境算配置完成了。
建立 spring boot 項目
pom.xml
<?xml version="1.0" encoding="UTF-8"?>
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.2.4.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.easy</groupId>
<artifactId>spring-boot-docker</artifactId>
<version>1.0</version>
<packaging>jar</packaging>
<name>spring-boot-docker</name>
<description>Demo project for Spring Boot</description>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<java.version>1.8</java.version>
<docker.image.prefix>springboot</docker.image.prefix>
</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>
<!-- Docker maven plugin -->
<plugin>
<groupId>com.spotify</groupId>
<artifactId>docker-maven-plugin</artifactId>
<version>1.0.0</version>
<configuration>
<imageName>${docker.image.prefix}/${project.artifactId}</imageName>
<dockerDirectory>src/main/docker</dockerDirectory>
<resources>
<resource>
<targetPath>/</targetPath>
<directory>${project.build.directory}</directory>
<include>${project.build.finalName}.jar</include>
</resource>
</resources>
</configuration>
</plugin>
<!-- Docker maven plugin -->
</plugins>
</build>
Dockerfile 配置
FROM openjdk:8-jdk-alpine
VOLUME /tmp
EXPOSE 8282
ADD spring-boot-docker-1.0.jar app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]
Dockerfile 檔案介紹,建構 Jdk 基礎環境,添加 Spring Boot Jar 到鏡像中:
FROM,表示使用 Jdk8 環境 為基礎鏡像,如果鏡像不是本地的會從 DockerHub 進行下載下傳
VOLUME,VOLUME 指向了一個/tmp的目錄,由于 Spring Boot 使用内置的Tomcat容器,Tomcat 預設使用/tmp作為工作目錄。這個指令的效果是:在主控端的/var/lib/docker目錄下建立一個臨時檔案并把它連結到容器中的/tmp目錄
EXPOSE,EXPOSE 指令是聲明運作時容器提供服務端口,這隻是一個聲明,在運作時并不會因為這個聲明應用就會開啟這個端口的服務。在 Dockerfile 中寫入這樣的聲明有兩個好處,一個是幫助鏡像使用者了解這個鏡像服務的守護端口,以友善配置映射;另一個用處則是在運作時使用随機端口映射時,也就是 docker run -P 時,會自動随機映射 EXPOSE 的端口。
ADD,拷貝檔案并且重命名
ENTRYPOINT,為了縮短 Tomcat 的啟動時間,添加java.security.egd的系統屬性指向/dev/urandom作為 ENTRYPOINT
其它示例代碼
DockerController.java
@RestController
public class DockerController {
@RequestMapping("/")
public String index() {
return "Hello Docker!";
}
DockerApplication.java
@SpringBootApplication
public class DockerApplication {
public static void main(String[] args) {
SpringApplication.run(DockerApplication.class, args);
}
application.properties
server.port=8282
将項目 docker 拷貝至伺服器中,進入項目路徑下進行打包測試。
打包
mvn package
啟動
java -jar target/spring-boot-docker-1.0.jar
看到 Spring Boot 的啟動日志後表明環境配置沒有問題,接下來我們使用 DockerFile 建構鏡像。
mvn package docker:build
第一次建構可能有點慢,當看到以下内容的時候表明建構成功:
Step 1/5 : FROM openjdk:8-jdk-alpine
---> a3562aa0b991
Step 2/5 : VOLUME /tmp
---> Using cache
---> d070c927d0a7
Step 3/5 : EXPOSE 8282
---> b16d14267527
Step 4/5 : ADD spring-boot-docker-1.0.jar app.jar
---> c4ddc409b458
Removing intermediate container c58c986e6b9a
Step 5/5 : ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -jar /app.jar
---> Running in d2b61fddd616
---> 13c600d3f625
Removing intermediate container d2b61fddd616
Successfully built 13c600d3f625
[INFO] Built springboot/spring-boot-docker
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] Total time: 7.273 s
[INFO] Finished at: 2020-03-25T10:05:04+08:00
使用docker images指令檢視建構好的鏡像:
docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
springboot/spring-boot-docker latest 13c600d3f625 18 minutes ago 122 MB
docker.io/openjdk 8-jdk-alpine a3562aa0b991 10 months ago 105 MB
springboot/spring-boot-docker 就是我們建構好的鏡像,下一步就是運作該鏡像
docker run -p 8282:8282 -t springboot/spring-boot-docker
啟動完成之後我們使用docker ps檢視正在運作的鏡像:
docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
a626c3dbdb1b springboot/spring-boot-docker "java -Djava.secur..." 34 seconds ago Up 34 seconds 0.0.0.0:8282->8282/tcp suspicious_murdock
可以看到我們建構的容器正在在運作,通路浏覽器:
http://192.168.0.x:8282/,傳回
Hello Docker!
說明使用 Docker 部署 Spring Boot 項目成功!
資料
示例代碼-github
Docker 入門教程
Spring Boot 2 (四):使用 Docker 部署 Spring Boot
原文位址
https://www.cnblogs.com/tqlin/p/12564491.html