This is an automated email from the ASF dual-hosted git repository.
djwang pushed a commit to branch merge-with-upstream
in repository https://gitbox.apache.org/repos/asf/cloudberry-pxf.git
The following commit(s) were added to refs/heads/merge-with-upstream by this
push:
new a3e52c55 Automation: add README on how to run tests
a3e52c55 is described below
commit a3e52c55bbe0fe6b7d00efee8b2f5666e10e8041
Author: Nikolay Antonov <[email protected]>
AuthorDate: Thu Jan 15 14:51:52 2026 +0400
Automation: add README on how to run tests
---
automation/README.Docker.md | 53 +++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 53 insertions(+)
diff --git a/automation/README.Docker.md b/automation/README.Docker.md
new file mode 100644
index 00000000..88d61c62
--- /dev/null
+++ b/automation/README.Docker.md
@@ -0,0 +1,53 @@
+# Running Automation in Docker
+
+## Prerequisites
+
+Before running the automation tests, ensure you have:
+
+* Docker and Docker Compose installed
+* Both `cloudberry-pxf` and `cloudberry` repositories cloned in the same
parent directory (they will be mounted into the Docker container)
+
+## Running Automation Tests
+
+1. Navigate to the `cloudberry-pxf` directory:
+ ```bash
+ cd cloudberry-pxf
+ ```
+
+2. Stop and remove any existing containers and volumes:
+ ```bash
+ docker compose -f concourse/docker/pxf-cbdb-dev/ubuntu/docker-compose.yml
down -v
+ ```
+
+3. Build the Docker images:
+ ```bash
+ docker compose -f concourse/docker/pxf-cbdb-dev/ubuntu/docker-compose.yml
build
+ ```
+
+4. Start the containers in detached mode:
+ ```bash
+ docker compose -f concourse/docker/pxf-cbdb-dev/ubuntu/docker-compose.yml
up -d
+ ```
+
+5. Run the entrypoint script to set up the environment:
+ ```bash
+ docker exec pxf-cbdb-dev bash -lc \
+ "cd
/home/gpadmin/workspace/cloudberry-pxf/concourse/docker/pxf-cbdb-dev/ubuntu &&
./script/entrypoint.sh"
+ ```
+
+6. Execute the test suite:
+ ```bash
+ docker exec pxf-cbdb-dev bash -lc \
+ "cd
/home/gpadmin/workspace/cloudberry-pxf/concourse/docker/pxf-cbdb-dev/ubuntu &&
./script/run_tests.sh"
+ ```
+ You can run tests multiple times in one container.
+
+## Troubleshooting
+When something went wrong:
+
+Jump into container: `docker compose ps` + `docker exec -it <id> bash`
+
+Check logs:
+
+* **PXF logs**: `/home/gpadmin/pxf-base/logs/`
+* **Hadoop logs**: `/home/gpadmin/workspace/singlecluster/storage/logs/`
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
