Caching with CPM.cmake and ccache on GitHub Actions

Caching with GitHub Actions

You can use CPM_SOURCE_CACHE on GitHub Actions workflows cache and combine it with ccache, to make your CI faster.

CPM.cmake

You need to set a path on actions/cache to CPM and use the same path on CPM_SOURCE_CACHE. Here we are using ~/cpm-cache:

- name: Set up cache
  id: cache-cpm
  uses: actions/cache@v2
  with:
    path: ~/cpm-cache
    key: ${{ runner.os }}-cpm-${{ hashFiles('**/') }}
    restore-keys: |
      ${{ runner.os }}-cpm-
                  
- name: Build CMake
  run: |
    mkdir build && cd build
    cmake -DCPM_SOURCE_CACHE=~/cpm-cache ..
    make -j2

ccache

To implement ccache to your workflow first, you need to install it:

- name: Download ccache
    id: ccache
    shell: cmake -P {0}
    run: |
      set(ccache_url "https://github.com/cristianadam/ccache/releases/download/v$ENV{CCACHE_VERSION}/${ { runner.os } }.tar.xz")
      file(DOWNLOAD "${ccache_url}" ./ccache.tar.xz SHOW_PROGRESS)
      execute_process(COMMAND ${CMAKE_COMMAND} -E tar xvf ./ccache.tar.xz)

Enable ccache support:

- name: Prepare ccache timestamp
    id: ccache_cache_timestamp
    shell: cmake -P {0}
    run: |
    string(TIMESTAMP current_date "%Y-%m-%d-%H;%M;%S" UTC)
    message("::set-output name=timestamp::${current_date}")

- name: ccache cache files
    uses: actions/cache@v2
    with:
      path: .ccache
      key: ${ { matrix.config.name } }-ccache-${ { steps.ccache_cache_timestamp.outputs.timestamp } }
      restore-keys: |
        ${ { matrix.config.name } }-ccache-

More information on how to set up your CMake to use ccache here.