Lanl/mirrors

README.md

@@ -5,3 +5,17 @@ A tool for building a scientific software stack from a recipe for vClusters on C
 Read the [documentation](https://eth-cscs.github.io/stackinator/) to get started.
 
 Create a ticket in our [GitHub issues](https://github.com/eth-cscs/stackinator/issues) if you find a bug, have a feature request or have a question.
+
+## running tests:
+
+Use uv to run the tests, which will in turn ensure that the correct dependencies from `pyproject.toml` are used:
+
+```
+uv run pytest
+```
+
+Before pushing, apply the linting rules (this calls uv under the hood):
+
+```
+./lint
+```

bin/stack-config

@@ -1,7 +1,8 @@
-#!/usr/bin/env -S uv run --script
+#!/usr/bin/env -S uv run --no-refresh --script
 # /// script
 # requires-python = ">=3.12"
 # dependencies = [
+#   "python-magic",
 #   "jinja2",
 #   "jsonschema",
 #   "pyYAML",

docs/cluster-config.md

@@ -93,6 +93,13 @@ packages:
         version: ["git.59b6de6a91d9637809677c50cc48b607a91a9acb=main"]
     ```
 
+### Configuring Spack mirrors
+
+Mirrors and caches are **not** part of the system configuration.
+They are supplied per-invocation with `stack-config --mirror <file>`, because the locations involved (build caches, source caches) are often specific to the user running the build and may not be accessible to everyone using a system.
+
+See [Mirrors and Build Caches](build-caches.md) for the full reference and examples.
+
 ## Site and System Configurations
 
 The `repo.yaml` configuration can be used to provide a list of additional Spack package repositories to use on the target system.

docs/configuring.md

@@ -16,7 +16,8 @@ The following flags are required:
 
 The following flags are optional:
 
-* `-c/--cache`: configure the [build cache](build-caches.md).
+* `--mirror`: path to a [mirrors.yaml](build-caches.md) file configuring build caches and mirrors.
+* `-c/--cache`: legacy build cache configuration file (deprecated; use `--mirror`).
 * `-m/--mount`: override the [mount point](installing.md) where the stack will be installed.
 * `--version`: print the stackinator version.
 * `-h/--help`: print help message.