jfxs/hello-world repository overview

⁠jfxs / hello world

A Nginx⁠ (unprivileged) Docker image:

• lightweight image based on Alpine Linux, less than 10 MB,
• follows the Nginx mainline branch (odd minor versions),
• multiarch with support of amd64 and arm64,
• non-root container user,
• automatically updated by Renovate⁠,
• image signed with Cosign⁠,
• an SBOM attestation added using Syft⁠,
• available on Docker Hub and Quay.io.

The main repository.

The Docker Hub registry.

The Quay.io registry.

⁠Running Nginx Hello World

docker run -d --rm -p 8080:8080 jfxs/hello-world

or

docker run -d --rm -p 8080:8080 quay.io/ifxs/hello-world

The server listens on the port 8080 (IPv4 and IPv6) as the user 101. The root filesystem can be read-only if /tmp is writable:

docker run -d --rm -p 8080:8080 --read-only --tmpfs /tmp jfxs/hello-world

⁠Built with

Docker latest tag is 1.31.7-001, 1.31, 1⁠.

The complete software bill of materials (SBOM) of each published image, with its known vulnerabilities, is collected in the sbom-docker⁠ repository, under the component hello-world.

Dockerhub Overview page⁠ has the details of the last published image.

⁠Versioning

Docker tag definition:

• the nginx version used,
• a dash
• an increment to differentiate build with the same version starting at 001

<nginx_version>-<increment>

Example: 1.31.6-001

Floating tags are also published: latest, <major>.<minor> (example: 1.31) and <major> (example: 1).

⁠Signature and attestation

Cosign⁠ public key:

-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEa3yV6+yd/l4zh/tfT6Tx+zn0dhy3
BhFqSad1norLeKSCN2MILv4fZ9GA6ODOlJOw+7vzUvzZVr9IXnxEdjoWJw==
-----END PUBLIC KEY-----

The public key is also available online: https://gitlab.com/op_so/docker/cosign-public-key/-/raw/main/cosign.pub⁠.

To verify an image:

cosign verify --key cosign.pub $IMAGE_URI

To verify and get the SBOM attestation:

cosign verify-attestation --key cosign.pub --type spdxjson $IMAGE_URI | jq '.payload | @base64d | fromjson | .predicate'

⁠Authors

• FX Soubirou - Initial work - GitLab repositories⁠

⁠License

This program is free software: you can redistribute it and/or modify it under the terms of the MIT License (MIT). See the LICENSE⁠ for details.