arconia image build buildpacks

The arconia image build buildpacks command builds a container image for your Spring Boot application using Cloud Native Buildpacks. It delegates to your build tool’s (Maven/Gradle) image build tasks to package your application as a container image, relying on the Spring Boot integration with Paketo Buildpacks.

This approach does not require a Dockerfile: the buildpack automatically detects the application type, installs the appropriate runtime, and assembles the image following best practices for security and size.

Prerequisites

  • An OCI container runtime (Docker, Podman, or compatible) must be running on your machine.

Usage

Basic usage:

arconia image build buildpacks

With a custom image name:

arconia image build buildpacks --image-name ghcr.io/my-org/my-app:1.0.0

Publish the image to a registry after building:

arconia image build buildpacks --image-name ghcr.io/my-org/my-app:1.0.0 --publish-image

Build without running tests and clean cache:

arconia image build buildpacks --skip-tests --clean-cache

Pass extra parameters to the underlying build tool using --:

arconia image build buildpacks -- --stacktrace
arconia image build buildpacks -- -DmyProperty=value

Options

The following options are available:

Option Default Description

--image-name

Name (and optionally tag) for the image to build. For example: ghcr.io/my-org/my-app:1.0.0.

--builder-image

Name of the Paketo builder image to use. Defaults to the builder configured in your Spring Boot build plugin. Override this to use a different builder, for example a custom corporate builder.

--run-image

Name of the Paketo run image to use. Override this to change the base image of the produced container, for example to use a distroless or hardened run image.

--clean-cache

false

Whether to clean the local buildpack cache before building. Useful when troubleshooting caching issues.

--publish-image

false

Whether to publish the generated image to an OCI registry after building. Make sure you are authenticated with the target registry (e.g., podman login ghcr.io) before using this option.

--clean

false

Perform a clean build of the application before building the image.

--skip-tests

false

Skip tests during the application build.

--verbose or -v

false

Include verbose output.

--help or -h

Display help information for the command.
To push the image to a registry using --publish-image, authenticate first (e.g., podman login ghcr.io). Registry credentials can also be configured in your Spring Boot build plugin for CI/CD environments.

Build Tool Integration

The command automatically detects whether your project uses Maven or Gradle and runs the appropriate image build task:

Build Tool Command

Gradle

  • ./gradlew bootBuildImage (Linux/macOS with wrapper)

  • gradle bootBuildImage (Linux/macOS without wrapper)

  • gradlew.bat bootBuildImage (Windows with wrapper)

  • gradle bootBuildImage (Windows without wrapper)

Maven

  • ./mvnw spring-boot:build-image (Linux/macOS with wrapper)

  • mvn spring-boot:build-image (Linux/macOS without wrapper)

  • mvnw.cmd spring-boot:build-image (Windows with wrapper)

  • mvn spring-boot:build-image (Windows without wrapper)

  • mvnd spring-boot:build-image (Using Maven Daemon)

Use -- to pass parameters directly to the underlying build tool. The -- separator is required to distinguish Arconia CLI options from build tool parameters.

See Also