docker-image-size-limit 0.2.0

No project description provided

docker-image-size-limit

Limit your docker image size with a simple CLI command. Perfect to be used inside your CI process.

Read the announcing post.

Installation

pip install docker-image-size-limit

Usage

We support just a single command:

$ disl your-image-name:label 300MiB
your-image-name:label exceeds 300MiB limit by 114.4 MiB

Options

You can specify your image as:

• Image name: python
• Image name with tag: python:3.6.6-alpine

You can specify your size as:

• Raw number of bytes: 1024
• Human-readable megabytes: 30 MB or 30 MiB
• Human-readable gigabytes: 1 GB or 1 GiB
• Any other size supported by humanfriendly

Programmatic usage

You can also import and use this library as python code:

from docker import from_env
from docker_image_size_limit import check_image_size

oversize = check_image_size(client, 'image-name:latest', '1 GiB')
assert oversize < 0, 'Too big image!'  # negative oversize - is a good thing!

We also ship PEP-561 compatible type annotations with this library.

Should I use it?

You can use this script instead:

LIMIT=1024
IMAGE='your-image-name:latest'

SIZE="$(docker image inspect "$IMAGE" --format='{{.Size}}')"
test "$SIZE" -gt "$LIMIT" && echo 'Limit exceeded'; false

But I prefer to reuse tools over custom bash scripts here and there.

License

MIT.