feat: add pg_crash container image (#126)

Adds the `pg_crash` extension, a tool for chaos engineering in
PostgreSQL environments. It allows for scheduled or random process
termination (SIGKILL/SIGTERM/SIGQUIT) to validate high availability (HA)
and failover mechanisms.

Closes #123

Signed-off-by: Gabriele Bartolini <gabriele.bartolini@enterprisedb.com>
Signed-off-by: Niccolò Fei <niccolo.fei@enterprisedb.com>
Signed-off-by: Marco Nenciarini <marco.nenciarini@enterprisedb.com>
Co-authored-by: Niccolò Fei <niccolo.fei@enterprisedb.com>
Co-authored-by: Marco Nenciarini <marco.nenciarini@enterprisedb.com>

Author: 3 people

.github/workflows/bake.yml

@@ -12,6 +12,7 @@ on:
           - pgvector
           - postgis
           - pgaudit
+          - pg-crash
 
 defaults:
   run:
@@ -52,6 +53,9 @@ jobs:
             pgaudit:
               - 'pgaudit/**'
               - *shared
+            pg-crash:
+              - 'pg-crash/**'
+              - *shared
 
       # Compute a matrix containing the list of all extensions that have been modified
       - name: Compute matrix

README.md

@@ -34,9 +34,10 @@ they are maintained by their respective authors, and PostgreSQL Debian Group
 
 | Extension | Description | Project URL |
 | :--- | :--- | :--- |
-| **[pgAudit](pgaudit)** | PostgreSQL audit extension | [https://github.com/pgaudit/pgaudit](https://github.com/pgaudit/pgaudit) |
-| **[pgvector](pgvector)** | Vector similarity search for PostgreSQL | [https://github.com/pgvector/pgvector](https://github.com/pgvector/pgvector) |
-| **[PostGIS](postgis)** | Geospatial database extension for PostgreSQL | [https://postgis.net/](https://postgis.net/) |
+| **[pgAudit](pgaudit)** | PostgreSQL audit extension | [github.com/pgaudit/pgaudit](https://github.com/pgaudit/pgaudit) |
+| **[pg_crash](pg-crash)** | **Disruptive** fault injection and chaos engineering extension | [github.com/cybertec-postgresql/pg_crash](https://github.com/cybertec-postgresql/pg_crash) |
+| **[pgvector](pgvector)** | Vector similarity search for PostgreSQL | [github.com/pgvector/pgvector](https://github.com/pgvector/pgvector) |
+| **[PostGIS](postgis)** | Geospatial database extension for PostgreSQL | [postgis.net/](https://postgis.net/) |
 
 
 Extensions are provided only for the OS versions already built by the

pg-crash/Dockerfile

@@ -0,0 +1,26 @@
+# SPDX-FileCopyrightText: Copyright © contributors to CloudNativePG, established as CloudNativePG a Series of LF Projects, LLC.
+# SPDX-License-Identifier: Apache-2.0
+
+ARG BASE=ghcr.io/cloudnative-pg/postgresql:18-minimal-trixie
+FROM $BASE AS builder
+
+ARG PG_MAJOR
+ARG EXT_VERSION
+
+USER 0
+
+# Install extension via `apt-get`
+RUN apt-get update && apt-get install -y --no-install-recommends \
+      "postgresql-${PG_MAJOR}-pg-crash=${EXT_VERSION}"
+
+FROM scratch
+ARG PG_MAJOR
+
+# Licenses
+COPY --from=builder /usr/share/doc/postgresql-${PG_MAJOR}-pg-crash/copyright /licenses/postgresql-${PG_MAJOR}-pg-crash/
+
+# Libraries
+COPY --from=builder /usr/lib/postgresql/${PG_MAJOR}/lib/pg_crash* /lib/
+COPY --from=builder /usr/lib/postgresql/${PG_MAJOR}/lib/bitcode/ /lib/bitcode/
+
+USER 65532:65532

pg-crash/README.md

@@ -0,0 +1,84 @@
+# `pg_crash`
+<!--
+SPDX-FileCopyrightText: Copyright © contributors to CloudNativePG, established as CloudNativePG a Series of LF Projects, LLC.
+SPDX-License-Identifier: Apache-2.0
+-->
+
+[pg_crash](https://github.com/cybertec-postgresql/pg_crash) is a PostgreSQL
+extension designed for **fault injection** and **chaos engineering**. It allows
+administrators to simulate various failure scenarios—such as backend crashes
+and signal handling issues—to verify the resilience of High Availability (HA)
+clusters and self-healing mechanisms.
+
+> [!CAUTION]
+> **DO NOT USE THIS IMAGE IN PRODUCTION.**
+> This extension is designed to intentionally destabilize and terminate
+> PostgreSQL processes. Deploying it in production will cause service downtime
+> and potential data availability issues.
+>
+> Only deploy this extension in **dedicated test or staging namespaces**.
+> Consider using Kubernetes admission controllers or OPA/Gatekeeper policies
+> to prevent accidental deployment to production clusters.
+
+This extension image is maintained by the CNPG project and supersedes the
+[`pgcrash-containers` project](https://github.com/cloudnative-pg/pgcrash-containers).
+
+## Usage
+
+The `pg_crash` extension must be loaded via `shared_preload_libraries`. It
+operates by periodically sending random signals (selected from a user-defined
+list) to PostgreSQL backend processes.
+
+The following example configures a cluster to experience "Chaos" by randomly
+sending signals every 60 seconds. This is ideal for testing how quickly
+CloudNativePG detects a failure and promotes a new primary.
+
+```yaml
+apiVersion: postgresql.cnpg.io/v1
+kind: Cluster
+metadata:
+  name: cluster-pg-crash
+spec:
+  imageName: ghcr.io/cloudnative-pg/postgresql:18-minimal-trixie
+  instances: 3
+
+  storage:
+    size: 1Gi
+
+  postgresql:
+    extensions:
+    - name: pg-crash
+      image:
+        # renovate: suite=trixie-pgdg depName=postgresql-18-pg-crash
+        reference: ghcr.io/cloudnative-pg/pg-crash:0.3-18-trixie
+    shared_preload_libraries:
+    - pg_crash
+    parameters:
+      log_min_messages: 'DEBUG1'
+      # See https://www.postgresql.org/docs/current/server-shutdown.html
+      # SIGHUP  (1)  - Reload
+      # SIGINT  (2)  - Fast shutdown
+      # SIGQUIT (3)  - Immediate shutdown
+      # SIGTERM (15) - Smart shutdown
+      crash.signals: '1 2 3 15'
+      crash.delay: '60'
+```
+
+---
+
+## Licenses and Copyright
+
+`pg_crash`:
+
+- **Copyright:** (c) 2017, 2025 CYBERTEC PostgreSQL International GmbH
+- **License:** BSD 3-Clause License
+
+All relevant license and copyright information for the `pg-crash` extension
+and its dependencies are bundled within the image at:
+
+```text
+/licenses/
+```
+
+By using this image, you agree to comply with the terms of the licenses
+contained therein.

pg-crash/metadata.hcl

@@ -0,0 +1,27 @@
+# SPDX-FileCopyrightText: Copyright © contributors to CloudNativePG, established as CloudNativePG a Series of LF Projects, LLC.
+# SPDX-License-Identifier: Apache-2.0
+metadata = {
+  name                     = "pg-crash"
+  sql_name                 = "pg_crash"
+  image_name               = "pg-crash"
+  licenses                 = ["BSD-3-Clause"]
+  shared_preload_libraries = ["pg_crash"]
+  extension_control_path   = []
+  dynamic_library_path     = []
+  ld_library_path          = []
+  bin_path                 = []
+  auto_update_os_libs      = false
+  required_extensions      = []
+  create_extension         = false
+
+  versions = {
+    bookworm = {
+      // renovate: suite=bookworm-pgdg depName=postgresql-18-pg-crash
+      "18" = "0.3-2.pgdg12+1"
+    }
+    trixie = {
+      // renovate: suite=trixie-pgdg depName=postgresql-18-pg-crash
+      "18" = "0.3-2.pgdg13+1"
+    }
+  }
+}