Add docker environment for containerized tests

Author: saratomaz

docker/.dockerignore

@@ -0,0 +1,66 @@
+# Ignore unnecessary files during Docker build
+
+# Git
+.git/
+.gitignore
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# Testing artifacts
+run_workdir/
+.artifacts/
+.cli_coverage/
+.reports/
+allure-results/
+allure-results.tar.xz
+testrun-report.*
+*.log
+*.json.log
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Nix
+result
+result-*
+
+# Documentation
+docs/_build/
+*.md
+
+# Temporary files
+*.tmp
+*.bak
+.DS_Store
+
+# Scripts output
+scripts/destination/
+scripts/destination_working/
+
+# Coverage
+.coverage
+htmlcov/
+cli_coverage.json
+requirements_coverage.json
+
+# CI specific
+.bin/

docker/Dockerfile

@@ -0,0 +1,29 @@
+# Dockerfile for cardano-node-tests (Antithesis/Moog driver image)
+#
+# Minimal image: nix is configured and the repo is copied in.
+# All heavy setup (cardano binaries, Python venv) happens at runtime
+# via regression.sh, which manages its own nix environment through its shebang.
+#
+# Build and push to GHCR before submitting to Moog:
+#   docker build -f docker/Dockerfile -t ghcr.io/intersectmbo/cardano-node-tests:antithesis .
+#   docker push ghcr.io/intersectmbo/cardano-node-tests:antithesis
+
+FROM nixos/nix:2.25.5
+
+RUN mkdir -p /etc/nix && \
+    echo "extra-substituters = https://cache.iog.io" >> /etc/nix/nix.conf && \
+    echo "extra-trusted-public-keys = hydra.iohk.io:f/Ea+s+dFdN+3Y/G+FDgSq+a5NEWhJGzdjvKNGv0/EQ=" >> /etc/nix/nix.conf && \
+    echo "experimental-features = nix-command flakes" >> /etc/nix/nix.conf && \
+    echo "accept-flake-config = true" >> /etc/nix/nix.conf && \
+    echo "allow-import-from-derivation = true" >> /etc/nix/nix.conf
+
+WORKDIR /work
+COPY . /work/
+
+# Place the singleton_driver script where Antithesis expects it.
+# The wrapper calls regression.sh directly so that regression.sh resolves
+# its own REPODIR correctly from its own $0.
+RUN mkdir -p /opt/antithesis/test/v1/regression && \
+    printf '#!/usr/bin/env bash\nexec /work/.github/regression.sh\n' \
+        > /opt/antithesis/test/v1/regression/singleton_driver_regression.sh && \
+    chmod +x /opt/antithesis/test/v1/regression/singleton_driver_regression.sh

docker/README.md

@@ -0,0 +1,59 @@
+# Docker setup for cardano-node-tests (Antithesis/Moog)
+
+This directory contains the driver image and compose file for submitting
+`cardano-node-tests` to Antithesis via the Moog platform.
+
+## How it works
+
+- `Dockerfile` — minimal image: configures Nix and copies the repo into
+  `/work/`. No binaries are pre-built; `regression.sh` handles all setup at
+  runtime via its own Nix shebang.
+- `docker-compose.yml` — single `driver` service for Moog submission.
+- The image places a `singleton_driver_regression.sh` wrapper at
+  `/opt/antithesis/test/v1/regression/`, which is where Antithesis looks for
+  test commands.
+
+## Workflow
+
+### 1. Build and push the image
+
+```bash
+docker build -f docker/Dockerfile \
+  -t ghcr.io/intersectmbo/cardano-node-tests:antithesis .
+
+docker push ghcr.io/intersectmbo/cardano-node-tests:antithesis
+```
+
+### 2. Validate the compose locally
+
+```bash
+docker compose -f docker/docker-compose.yml config
+docker compose -f docker/docker-compose.yml up --build
+```
+
+### 3. Submit to Moog
+
+```bash
+moog requester create-test \
+  --platform github \
+  --username <your-github-username> \
+  --repository IntersectMBO/cardano-node-tests \
+  --directory ./docker \
+  --commit <commit-hash> \
+  --try 1 \
+  --duration 2
+```
+
+## Environment variables
+
+| Variable          | Default    | Description                              |
+|-------------------|------------|------------------------------------------|
+| `NODE_REV`        | `master`   | cardano-node git revision                |
+| `CARDANO_CLI_REV` | (built-in) | cardano-cli revision, empty = use node's |
+| `DBSYNC_REV`      | (disabled) | db-sync revision, empty = disabled       |
+| `RUN_TARGET`      | `tests`    | `tests`, `testpr`, or `testnets`         |
+| `MARKEXPR`        |            | pytest marker expression                 |
+| `CLUSTERS_COUNT`  |            | number of local cluster instances        |
+| `CLUSTER_ERA`     |            | e.g. `conway`                            |
+| `PROTOCOL_VERSION`|            | e.g. `11`                                |
+| `UTXO_BACKEND`    |            | e.g. `disk`, `mem`                       |

docker/docker-compose.yml

@@ -0,0 +1,29 @@
+# Docker Compose for Antithesis/Moog test submission.
+#
+# Submit to Moog:
+#   moog requester create-test \
+#     --platform github --username <you> \
+#     --repository IntersectMBO/cardano-node-tests \
+#     --directory ./docker \
+#     --commit <hash> --try 1 --duration 2
+#
+# Validate locally before submitting:
+#   docker compose -f docker/docker-compose.yml config
+#   docker compose -f docker/docker-compose.yml up --build
+
+services:
+  driver:
+    image: ghcr.io/intersectmbo/cardano-node-tests:antithesis
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile
+    environment:
+      - NODE_REV=${NODE_REV:-master}
+      - CARDANO_CLI_REV=${CARDANO_CLI_REV:-}
+      - DBSYNC_REV=${DBSYNC_REV:-}
+      - RUN_TARGET=${RUN_TARGET:-tests}
+      - MARKEXPR=${MARKEXPR:-}
+      - CLUSTERS_COUNT=${CLUSTERS_COUNT:-}
+      - CLUSTER_ERA=${CLUSTER_ERA:-}
+      - PROTOCOL_VERSION=${PROTOCOL_VERSION:-}
+      - UTXO_BACKEND=${UTXO_BACKEND:-}