Jib構建你的第一個java映象

M莫發表於2018-07-18

jib Official:GoogleContainerTools/jib

本文示例完整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已經構建成功。

Jib構建你的第一個java映象

  • docker使用映象
docker run -it --rm -p8080:8080 registry.hub.docker.com/moxingwang/jibtest
複製程式碼

Jib構建你的第一個java映象

一個spring-boot的image這樣就被啟動成功了。本文示例demo中整合了swagger-iu, 專案啟動成功後我們可以通過http://localhost:8080/sw/swagger-ui.html訪問,可以成功在瀏覽器開啟swagger。

Jib構建你的第一個java映象

把映象直接構建到本地docker中

使用這種構建方式,首先你要確保本已經安裝docker並且環境變數都配置正確,因為這種方式jib依賴docker 命令執行,你還需要保證已經啟動服務(在terminal中執行 docker --version 能夠正確返回)。

mvn compile jib:dockerBuild
複製程式碼

接下來直接操作,首先檢視本地已有images

docker iamges
複製程式碼

Jib構建你的第一個java映象

執行mvn compile jib:dockerBuild

Jib構建你的第一個java映象

可以看到本地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
複製程式碼

推薦閱讀

相關文章