CMake Release Utilities

This directory contains scripts used to package CMake itself for distribution on cmake.org. See also the CMake Source Code Guide.

Docker

The <os>/<arch>/ directories contain Docker specifications that anyone may use to produce binaries for CMake on the following platforms:

• linux/x86_64/: Linux on x86_64 architectures.
• win/x86/: Windows on x86_64 and i386 architectures.

Each <os>/<arch>/ directory contains the following:

• <os>/<arch>/base/Dockerfile: Produces a base image with a build environment for portable CMake binaries. This image is published in the kitware/cmake Docker Hub Repository with tag build-<os>-<arch>-base-<date>.

• <os>/<arch>/deps/Dockerfile: Produces an image with custom-built dependencies for portable CMake binaries. This image is published in the kitware/cmake Docker Hub Repository with tag build-<os>-<arch>-deps-<date>.

• <os>/<arch>/Dockerfile: Produce an image containing a portable CMake binary package. Build this image using the CMake source directory as the build context. The resulting image will have an /out (or c:/out) directory containing the package. For example, on Linux x86_64:

  $ docker build --tag=cmake:build --network none \
      -f cmake-src/Utilities/Release/linux/x86_64/Dockerfile cmake-src
  $ docker container create --name cmake-build cmake:build
  $ docker cp cmake-build:/out .
  $ ls out/cmake-*-Linux-x86_64.*
  

  On Windows, the win/x86 specifications support both the x86_64 and i386 architectures selected via --build-arg ARCH=....

• <os>/<arch>/test/Dockerfile: Produces a base image with a test environment for packaged CMake binaries. For example, on Linux x86_64, one may build the test base image:

  $ docker build --tag=cmake:test-base \
      cmake-src/Utilities/Release/linux/x86_64/test
  

  Then create a local test/Dockerfile to prepare an image with both the CMake source tree and the above-built package:

  FROM cmake:test-base
  COPY cmake-src /opt/cmake/src/cmake
  ADD out/cmake-<ver>-Linux-x86_64.tar.gz /opt/
  ENV PATH=/opt/cmake-<ver>-Linux-x86_64/bin:$PATH
  

  Build the test image and run it to drive testing:

  $ docker build --tag cmake:test --network none -f test/Dockerfile .
  $ docker run --network none cmake:test bash test-make.bash
  $ docker run --network none cmake:test bash test-ninja.bash
  

  On Windows, the test scripts are called test-nmake.bat and test-ninja.bat. In the x86 architecture they accept one argument specifying either x86_64 or i386.

Scripts for Kitware

Kitware uses the following scripts to produce binaries for cmake.org. They work only on specific machines Kitware uses for such builds.

• create-cmake-release.cmake: Run cmake -DCMAKE_CREATE_VERSION=$ver -P ../create-cmake-release.cmake to generate create-$ver-*.sh release scripts. It also displays instructions to run them.
• *_release.cmake: Platform-specific settings used in corresponding scripts generated above.
• release_cmake.cmake: Code shared by all *_release.cmake scripts.
• release_cmake.sh.in: Template for script that runs on the actual build machines.