Jib構建你的第一個java鏡像

jib Official:GoogleContainerTools/jib

本文示例完整demo github地址 https://github.com/moxingwang/jib

想要了解並且使用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的鏡像。

打開https://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.hub.docker.com
docker login --username=阿里雲docker用戶名 registry.cn-hangzhou.aliyuncs.com

推薦閱讀

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章