Spring boot 開發輕巧的微服務提供了便利,Docker 的發展又極大的方便了微服務的部署。這篇文章介紹一下如果借助 maven 來快速的生成微服務的鏡像以及快速啟動服務。
其實將 Spring Boot 項目用 Docker 部署也不是什么多么神秘的技術,也要先生成鏡像,再用鏡像啟動容器,如果說有什么方便的地方,也就是一些工具可以幫助我們節省手動操作的過程。
知識背景:
掌握 docker 的安裝以及基本的操作,熟悉 Dockerfile 文件創建鏡像的方法。
創建 Spring boot 項目
1、添加 application.yml 配置文件
server:
port: 7000
spring:
application:
name: spring-boot-docker-sample
2、創建項目啟動文件
@SpringBootApplication
public class Application {
public static void main(String[] args){
SpringApplication.run(Application.class, args);
}
}
3、添加一個 RestController 用於服務是否正常可用
@RestController
public class DockerController {
@GetMapping(value = "hello")
public Object sayHello(){
return "hello! spring boot with docker.";
}
}
之后啟動服務,訪問 localhost:7000/hello 查看,如果正常訪問,則進入下一步操作。
利用 maven 插件生成鏡像文件
我們這里用到的 Maven 插件是 dockerfile-maven-plugin
。
1、在 pom 文件中添加上述插件依賴
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
<plugin>
<groupId>com.spotify</groupId>
<artifactId>dockerfile-maven-plugin</artifactId>
<version>1.4.9</version>
<executions>
<execution>
<id>tag-latest</id>
<phase>deploy</phase>
<goals>
<goal>build</goal>
<goal>tag</goal>
<goal>push</goal>
</goals>
<configuration>
<tag>latest</tag>
</configuration>
</execution>
<execution>
<id>tag-version</id>
<phase>deploy</phase>
<goals>
<goal>build</goal>
<goal>tag</goal>
<goal>push</goal>
</goals>
<configuration>
<tag>${project.version}</tag>
</configuration>
</execution>
</executions>
</plugin>
2、這個 maven 插件是依賴於 Dockerfile 文件的,所以使用命令之前需要先手動創建 Dockerfile 文件,注意這個 Dockerfile 文件要和 pom.xml 文件同級,簡單的 Dockerfile 內容如下:
FROM openjdk:8-jdk-alpine
VOLUME /tmp
COPY target/docker-sample-1.0-SNAPSHOT.jar app.jar
ENTRYPOINT ["java","-jar","/app.jar"]
簡單解釋一下:
- 先從中央倉庫或者你配置的代理倉庫(如阿里雲鏡像倉庫)拉取 openjdk 鏡像;
- 然后設置一個掛載點;
- 拷貝 target 目錄下的 Spring boot 項目運行包,並改名為 app.jar;
- 設置啟動命令 java -jar app.jar
3、然后使用命令 sudo mvn package dockerfile:build
就可以生成鏡像到本地倉庫了,生成后的鏡像如下:
這一步翻譯為 docker 命令的話就是下面兩條:
docker build -t registry.cn-beijing.aliyuncs.com/fengzheng/kite:1.0-SNAPSHOT .
docker build -t registry.cn-beijing.aliyuncs.com/fengzheng/kite:latest
4、之后根據生成的鏡像,就可以以 docker 方式啟動服務了
docker run -d -p 7000:7000 registry.cn-beijing.aliyuncs.com/fengzheng/kite:latest
將鏡像推送到阿里雲 docker 倉庫
訪問 https://dev.aliyun.com/search.html,然后隨意輸入一個鏡像名稱,例如 redis,如果你沒有注冊過,阿里雲便會調到登錄注冊頁,之后按照提示注冊即可。
注冊成功后,到鏡像管理界面,會提示你輸入鏡像倉庫服務的密碼,也就是下方配置文件中的 Registry登錄密碼。
注冊成功后,設置一個命名空間,並在命名空間下新建一個倉庫。例如本例中我設置的命名空間是fengzheng
,倉庫名稱為 kite
。
之后,在 pom.xml 文件中 plugin 節點增加如下配置:
<configuration>
<username>阿里雲賬號名</username>
<!--在容器鏡像服務控制台"設置Registry登錄密碼"-->
<password>Registry登錄密碼</password>
<!--registry.cn-hangzhou.aliyuncs.com/namespace/repositoryname-->
<repository>registry.cn-beijing.aliyuncs.com/fengzheng/kite</repository>
<tag>latest</tag>
<buildArgs>
<JAR_FILE>${project.build.finalName}.jar</JAR_FILE>
</buildArgs>
</configuration>
設置好用戶名和密碼,倉庫地址等參數,因為是私有倉庫,所以需要用戶名和密碼。
然后運行命令,將以 latest
和 ${project.version}
為 tag 的鏡像推送到阿里雲鏡像倉庫。
sudo mvn dockerfile:push
或者,運行命令,發布某一個指定 tag 的鏡像。
sudo mvn dockerfile:push@tag-version
或
sudo mvn dockerfile:push@tag-latest