You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudberry.apache.org by "DimaOshchepkov (via GitHub)" <gi...@apache.org> on 2026/04/24 13:20:34 UTC

[PR] doc: added instructions for creating a test environment in docker [cloudberry]

DimaOshchepkov opened a new pull request, #1697:
URL: https://github.com/apache/cloudberry/pull/1697

     Fixes discuss #1682
   
     ### What does this PR do?
     Adds documentation for a local Docker-based test environment that mounts an existing Cloudberry checkout into a long-running container.
   
     The new section in `devops/README.md` explains how to:
     - start a reusable test container from the published Cloudberry build image
     - enter the container as `gpadmin`
     - auto-source Cloudberry and demo cluster environments in interactive shells
     - initialize the system, build Cloudberry, create a demo cluster, and reload the shell
     - run example regression and isolation tests from the mounted checkout
     - recover missing environment setup with `exec bash` or explicit `source` commands
     - stop and remove the container when finished
   
     It also adds a short cross-reference in `devops/sandbox/README.md` pointing readers to the new testing instructions.
   
     ### Type of Change
     - [ ] Bug fix (non-breaking change)
     - [ ] New feature (non-breaking change)
     - [ ] Breaking change (fix or feature with breaking changes)
     - [x] Documentation update
   
     ### Test Plan
     - [ ] Unit tests added/updated
     - [ ] Integration tests added/updated
     - [ ] Passed `make installcheck`
     - [ ] Passed `make -C src/test installcheck-cbdb-parallel`
   
     Doc-only change; tests were not run.
   
     ### Impact
     **Performance:**
     None.
   
     **User-facing changes:**
     Developers now have documented steps for creating a Docker-based local test environment against a bind-mounted checkout, which simplifies building and running tests without installing build dependencies on the host.
   
     **Dependencies:**
     No new dependencies. The instructions use the existing published Cloudberry Docker build image.
   
     ### Checklist
     - [x] Followed [contribution guide](https://cloudberry.apache.org/contribute/code)
     - [x] Added/updated documentation
     - [x] Reviewed code for security implications
     - [ ] Requested review from [cloudberry committers](https://github.com/orgs/apache/teams/cloudberry-committers)
   
     ### Additional Context
     This is a documentation-only change focused on improving the local developer workflow for running tests inside Docker while keeping the source tree on the host.
   
     ### CI Skip Instructions
     This is a documentation-only change. If needed, a CI skip tag can be added to the PR title according to the repository guidelines.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@cloudberry.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cloudberry.apache.org
For additional commands, e-mail: commits-help@cloudberry.apache.org