PiGallery2 Docker Contribution guide (draft)

Remember to update all the Dockerfiles.

Linting

To quality check your dockerfile changes you can use hadolint:

Start the docker daemon if it's not already started: sudo dockerd
Change dir to the docker folder.
Run hadolint on the alpine dockerfile: docker run --rm -i -v ./.config/hadolint.yml:/.config/hadolint.yaml hadolint/hadolint < ./alpine/Dockerfile.build
Run hadolint on the debian-bookworm dockerfile: docker run --rm -i -v ./.config/hadolint.yml:/.config/hadolint.yaml hadolint/hadolint < ./debian-bookworm/Dockerfile.build
Run hadolint on the debian-bullseye dockerfile: docker run --rm -i -v ./.config/hadolint.yml:/.config/hadolint.yaml hadolint/hadolint < ./debian-bullseye/Dockerfile.build
Run hadolint on the debian-buster dockerfile: docker run --rm -i -v ./.config/hadolint.yml:/.config/hadolint.yaml hadolint/hadolint < ./debian-buster/Dockerfile.build
Run hadolint on the debian-buster selfcontained dockerfile: docker run --rm -i -v ./.config/hadolint.yml:/.config/hadolint.yaml hadolint/hadolint < ./debian-buster/selfcontained/Dockerfile
Fix errors and warnings or add them to ignore list of the hadolint configuration file if there is a good reason for that. Read more here.

TBD