From 4c0cbe256342773bafbabb9fe82d4135b4795890 Mon Sep 17 00:00:00 2001 From: Felipe Gutierrez Date: Thu, 19 Nov 2026 13:26:38 -0500 Subject: [PATCH 1/2] ci: run Ideas Board example integration tests on PRs Adds a Testcontainers-backed workflow (ubuntu-latest has Docker) that runs the examples/ideas-board pytest suite so the tutorial's integration tests (40001 concurrency, follower reads, metrics, CDC) actually execute. Installs the published packages from the anonymous PEP 503 feed as the docs instruct. Multi-region and vector ITs remain gated and skip. --- .github/workflows/examples-it.yml | 41 +++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 .github/workflows/examples-it.yml diff --git a/.github/workflows/examples-it.yml b/.github/workflows/examples-it.yml new file mode 100644 index 0000000..c8a5151 --- /dev/null +++ b/.github/workflows/examples-it.yml @@ -0,0 +1,41 @@ +name: examples-it + +# Runs the Ideas Board example's integration tests on GitHub-hosted runners, +# which ship with Docker — so Testcontainers spins up a real CockroachDB and the +# tutorial's integration tests (the 40001 concurrency proof, follower reads, +# metrics, CDC) actually execute. The example installs the published packages +# from the anonymous PEP 503 feed, exactly as the tutorial/docs tell customers +# to. Multi-region and vector ITs stay gated: REGIONAL BY ROW needs a +# multi-region cluster (CRDB_MULTIREGION=true) and the semantic IT needs a +# VECTOR-capable image (v25.2+) — both skip cleanly here. +on: + pull_request: + paths: + - 'examples/ideas-board/**' + - '.github/workflows/examples-it.yml' + push: + branches: [main] + paths: + - 'examples/ideas-board/**' + - '.github/workflows/examples-it.yml' + workflow_dispatch: + +jobs: + ideas-board-it: + name: Ideas Board integration tests (Testcontainers) + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + - name: Install dependencies (published packages from the Pages feed) + working-directory: examples/ideas-board + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Integration tests (real CockroachDB via Testcontainers) + working-directory: examples/ideas-board + env: + TESTCONTAINERS_RYUK_DISABLED: "true" + run: python -m pytest -v From f1c204512e148f86d0144a4aa2fe3a5217dcc15c Mon Sep 17 00:00:00 2001 From: Felipe Gutierrez Date: Thu, 19 Nov 2026 13:57:16 -0500 Subject: [PATCH 2/2] examples: pin cockroachdb-ai==0.1.2 and run the semantic IT on v26.2 --- .github/workflows/examples-it.yml | 7 ++++--- examples/ideas-board/requirements.txt | 2 +- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/.github/workflows/examples-it.yml b/.github/workflows/examples-it.yml index c8a5151..9ad12b2 100644 --- a/.github/workflows/examples-it.yml +++ b/.github/workflows/examples-it.yml @@ -5,9 +5,10 @@ name: examples-it # tutorial's integration tests (the 40001 concurrency proof, follower reads, # metrics, CDC) actually execute. The example installs the published packages # from the anonymous PEP 503 feed, exactly as the tutorial/docs tell customers -# to. Multi-region and vector ITs stay gated: REGIONAL BY ROW needs a -# multi-region cluster (CRDB_MULTIREGION=true) and the semantic IT needs a -# VECTOR-capable image (v25.2+) — both skip cleanly here. +# to. The semantic IT boots its own vector-index-capable CockroachDB +# (CRDB_VECTOR_IMAGE, default v26.2) via Testcontainers and runs here. The +# multi-region IT stays gated: REGIONAL BY ROW needs a multi-region cluster +# (CRDB_MULTIREGION=true), so it skips cleanly. on: pull_request: paths: diff --git a/examples/ideas-board/requirements.txt b/examples/ideas-board/requirements.txt index 1bb9c8a..b7114cb 100644 --- a/examples/ideas-board/requirements.txt +++ b/examples/ideas-board/requirements.txt @@ -7,7 +7,7 @@ cockroachdb==0.1.2 cockroachdb-core==0.1.2 # metrics (RetryEngine) + follower-read/region context cockroachdb-cdc==0.1.1 # changefeed handlers + webhook payload parsing -cockroachdb-ai==0.1.1 # pgvector vector store (semantic search); IT needs cockroach >= v25.2 +cockroachdb-ai==0.1.2 # pgvector vector store (semantic search); CREATE VECTOR INDEX needs cockroach >= v26.2 psycopg[binary]>=3.1 pytest>=8.0 testcontainers>=4.0 # integration tests only; boot CockroachDB in --insecure mode