README.md

Jib

☑️ Jib User Survey
What do you like best about Jib? What needs to be improved? Please tell us by taking a one-minute survey. Your responses will help us understand Jib usage and allow us to serve our customers (you!) better.

What is Jib?

Jib builds optimized Docker and OCI images for your Java applications without a Docker daemon - and without deep mastery of Docker best-practices. It is available as plugins for Maven and Gradle and as a Java library.

• Maven: See documentation for jib-maven-plugin.
• Gradle: See documentation for jib-gradle-plugin.
• Jib Core: A general-purpose container-building library for Java.
• Jib CLI: A command-line interface for building images that uses Jib Core.

Jib works well with Google Cloud Build. For details, see how to use Jib on Google Cloud Build.

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 the jib-maven-plugin Quickstart.

• Gradle - See the jib-gradle-plugin Quickstart.

• Jib Core - See the Jib Core Quickstart.

• Jib CLI - See the Jib CLI doc.

Examples

The examples directory includes the following examples (and more).

• helloworld
• Spring Boot
• Micronaut
• Multi-module project
• Spark Java using Java Agent

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 an OpenJDK base image, but you can also configure a custom 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.

Need Help?

A lot of questions are already answered!

• Frequently Asked Questions (FAQ)
• Stack Overflow
• GitHub issues

For usage questions, please ask them on Stack Overflow.

Privacy

See the Privacy page.

Get involved with the community

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

• Browse issues or file an issue
• Chat with us on gitter
• Join the jib-users mailing list
• Contribute:
  • Read the contributing guide before starting work on an issue
  • Try to fix good first issues
  • Help out on issues that need help
  • Join in on discussion issues

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

Disclaimer

This is not an officially supported Google product.