本文示例完整demo github地址 github.com/moxingwang/…
想要了解並且使用jib,首先你得知道或者使用過docker,在這個基礎上才能夠明白jib是幹什麼得,解決了什麼問題。
首先我們先看一個例子,如何將一個spring-boot專案簡單容器化,如果你從未操作過,可以動手自己實現,或者仔細閱讀這篇文章第一個 spring Boot 應用通過Docker 來實現構建、執行、釋出。你可能發現如果需要把一個java專案容器化這是一個麻煩和相對複雜的過程,首先你需要編寫dockerfile,然後在build dockefile,如過需要push到registries,還需要經過push操作。雖然build和push還是非常簡單得。但是寫一個dockerfile真的比較麻煩,學習成本也高,看看官網Dockerfile reference就不想學了。那麼有沒有簡單得辦法呢,記住幾個簡單得命令就可以執行了,如同‘mvn spring-boot:run’這麼簡單得命令,這個時候jib出場了,他就是來完成這個偉大得使命。
如果你還沒明白jib是用來做什麼事情得,推薦你閱讀谷歌開源Java映象構建工具Jib的前半部分,或者閱讀jib Official:GoogleContainerTools/jib。
接下來主要介紹具體如何使用(maven的方式)。
將java專案容器化push到registries
jib的引入非常簡單,已maven plugin的方式整合到專案中,只需要在你的專案中引入下面程式碼即可
<plugin>
<groupId>com.google.cloud.tools</groupId>
<artifactId>jib-maven-plugin</artifactId>
<version>0.9.6</version>
<configuration>
<from>
<!--base image-->
<image>openjdk:alpine</image>
</from>
<to>
<!--<image>registry.cn-hangzhou.aliyuncs.com/m65536/jibtest</image>-->
<!--目標映象registry地址,為了方便測試,你需要換成自己的地址,如果你的網路不好,可以選用國內加速器,比如阿里雲的-->
<image>registry.hub.docker.com/moxingwang/jibtest</image>
</to>
</configuration>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>build</goal>
</goals>
</execution>
</executions>
</plugin>
複製程式碼
這只是一個最簡單的配置,比如registry認證配置,jvm配置等等,可以參考github jib詳細說明jib/jib-maven-plugin/。
構建你的映象
mvn compile jib:build
複製程式碼
可能你剛剛執行玩這一步就出現錯誤,提示Unauthorized,不用擔心,這個命令需要把構建出來的image commit並且push到你遠端的registry(我這裡是registry.hub.docker.com),你可以按照【常見錯誤1】的方法解決問題。
如果你的網速慢一點可能會在最後步驟'Finalizing...',不過沒有關係,稍微多等一會就ok,直到'BUILD SUCCESS'出現。最終一個完整的java project被例項化成映象並且push到了registry裡。接下來你可以測試剛剛完成push的映象。
開啟hub.docker.com/,你會發現你的image已經構建成功。
- docker使用映象
docker run -it --rm -p8080:8080 registry.hub.docker.com/moxingwang/jibtest
複製程式碼
一個spring-boot的image這樣就被啟動成功了。本文示例demo中整合了swagger-iu, 專案啟動成功後我們可以通過http://localhost:8080/sw/swagger-ui.html訪問,可以成功在瀏覽器開啟swagger。
把映象直接構建到本地docker中
使用這種構建方式,首先你要確保本已經安裝docker並且環境變數都配置正確,因為這種方式jib依賴docker 命令執行,你還需要保證已經啟動服務(在terminal中執行 docker --version 能夠正確返回)。
mvn compile jib:dockerBuild
複製程式碼
接下來直接操作,首先檢視本地已有images
docker iamges
複製程式碼
執行mvn compile jib:dockerBuild
可以看到本地image已經build成功。可以直接啟動使用
docker run -it --rm -p8080:8080 moxingwang/jibtest
複製程式碼
啟動成功後同樣可以直接訪問http://localhost:8080/sw/swagger-ui.htmlswagger頁面。
常見錯誤
常見錯誤1 Failed to execute goal com.google.cloud.tools:jib-maven-plugin:0.9.6:build (default-cli) on project jib: Build image failed, perhaps you should set a credential helper name with the configuration '' or set credentials for 'registry.hub.docker.com' in your Maven settings: Unauthorized for registry.hub.docker.com/moxingwang/jibtest: 401 Unauthorized
當你從私有的registries pull或者push的時候需要認證機制。閱讀官方說明按照步驟操作即可。Authentication Methods。 如果幫你本機已經按照docker,那麼操作更簡單,可以通過docker命令直接登陸registries,然後繼續其他jib的操作。
- registry.hub.docker.com
docker login --username=你的hub.docker的使用者名稱 registry.hub.docker.com
複製程式碼
- registry.cn-hangzhou.aliyuncs.com
docker login --username=阿里雲docker使用者名稱 registry.cn-hangzhou.aliyuncs.com
複製程式碼