⛵️ Build container images for your Java applications.
Clone or download

README.md

beta Maven Central Gradle Plugin Portal Build Status Build Status Build Status Gitter version

Jib

Jib - Containerize your Java applications.

What is Jib?

Jib builds Docker and OCI images for your Java applications and is available as plugins for Maven and Gradle.

Maven: See documentation for jib-maven-plugin.
Gradle: See documentation for jib-gradle-plugin.

Jib as a container-building library for Java is work-in-progress. Watch for updates.

For more information, check out the official blog post or watch this talk (slides).

Goals

  • Fast - Deploy your changes fast. Jib separates your application into multiple layers, splitting dependencies from classes. Now you don’t have to wait for Docker to rebuild your entire Java application - just deploy the layers that changed.

  • Reproducible - Rebuilding your container image with the same contents always generates the same image. Never trigger an unnecessary update again.

  • Daemonless - Reduce your CLI dependencies. Build your Docker image from within Maven or Gradle and push to any registry of your choice. No more writing Dockerfiles and calling docker build/push.

Quickstart

Maven

See documentation for using jib-maven-plugin.

Gradle

See documentation for using jib-gradle-plugin.

How Jib Works

Whereas traditionally a Java application is built as a single image layer with the application JAR, Jib's build strategy separates the Java application into multiple layers for more granular incremental builds. When you change your code, only your changes are rebuilt, not your entire application. These layers, by default, are layered on top of a distroless base image. For more information, check out the official blog post or watch this talk (slides).

See also rules_docker for a similar existing container image build tool for the Bazel build system.

Frequently Asked Questions (FAQ)

See the Frequently Asked Questions (FAQ) page.

Get involved with the community

We welcome contributions! Here's how you can contribute:

Make sure to follow the Code of Conduct when contributing so we can foster an open and welcoming community.

Analytics