Images

Docker container to manipulate images (imagemagick, exiftool...).

Example without using the filesystem

Let's say that you have an image foo.jpg in your current working directory that you want to extract its metadata:

Mac/Linux

cat foo.jpg | docker run --rm -i --net=none leplusorg/img identify -

Windows

type foo.jpg | docker run --rm -i --net=none leplusorg/img identify -

Example using the filesystem

Same thing, assuming that you have an image foo.jpg in your current working directory that you want to extract its metadata:

Mac/Linux

docker run --rm -t --user="$(id -u):$(id -g)" --net=none -v "$(pwd):/tmp" leplusorg/img identify /tmp/foo.jpg

Windows

In cmd:

docker run --rm -t --net=none -v "%cd%:/tmp" leplusorg/img identify /tmp/foo.jpg

In PowerShell:

docker run --rm -t --net=none -v "${PWD}:/tmp" leplusorg/img identify /tmp/foo.jpg

Help

To know more command-line options of one of the imagemagick command:

docker run --rm --net=none leplusorg/img identify -help

Software Bill of Materials (SBOM)

To get the SBOM for the latest image (in SPDX JSON format), use the following command:

docker buildx imagetools inspect leplusorg/img --format '{{ json (index .SBOM "linux/amd64").SPDX }}'

Replace linux/amd64 by the desired platform (linux/amd64, linux/arm64 etc.).

Sigstore

Sigstore⁠ is trying to improve supply chain security by allowing you to verify the origin of an artifcat. You can verify that the jar that you use was actually produced by this repository. This means that if you verify the signature of the ristretto jar, you can trust the integrity of the whole supply chain from code source, to CI/CD build, to distribution on Maven Central or whever you got the jar from.

You can use the following command to verify the latest image using its sigstore signature attestation:

cosign verify leplusorg/img --certificate-identity-regexp 'https://github\.com/leplusorg/docker-img/\.github/workflows/.+' --certificate-oidc-issuer 'https://token.actions.githubusercontent.com'

The output should look something like this:

Verification for index.docker.io/leplusorg/xml:main --
The following checks were performed on each of these signatures:
  - The cosign claims were validated
  - Existence of the claims in the transparency log was verified offline
  - The code-signing certificate was verified using trusted certificate authority certificates

[{"critical":...

For instructions on how to install cosign, please read this documentation⁠.

Request new tool

Please use this link⁠ (GitHub account required) to request that a new tool be added to the image. I am always interested in adding new capabilities to these images.