devoopsman45 commented on code in PR #1881: URL: https://github.com/apache/datafusion-ballista/pull/1881#discussion_r3444086574
########## docs/source/user-guide/deployment/docker-compose.md: ########## @@ -19,37 +19,51 @@ # Starting a Ballista Cluster using Docker Compose -Docker Compose is a convenient way to launch a cluster when testing locally. +Two Compose files are provided. Choose based on whether you need the last stable release +or want to run against local source changes. -## Build Docker Images +## Option 1: Pre-built images (no local build required) -To create the required Docker images please refer to the [docker deployment page](docker.md). +`docker-compose.quick.yml` pulls images directly from GHCR — no Rust toolchain needed. +Images are published on each stable release; `latest` tracks the most recent release, +not the `main` branch. -## Start a Cluster +```bash +docker compose -f docker-compose.quick.yml up +``` + +See the [quickstart guide](quick-start.md) for connection instructions and data volume setup. -Using the [docker-compose.yml](https://github.com/apache/datafusion-ballista/blob/main/docker-compose.yml) from the -source repository, run the following command to start a cluster: +## Option 2: Build from source + +`docker-compose.yml` builds executor and scheduler images from the local Dockerfiles. +The Dockerfiles copy pre-compiled binaries — they do **not** run `cargo build` themselves. +You must compile first: ```bash -docker-compose up --build +# Step 1 — compile (requires Rust + protoc, takes ~20 min cold) Review Comment: Agreed. I will remove the time taken estimates. ########## docs/source/user-guide/deployment/quick-start.md: ########## @@ -19,128 +19,167 @@ # Ballista Quickstart -A simple way to start a local cluster for testing purposes is to use cargo to build the project and then run the scheduler and executor binaries directly. +There are two ways to get a local Ballista cluster running. Choose based on your goal: -Project Requirements: +| | [Evaluate Ballista](#path-a-evaluate-with-docker-2-min) | [Build from source](#path-b-build-from-source-20-min) | +|---|---|---| +| Goal | Try Ballista against the last stable release | Develop or test against local code changes | +| Prerequisites | Docker | Rust, protoc | +| Cold start time | ~2 min (image pull) | ~20 min (full compile) | Review Comment: Agreed. I will remove the time taken estimates. -- 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: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
