jib

Major Changes

• JavaContainerBuilder#fromDistroless() and JavaContainerBuilder#fromDistrolessJetty() are deprecated. To migrate, check the Javadoc. (#3123)
• For Google Artifact Registry (*-docker.pkg.dev), Jib now tries Google Application Default Credentials last like it has been doing for gcr.io. (#3241)
• Timestamps of file entries in a built TarImage are set to the epoch, making the tarball reproducible. (#3158)

See CHANGELOG.md for more details.

Major Changes

• Fixed the regression introduced in 3.1.0 where a build may fail due to an error from main class inference even if jib.container.entrypoint is configured. (#3295)

See CHANGELOG.md for more details.

Major Changes

• Fixed the regression introduced in 3.1.0 where a build may fail due to an error from main class inference even if <container><entrypoint> is configured. (#3295)

See CHANGELOG.md for more details.

Major Changes

• For Google Artifact Registry (*-docker.pkg.dev), Jib now tries Google Application Default Credentials last like it has been doing for gcr.io. (#3241)
• Jib now creates an additional layer that contains two small text files: /app/jib-classpath-file and /app/jib-main-class-file. They hold, respectively, the final Java runtime classpath and the main class computed by Jib that are suitable for app execution on JVM. For example, with Java 9+, setting the container entrypoint to java --class-path @/app/jib-classpath-file @/app/jib-main-class-file will work to start the app. (This is basically the default entrypoint set by Jib when the entrypoint is not explicitly configured by the user.) The files are always generated whether Java 8 or 9+, or whether jib.container.entrypoint is explicitly configured. The files can be helpful especially when setting a custom entrypoint for a shell script that needs to get the classpath and the main class computed by Jib, or for AppCDS. (#3280)
• For Java 9+ apps, the default Java runtime classpath explicitly lists all the app dependencies, preserving the dependency loading order declared by Maven. This is done by changing the default entrypoint to use the new classpath JVM argument file (basically java -cp @/app/jib-classpath-file). As such, <container><expandClasspathDependencies> takes no effect for Java 9+. (#3280)
• Timestamps of file entries in a tarball built with jib:buildTar are set to the epoch, making the tarball reproducible. (#3158)

See CHANGELOG.md for more details.

Major Changes

• For Google Artifact Registry (*-docker.pkg.dev), Jib now tries Google Application Default Credentials last like it has been doing for gcr.io. (#3241)
• Jib now creates an additional layer that contains two small text files: /app/jib-classpath-file and /app/jib-main-class-file. They hold, respectively, the final Java runtime classpath and the main class computed by Jib that are suitable for app execution on JVM. For example, with Java 9+, setting the container entrypoint to java --class-path @/app/jib-classpath-file @/app/jib-main-class-file will work to start the app. (This is basically the default entrypoint set by Jib when the entrypoint is not explicitly configured by the user.) The files are always generated whether Java 8 or 9+, or whether jib.container.entrypoint is explicitly configured. The files can be helpful especially when setting a custom entrypoint for a shell script that needs to get the classpath and the main class computed by Jib, or for AppCDS. (#3280)
• For Java 9+ apps, the default Java runtime classpath explicitly lists all the app dependencies, preserving the dependency loading order declared by Gradle. This is done by changing the default entrypoint to use the new classpath JVM argument file (basically java -cp @/app/jib-classpath-file). As such, jib.container.expandClasspathDependencies takes no effect for Java 9+. (#3280)
• Timestamps of file entries in a tarball built with jibBuildTar are set to the epoch, making the tarball reproducible. (#3158)
• Added lazy evaluation for jib.container.labels using Gradle Property and Provider. (#3242)

See CHANGELOG.md for more details.

Major Changes

• Added automatic update check. Jib CLI will now display a message if a new version is available. See the privacy page for more details. (#3165)
• Added --image-metadata-out option to specify the JSON output file that should contain image metadata (image ID, digest, and tags) after build is complete. (#3187)

See CHANGELOG.md for more details.

Major Changes

• Switched the default base images from Distroless to adoptopenjdk:{8,11}-jre and jetty (for WAR). (#3124)
• New <includes> and <excludes> options for <extraDirectories>. This enables copying a subset of files from the source directory using glob patterns. (#2564)
• Jib extensions can be loaded via the Maven dependency injection mechanism. This also enables injecting arbitrary dependencies (for example, Maven components) into an extension. (#3036)
• Fixed an issue where some log messages used color in the "plain" console output. (#2764)

See CHANGELOG.md for more details.

Major Changes

• Switched the default base images from Distroless to adoptopenjdk:{8,11}-jre and jetty (for WAR). (#3124)
• New includes and excludes options for jib.extraDirectories. This enables copying a subset of files from the source directory using glob patterns. (#2564)
• Added an option configurationName to specify the name of the Gradle Configuration to use. The option can be lazily configured, for example, using Gradle Provider or Property. (#3034)

    jib {
      configurationName = 'myconfig'
    }

• Fixed an issue where some log messages used color in the "plain" console output. (#2764)

See CHANGELOG.md for more details.

Major Changes

• Fixed an issue where critical error messages (for example, unauthorized access from a registry) were erased by progress reporting and not shown. (#3148)

See CHANGELOG.md for more details.

Major Changes

• Added support for configuring registry mirrors for base images. This is useful when hitting Docker Hub rate limits. Only public mirrors (such as mirror.gcr.io) are supported. (#3134)

See CHANGELOG.md for more details.

Major Changes

• Changed the default base image of the Jib CLI jar command from the openjdk images to the adoptopenjdk images on Docker Hub. (#3108)

See CHANGELOG.md for more details.

Major Changes

• Added the jar command which can be used to containerize a JAR with $ jib jar --target ... my-app.jar. By default, the command will add the contents of the JAR into optimized layers on the container. (#11)

See CHANGELOG.md for more details

Major Changes

• New method: Containerizer#addRegistryMirrors for configuring registry mirrors for base images. This is useful when hitting Docker Hub rate limits. Only public mirrors (such as mirror.gcr.io) are supported. (#2999)

See CHANGELOG.md for more details.

Major Changes

• Added support for configuring registry mirrors for base images. This is useful when hitting Docker Hub rate limits. Only public mirrors (such as mirror.gcr.io) are supported. (#3011)

See CHANGELOG.md for more details.

Major Changes

• Added support for configuring registry mirrors for base images. This is useful when hitting Docker Hub rate limits. Only public mirrors (such as mirror.gcr.io) are supported. (#3011)

See CHANGELOG.md for more details.

Major Changes

• Updated jackson dependency version causing compatibility issues. (#2931)
• Fixed NullPointerException when pulling an OCI base image whose manifest does not have mediaType information. (#2819)
• Fixed build failure when using a Docker daemon base image (docker://...) that has duplicate layers. (#2829)

See CHANGELOG.md for more details.

Preview release

Major Changes

• Updated jackson dependency version causing compatibility issues. (#2931)
• Fixed deprecated use of @Optional on boolean attribute (#2930)

See CHANGELOG.md for more details.

Major Changes

• Updated jackson dependency version causing compatibility issues. (#2931)

See CHANGELOG.md for more details.

Major Changes

• Added an option jib.container.expandClasspathDependencies to preserve the order of loading dependencies as configured in a project. The option enumerates dependency JARs instead of using a wildcard (/app/libs/*) in the Java runtime classpath for an image entrypoint. (#1871, #1907, #2228, #2733)
  • The option is also useful for AppCDS. (#2471)
  • Turning on the option may result in a very long classpath string, and the OS may not support passing such a long string to JVM.
• Added lazy evaluation for jib.(to|from).auth.(username|password) and jib.from.image using Gradle Property and Provider. (#2905)
• Fixed NullPointerException when pulling an OCI base image whose manifest does not have mediaType information. (#2819)
• Fixed build failure when using a Docker daemon base image (docker://...) that has duplicate layers. (#2829)

See CHANGELOG.md for more details.