This repository contains public container image sources, release automation, and operating notes used by pNet projects.

The repository is intentionally small and practical: each image family keeps its detailed build and usage documentation next to its source, while this root README stays as a map of what is available.

Pull the current PostgreSQL 18 image line:

docker pull ghcr.io/pnetcloud/cloudnative-pg-timescaledb:18

For production rollouts, prefer immutable tags or digest-pinned references. Tag rules and CloudNativePG examples are in docs/image-tags.md.

• Documentation index - start here when looking for usage, maintenance, release, and verification docs.
• CloudNativePG TimescaleDB image docs - image contents, supported PostgreSQL/Debian lines, catalog usage, CloudNativePG Barman Cloud Plugin backup boundary, and command surface.
• Image tags - immutable tags, rolling tags, and CloudNativePG imageName examples.
• ClusterImageCatalog usage - generated CloudNativePG catalog manifests.
• Verifying images - cosign, release evidence, vulnerability policy, and image labels.
• Maintainer guide - update, generation, validation, release, and cleanup workflow.
• Troubleshooting - common build, smoke test, catalog, and release issues.

Use the root Makefile for the supported command surface:

make help
make validate
make build PG=18 DEBIAN=trixie
make smoke PG=18 DEBIAN=trixie

Generated Dockerfiles, workflow matrices, catalogs, and generated docs are derived from image metadata. For the CloudNativePG TimescaleDB image family, edit cloudnative-pg-timescaledb/versions.yaml and regenerate outputs instead of hand-editing generated files.

Small fixes are welcome. Please read CONTRIBUTING.md before opening a pull request, especially the notes about generated files and validation.

Public image verification and vulnerability gates are described in docs/user-guide/verifying-images.md. To report a sensitive security issue, follow SECURITY.md.

This repository is released under the MIT License.