### 歡迎訪問我的GitHub
> 這裡分類和彙總了欣宸的全部原創(含配套原始碼)：[https://github.com/zq2599/blog_demos](https://github.com/zq2599/blog_demos)

- 近期在用Jib外掛將Java工程構建成Docker映象，使用時遇到過一些小問題，今天對這些問題做個小結；
### 關於Jib外掛
- Jib是用於構建Docker映象的Maven外掛，其基本用法請參考[《Docker與Jib(maven外掛版)實戰》](https://blog.csdn.net/boling_cavalry/article/details/94355659)一文；
### 全文概覽
- 本文由以下幾部分組成：
1. 環境資訊
2. 原始碼下載
3. 小結一：三種構建引數
4. 小結二：映象的時間問題
5. 小結三：多次構建後，積累的無用映象問題
6. 小結四：提升構建速度
7. 小結五：將jib與mvn構建的生命週期繫結
8. 小結六：父子結構的maven工程如何構建
### 環境資訊
1. 作業系統：CentOS Linux release 7.6.1810
2. docker：1.13.1
3. jdk：1.8.0_191
4. maven：3.6.0
5. jib外掛：1.3.0
### 原始碼下載
- 本次實戰用到的原始碼是個簡單的maven工程，可以從GitHub上下載本次實戰的原始碼，地址和連結資訊如下表所示：

| 名稱      |   連結 |   備註|
| :-------- | :----| :----|
| 專案主頁| https://github.com/zq2599/blog_demos | 該專案在GitHub上的主頁 |
| git倉庫地址(https)| https://github.com/zq2599/blog_demos.git | 該專案原始碼的倉庫地址，https協議 |
| git倉庫地址(ssh)| git@github.com:zq2599/blog_demos.git | 該專案原始碼的倉庫地址，ssh協議 |

- 這個git專案中有多個資料夾，本章的原始碼在hellojib資料夾下，如下圖紅框所示：
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20190630222504867.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly94aW5jaGVuLmJsb2cuY3Nkbi5uZXQ=,size_16,color_FFFFFF,t_70)

### 小結一：三種構建引數
- 對於一個已在pom.xml中配置了jib外掛的java工程來說，下面是個標準的構建命令：
```shell
mvn compile jib:dockerBuild
```
- 注意上面的 **dockerBuild** 引數，該引數的意思是將映象存入當前的映象倉庫，這樣的引數一共有三種，列表說明：
| 引數名 | 作用 |
|--|--|
| dockerBuild | 將映象存入當前映象倉庫，該倉庫是當前docker客戶端可以連線的docker daemon，一般是指本地映象倉庫 |
| build | 將映象推送到遠端倉庫，倉庫位置與映象名字的字首有關，一般是hub.docker.com，使用該引數時需要提前登入成功 |
| buildTar | 將映象生成tar檔案，儲存在專案的target目錄下，在任何docker環境執行 docker load --input xxx.tar即可匯入到本地映象倉庫 |
### 小結二：映象的時間問題
- 在使用命令 **mvn compile jib:dockerBuild** 構建本地映象時，會遇到建立時間不準的問題：
- 如下所示， **bolingcavalry/hellojib** 是剛剛使用jib外掛構建的映象，其生成時間(CREATED欄位)顯示的是 **49 years ago** ：
```shell
[root@maven hellojib]# docker images
REPOSITORY               TAG                 IMAGE ID            CREATED             SIZE
bolingcavalry/hellojib   0.0.1-SNAPSHOT      ef96fdd4473a        49 years ago        505 MB
```
- 上面顯示的映象生成時間顯然是不對的，改正此問題的方法是修改pom.xml，在jib外掛的container節點內增加 **useCurrentTimestamp** 節點，內容是true，如下所示：
```xml
<plugin>
                <groupid>com.google.cloud.tools</groupid>
                <artifactid>jib-maven-plugin</artifactid>
                <version>1.3.0</version>
                <configuration>
                    
                    <from>
                        
                        <image>openjdk:8u212-jdk-stretch</image>
                    </from>
                    <to>
                        
                        <image>bolingcavalry/hellojib:${project.version}</image>
                    </to>
                    
                    <container>
                        
                        <jvmflags>
                            <jvmflag>-Xms4g</jvmflag>
                            <jvmflag>-Xmx4g</jvmflag>
                        </jvmflags>
                        
                        <ports>
                            <port>8080</port>
                        </ports>
                        
                        <usecurrenttimestamp>true</usecurrenttimestamp>
                    </container>
                </configuration>
            </plugin>

```
- 修改儲存後再次構建，此時新的映象的建立時間已經正確，顯示 **15 seconds ago** ：
```shell
[root@maven hellojib]# docker images
REPOSITORY               TAG                 IMAGE ID            CREATED             SIZE
bolingcavalry/hellojib   0.0.1-SNAPSHOT      ee5ba19a8016        23 seconds ago      505 MB
<none>                   <none>              ef96fdd4473a        49 years ago        505 MB
```
### 小結三：多次構建後，積累的無用映象
- 如下所示，構建多次後，本地會遺留多個名為\<none>，tag也是\<none>的映象：
```shell
[root@maven hellojib]# docker images
REPOSITORY               TAG                 IMAGE ID            CREATED              SIZE
bolingcavalry/hellojib   0.0.1-SNAPSHOT      a9fd91d8ad8c        17 seconds ago       505 MB
<none>                   <none>              a0cadeb9febd        About a minute ago   505 MB
<none>                   <none>              ee5ba19a8016        2 minutes ago        505 MB
<none>                   <none>              ef96fdd4473a        49 years ago         505 MB
```
- 這些都是上一次構建的結果，在經歷了新一輪的構建後，其映象名和tag被新映象所有，所以自身只能顯示名為\<none>，tag也是\<none>，清理這些映象的命令是 **docker image prune** ，然後根據提示輸入"y"，映象即可被清理：
```shell
[root@maven hellojib]# docker image prune
WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N] y
Deleted Images:
deleted: sha256:7aa104e20b8a08bac3255f2627ac90f10021c6630370ce7a84ba33f89404b153
deleted: sha256:7dd7376ae00c2df0411bac1eded4b3c79dd1528f5711057fe11a4f4121504486
deleted: sha256:e71ced47e80a7fccfea1710f1e5a257d4e16fc3e96b05616007e15829e71a7b2
deleted: sha256:55bed58453479c2accfc08fabc929aece7d324af0df94335dd46333db9da1d23
deleted: sha256:ef96fdd4473a7ca9d39a50e0feae50131de083cee4f11060ad8bee1bc853b2b5

Total reclaimed space: 0 B
[root@maven hellojib]# docker images
REPOSITORY               TAG                 IMAGE ID            CREATED              SIZE
bolingcavalry/hellojib   0.0.1-SNAPSHOT      3afd4165b6b6        About a minute ago   505 MB
```
### 小結四：提升構建速度
- 在使用命令 **mvn compile jib:dockerBuild** 構建本地映象時，每次構建的過程中都會提示以下資訊：
```shell
[INFO] Containerizing application to Docker daemon as bolingcavalry/hellojib:0.0.1-SNAPSHOT...
[INFO] The base image requires auth. Trying again for openjdk:8-jdk-stretch...
[INFO] Executing tasks:
[INFO] [=========                     ] 30.0% complete
[INFO] > pulling base image manifest
```
- 每次構建都會顯示上面的內容，也就是說每次都去遠端拉取base映象的manifest(pulling base image manifest)，這部分時間導致整體構架時間變長，以下是構建結果，可見用了10秒：
```shell
[INFO] Built image to Docker daemon as bolingcavalry/hellojib:0.0.1-SNAPSHOT
[INFO] Executing tasks:
[INFO] [==============================] 100.0% complete
[INFO] 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  10.722 s
[INFO] Finished at: 2019-09-01T08:55:09+08:00
[INFO] ------------------------------------------------------------------------
```

- 首先想到的是執行命令 **docker pull openjdk:8-jdk-stretch** 將base映象下載到本地倉庫，再嘗試構建，遺憾的是jib依舊會遠端獲取base映象的manifest，還是很慢；

- 如果能避免遠端拉取base映象的manifest，映象構建速度應該會快一些；基於此推論，最佳化構建速度的步驟如下：
1. 在本機建立registry(docker映象倉庫服務)；
2. 將base映象openjdk:8-jdk-stretch放入本機registry；
3. 修改pom.xml中base映象的配置，改為本機registry的映象；
4. 如此一來，每次都會從本機registry取得base映象的manifest，不走遠端請求響應，構建時間會有提升；

- 接下按照上述步驟進行操作：
- 確認當前電腦的IP地址，我這裡是 **192.168.121.131** ；
- 設定本地docker服務支援http：修改docker配置檔案：/etc/docker/daemon.json，在json中增加內容 **"insecure-registries": ["192.168.121.131:5000"]** 
- 重啟docker使配置生效：
```shell
systemctl restart docker
```
- 在本地建立一個映象倉庫服務：
```shell
docker run --name docker-registry -d -p 5000:5000 registry
```
- 檢視本地映象 **openjdk:8-jdk-stretch** 的ID為 **08ded5f856cc** ；
- 用tag命令將本地映象 **openjdk:8-jdk-stretch** 改名，命令如下所示，"192.168.121.131"是當前電腦的IP地址：
```shell
docker tag 08ded5f856cc 192.168.121.131:5000/openjdk:8-jdk-stretch
```
- 再次檢視映象，發現多了個 **192.168.121.131:5000/openjdk:8u212-jdk-stretch** ：
```shell
[root@maven hellojib]# docker tag 08ded5f856cc 192.168.121.131:5000/openjdk:8-jdk-stretch
[root@maven hellojib]# docker images
REPOSITORY                     TAG                 IMAGE ID            CREATED             SIZE
bolingcavalry/hellojib         0.0.1-SNAPSHOT      6601ef5a767d        3 minutes ago       505 MB
192.168.121.131:5000/openjdk   8-jdk-stretch       08ded5f856cc        2 weeks ago         488 MB
docker.io/openjdk              8-jdk-stretch       08ded5f856cc        2 weeks ago         488 MB
```
- 將 **192.168.121.131:5000/openjdk:8-jdk-stretch** 推送到遠端倉庫，命令如下所示，由於映象名字首是 **192.168.121.131:5000** ，映象會被推送到我們剛剛建立的registry：
```shell
docker push 192.168.121.131:5000/openjdk:8-jdk-stretch
```
- 修改java工程的pom.xml，將base映象由之前的 **openjdk:8-jdk-stretch** 改為 **192.168.121.131:5000/openjdk:8-jdk-stretch** 
- 修改java工程的pom.xml，增加 **allowInsecureRegistries** ，使jib外掛支援http協議連線映象倉庫(安全起見，預設是關閉的)，整個外掛的配置資訊如下：
```xml
<plugins>
            <plugin>
                <groupid>org.springframework.boot</groupid>
                <artifactid>spring-boot-maven-plugin</artifactid>
            </plugin>

<plugin>
                <groupid>com.google.cloud.tools</groupid>
                <artifactid>jib-maven-plugin</artifactid>
                <version>1.3.0</version>
                <configuration>
                    
                    <from>
                        
                        <image>192.168.121.131:5000/openjdk:8-jdk-stretch</image>
                    </from>
                    <to>
                        
                        <image>bolingcavalry/hellojib:${project.version}</image>
                    </to>
                    
                    <container>
                        
                        <jvmflags>
                            <jvmflag>-Xms4g</jvmflag>
                            <jvmflag>-Xmx4g</jvmflag>
                        </jvmflags>
                        
                        <ports>
                            <port>8080</port>
                        </ports>
                        <usecurrenttimestamp>true</usecurrenttimestamp>
                    </container>
                    <allowinsecureregistries>true</allowinsecureregistries>
                </configuration>
            </plugin>
        </plugins>

```
- 再次執行命令 **mvn compile jib:dockerBuild** ，如下所示，時間從之前的10秒縮減到3.9秒：
```shell
[INFO] Built image to Docker daemon as bolingcavalry/hellojib:0.0.1-SNAPSHOT
[INFO] Executing tasks:
[INFO] [==============================] 100.0% complete
[INFO] 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  3.949 s
[INFO] Finished at: 2019-09-01T10:51:50+08:00
[INFO] ------------------------------------------------------------------------
```
- 以上就是透過registry服務提升jib構建速度的方法，在多人開發的時候，registry可以配置為一個公共的，多人都可使用，畢竟pom.xml程式碼存在公共程式碼倉庫，每個人都去修改成自己的registry的地址是不合適的，一旦提交上去會影響其他人的使用，我們這裡的做法是將registry的地址寫成host，本地維護好host和IP的對映就可以了。
使用本地registry服務，除了提速，在伺服器無法連線中央倉庫取得openjdk:8-jdk-stretch的manifest時，這種方式能保證構建依舊能夠成功；

### 小結五：將jib與mvn構建的生命週期繫結
- 前面的實戰中構建命令是 **mvn compile jib:dockerBuild** ，實際上可以做到僅用 **mvn compile** 就完成映象構建，這是maven外掛的通用特性；
- 修改pom.xml增加 **executions** 節點，裡面設定compile觸發jib:dockerBuild，整個外掛的內容如下所示：
```xml
<plugin>
                <groupid>com.google.cloud.tools</groupid>
                <artifactid>jib-maven-plugin</artifactid>
                <version>1.3.0</version>
                <configuration>
                    
                    <from>
                        
                        <image>192.168.121.131:5000/openjdk:8-jdk-stretch</image>
                    </from>
                    <to>
                        
                        <image>bolingcavalry/hellojib:${project.version}</image>
                    </to>
                    
                    <container>
                        
                        <jvmflags>
                            <jvmflag>-Xms4g</jvmflag>
                            <jvmflag>-Xmx4g</jvmflag>
                        </jvmflags>
                        
                        <ports>
                            <port>8080</port>
                        </ports>
                        <usecurrenttimestamp>true</usecurrenttimestamp>
                    </container>
                    <allowinsecureregistries>true</allowinsecureregistries>
                </configuration>
                <executions>
                  <execution>
                    <phase>compile</phase>
                    <goals>
                      <goal>dockerBuild</goal>
                    </goals>
                  </execution>
                </executions>
            </plugin>
```
- 執行命令 **mvn compile -DskipTests** ，如下所示，可以成功構建映象，與前面的命令結果一致：
```shell
[root@maven hellojib]# mvn compile -DskipTests
[INFO] Scanning for projects...
[INFO] 
[INFO] ---------------------< com.bolingcavalry:hellojib >---------------------
[INFO] Building hellojib 0.0.1-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 
[INFO] --- maven-resources-plugin:3.1.0:resources (default-resources) @ hellojib ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Copying 1 resource
[INFO] Copying 0 resource
[INFO] 
[INFO] --- maven-compiler-plugin:3.8.1:compile (default-compile) @ hellojib ---
[INFO] Nothing to compile - all classes are up to date
[INFO] 
[INFO] --- jib-maven-plugin:1.3.0:dockerBuild (default) @ hellojib ---
[WARNING] Setting image creation time to current time; your image may not be reproducible.
[INFO] 
[INFO] Containerizing application to Docker daemon as bolingcavalry/hellojib:0.0.1-SNAPSHOT...
[INFO] 
[INFO] Container entrypoint set to [java, -Xms4g, -Xmx4g, -cp, /app/resources:/app/classes:/app/libs/*, com.bolingcavalry.hellojib.HellojibApplication]
[INFO] 
[INFO] Built image to Docker daemon as bolingcavalry/hellojib:0.0.1-SNAPSHOT
[INFO] Executing tasks:
[INFO] [==============================] 100.0% complete
[INFO] 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  3.721 s
[INFO] Finished at: 2019-09-01T11:43:23+08:00
[INFO] ------------------------------------------------------------------------
[root@maven hellojib]# docker images
REPOSITORY                     TAG                 IMAGE ID            CREATED             SIZE
bolingcavalry/hellojib         0.0.1-SNAPSHOT      5e3f62d13a73        35 seconds ago      505 MB
192.168.121.131:5000/openjdk   8-jdk-stretch       08ded5f856cc        2 weeks ago         488 MB
docker.io/openjdk              8-jdk-stretch       08ded5f856cc        2 weeks ago         488 MB
docker.io/registry             latest              f32a97de94e1        5 months ago        25.8 MB
```
### 小結六：父子結構的maven工程如何構建
- 假設當前maven工程是父子結構的，有兩個子工程A和B，其中A是二方庫，提供一個jar包，裡面是介面類和Bean類，B是springboot應用，並且B的原始碼中用到了A提供的介面和Bean；
- 上述父子結構的maven工程是常見的工程結構，此時如果要將B構建成Docker映象，在B的目錄下執行 **mvn compile jib:dockerBuild** 顯然是不行的，因為沒有編譯構建A，會導致B的編譯失敗；
- 此時最好的做法就是將jib與mvn構建的生命週期繫結，修改B的pom.xml檔案，加入executions節點；
- 在父工程目錄下執行 **mvn compile** ，此時maven會先編譯構建整個工程，然後再將B工程的構建結果製作成映象；

- 以上就是我在近期使用Jib外掛時遇到的問題小結，希望這些小技巧可以給您提供一些參考，助您解決問題；- 近期在用Jib外掛將Java工程構建成Docker映象，使用時遇到過一些小問題，今天對這些問題做個小結；
### 關於Jib外掛
- Jib是用於構建Docker映象的Maven外掛，其基本用法請參考[《Docker與Jib(maven外掛版)實戰》](https://blog.csdn.net/boling_cavalry/article/details/94355659)一文；
### 全文概覽
- 本文由以下幾部分組成：
1. 環境資訊
2. 原始碼下載
3. 小結一：三種構建引數
4. 小結二：映象的時間問題
5. 小結三：多次構建後，積累的無用映象問題
6. 小結四：提升構建速度
7. 小結五：將jib與mvn構建的生命週期繫結
8. 小結六：父子結構的maven工程如何構建
### 環境資訊
1. 作業系統：CentOS Linux release 7.6.1810
2. docker：1.13.1
3. jdk：1.8.0_191
4. maven：3.6.0
5. jib外掛：1.3.0
### 原始碼下載
- 本次實戰用到的原始碼是個簡單的maven工程，可以從GitHub上下載本次實戰的原始碼，地址和連結資訊如下表所示：