docs: add note to test readme about testing with CRDB

diff --git a/tests/README.rst b/tests/README.rst
index a428bb4d7a749886b5c8d423bb5fa46961114621..bdbae40c883033f7309767a1a1f7f7af4c90cf1e 100644 (file)
--- a/tests/README.rst
+++ b/tests/README.rst
@@ -71,3 +71,17 @@ a set of env vars working for your setup::
 
     # pip install -e ./psycopg[test] ./psycopg_c
     # pytest
+
+
+Testing with CockroachDB
+========================
+
+You can run CRDB in a docker container using::
+
+    docker run -p 26257:26257 --name crdb --rm \
+        cockroachdb/cockroach:v22.1.3 start-single-node --insecure
+
+And use the following connection string to run the tests::
+
+    export PSYCOPG_TEST_DSN="host=localhost port=26257 user=root dbname=defaultdb"
+    pytest ...