Band Service

Container images with Cloud Native Buildpacks

"Cloud Native Buildpacks transform your application source code into images that can run on any cloud." (buildpacks.io)

Buildpacks with pack

The pack CLI is "a tool maintained by the Cloud Native Buildpacks project to support the use of buildpacks".

For AMD64 architectures:

pack build band-service \
    --builder paketobuildpacks/builder-jammy-tiny \
    --env BP_JVM_VERSION=17

For ARM64 architectures:

pack build band-service \
    --builder docker.io/dashaun/builder-arm:tiny \
    --env BP_JVM_VERSION=17 \
    --trust-builder

Buildpacks with Spring Boot

Spring Boot includes support for Cloud Native Buildpacks directly for both Maven and Gradle.

./gradlew bootBuildImage

Signing commits with Sigstore gitsign

Install gitsgin:

brew install sigstore/tap/gitsign

Configure your application repository to enforce commit signing with gitsign:

cd <your_repository_path>
# Sign all commits
git config --local commit.gpgsign true
# Sign all tags
git config --local tag.gpgsign true
# Use gitsign for signing
git config --local gpg.x509.program gitsign
# gitsign expects x509 args
git config --local gpg.format x509

The first time you commit code, a browser window will open and ask you to authenticate with Sigstore following the OIDC protocol. For example, you can authenticate via your GitHub account.

You can verify a commit as follows:

git verify-commit HEAD

Verifying signatures and SLSA attestations

After packaging the currente application as an OCI image, cosign is used to sign the artifact and the SLSA attestation.

Using cosign, you can display the supply chain security related artifacts for the ghcr.io/thomasvitale/band-service images. Use the specific digest you'd like to verify.

cosign tree ghcr.io/thomasvitale/band-service

The result:

📦 Supply Chain Security Related artifacts for an image: ghcr.io/thomasvitale/band-service
└── 💾 Attestations for an image tag: ghcr.io/thomasvitale/band-service:sha256-53b8f5bcec33facefcdaa676edeb6c2cdf88b9c1a1bc0f4d0cd23720b4511e1c.att
   └── 🍒 sha256:0b608efeb00a3bfff29e34535779c84d506d4b64b1c39084ed61ace01473b5cd
└── 🔐 Signatures for an image tag: ghcr.io/thomasvitale/band-service:sha256-53b8f5bcec33facefcdaa676edeb6c2cdf88b9c1a1bc0f4d0cd23720b4511e1c.sig
   └── 🍒 sha256:3714100d8c0ae7a088de5f6a548fa5a28969594fce1b958c4168876741cc750b

You can verify the signature and its claims:

cosign verify \
   --certificate-identity-regexp https://github.com/ThomasVitale \
   --certificate-oidc-issuer https://token.actions.githubusercontent.com \
   ghcr.io/thomasvitale/band-service | jq

You can also verify the SLSA Provenance attestation associated with the image.

cosign verify-attestation --type slsaprovenance \
   --certificate-identity-regexp https://github.com/slsa-framework \
   --certificate-oidc-issuer https://token.actions.githubusercontent.com \
   ghcr.io/thomasvitale/band-service | jq .payload -r | base64 --decode | jq

Software Bill of Materials (SBOMs) with Syft

You can generate a SBOM with Syft as follows:

syft band-service

To include also the materials excluded from the final container representation, use this command:

syft band-service --scope all-layers

You can export SBOM in Syft, SPDX, and CycloneDX formats.

syft band-service -o cyclonedx-json

When using Paketo Buildpacks, Syft is already used as part of the build process and SBOMs are generated for each layer. You can access the SBOMs per layer with the following command.

pack sbom download band-service --output-dir sboms

To learn more about Cloud Native Buildpacks and SBOMs:

• Software Bill of Materials (SBOM)
• How to Access the Software Bill of Materials

Vulnerability Scanning with Trivy

You can scan source code with Trivy as follows:

trivy fs .

You can also scan a container image:

trivy image <image>

Lock dependencies with Gradle

Gradle lets you lock all the dependencies in your project and fail a build is any of them is changed outside the standard lifecycle.

You can generate/update the list of locked dependencies as follows:

./gradlew dependencies --write-locks

Verify third-party artefacts with Gradle

You can use Gradle to verify checksums and signatures of all the dependencies used in your project.

First, run this command for Gradle to download checksums and signatures:

./gradlew --write-verification-metadata pgp,sha256

When building the project, Gradle will ensure the dependencies have not been tampered with:

./gradlew build