Skip to content

feat(docker): configurable bundled ClickHouse server version#42

Merged
alex-clickhouse merged 2 commits into
mainfrom
docker-configurable-ch-version
Jun 12, 2026
Merged

feat(docker): configurable bundled ClickHouse server version#42
alex-clickhouse merged 2 commits into
mainfrom
docker-configurable-ch-version

Conversation

@alex-clickhouse

Copy link
Copy Markdown
Collaborator

What

Make the ClickHouse server version bundled in the Docker image configurable, instead of always pinning clickhouse/clickhouse-server:latest.

  • Global ARG CH_VERSION=latest declared before the first FROM so it is in scope for the runtime stage's FROM clickhouse/clickhouse-server:${CH_VERSION}.
  • Surfaced through docker-compose.yml as a build arg: CH_VERSION=24.3 docker compose build.
  • README quick start documents both docker build --build-arg CH_VERSION=... and the compose form. Version is baked at build time.

Also lands the CLI/tooling roadmap (todo.md, docs/cli-spec.md) from the requirements session so subsequent per-item branches inherit it.

Why

First item from the roadmap (todo.md #2). Lets users inspect wire-format behavior against a specific server version rather than only the latest.

Testing

  • docker compose config resolves the arg: default latest, override 24.3.
  • CH_VERSION=24.3 docker compose build succeeds; clickhouse-server --version inside the image reports 24.3.18.7.
  • Caught and fixed a real bug along the way: an ARG placed after the first FROM is stage-scoped, leaving ${CH_VERSION} empty in the runtime FROM; moved it to global scope.

🤖 Generated with Claude Code

alex-clickhouse and others added 2 commits June 12, 2026 10:00
Captures the requirements-session decisions for the agent-usable CLI
(chfx), configurable bundled server version, binary-dump import, and the
standalone capture proxy. Lands on main so subsequent per-item branches
inherit the roadmap.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Add a global CH_VERSION build arg (default latest) consumed by the
runtime stage's FROM, surfaced through docker-compose
(CH_VERSION=24.3 docker compose build). Declared before the first FROM
so it is in scope for the runtime FROM. Documents usage in the README
quick start.

Verified: `CH_VERSION=24.3 docker compose build` produces an image whose
clickhouse-server --version reports 24.3.18.7.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@alex-clickhouse alex-clickhouse merged commit c41a090 into main Jun 12, 2026
1 check passed
@alex-clickhouse alex-clickhouse deleted the docker-configurable-ch-version branch June 12, 2026 08:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant