Skip to content

Latest commit

 

History

History
37 lines (25 loc) · 2.54 KB

README.md

File metadata and controls

37 lines (25 loc) · 2.54 KB

Repository for sources of ClickHouse in Docker Official Library

The repo provides sources for clickhouse.

The content here is autogenerated by the official_docker.py and shouldn't be edited manually.

Update process

The process is automated by the script tests/ci/official_docker_update.py in the main repository on a weekly base. The workflow can be triggered manually to force the instant update.

Description of what is done to update official docker library under the hood

Images update

The script official_docker.py has two working modes:

  • Generating source-tree for docker build command in server or keeper directory
  • Generating LDF (Library Definition File) for official-images repository

After new releases are created, one should follow the next steps:

  1. Clone this repository to $LDF_SRC_DIR and ClickHouse/ClickHouse somewhere nearby.
  2. Run the script from ClickHouse/ClickHouse repository:
    python tests/ci/official_docker.py generate-tree -vvv --directory $LDF_SRC_DIR --dockerfile-glob Dockerfile.ubuntu --build --commit
  3. Regenerate the LDF:
    python tests/ci/official_docker.py generate-ldf -vvv --directory ../docker-library --dockerfile-glob Dockerfile.ubuntu --commit
  4. Push changes to our fork of docker-library and create a pull request in the upstream.

Documentation update

The documentation sources live in docker/server/README.src directory.

  1. Update the corresponding part of the sources.
  2. Launch README.sh and update the README.md in upstream.
  3. Copy sources to our fork of docker-library/docs, remove the part between comments, related to our repository, and make a pull request.