User Guide

The RADIUSS Spack Configs projects provides a coherent set of Spack configuration files targetting Livermore Computing systems. The goal is to enable any Spack user to quickly reproduce the exact same configuration RADIUSS projects are vetted with.

RADIUSS Spack Configs can be used to provide the RADIUSS Shared CI infrastructure with a build and test process and a proposed list of Spack specs. In practice, sharing that list of Specs helps Umpire, RAJA, CHAI, Caliper and other projects to ensure, in their CI, that they keep running correctly with toolchains of interest.

RADIUSS Spack Configs provides Spack configuration files tuned for Livermore Computing (LC) machines. It is also possible to create a local set of Spack packages. Uberenv can leverage these shared configuration to ease the use of Spack on LC systems. Using the CachedCMakePackages allows us to only install a project dependencies and generate a CMakeCache file to proceed with the project build manually.

The figure illustrates the setup of a project using the RADIUSS Spack Configs, Uberenv and Spack as a build infrastructure.

Both RADIUSS Spack Configs and Uberenv are to be set as submodules.

We will describe how to set up RADIUSS Spack Configs to build your project and its dependencies with Spack. We identified two key steps:

• Use Spack to install dependencies and configure the project build
  • Why Spack
  • End product
  • Uberenv Guide
  • Get the shared Spack configuration
  • Setup your Spack package to generate a configuration file
• Build and test your code using your usual workflow
  • Using configuration files to build the project
  • Writing a script for CI
  • Debugging

We also provide “How To” sections to perform various usage tasks.

• How To…
  • Update Spack, Uberenv, or RADIUSS Spack Configs
  • Share jobs between projects in the Shared CI infrastructure
  • Project specific variants and dependencies
  • Compare the build and CI configurations of two projects
  • List the Spack specs tested
  • Use Uberenv
  • Choose a Spack reference (commit or branch)