Chef Autamus, at your service!
Wouldn’t it be fun to build a custom software container with any number of packages available on autamus.io? @alecbcs and I thought so too! Let’s walk through this fun project by asking and answering some questions.
What is autamus?
A Semi-Autonomous Build System for Scientific Containers
This means that we have an entire library of Docker containers that build directly from spack packages. That’s right - you can pull a container with your favorite spack package without waiting for it to build from source! These same containers are also provided on Singularity Registry HPC to install on your local cluster with environment modules.
Autamus is much cooler than just a registry - it automatically detects changed package versions (not depending on spack, which does not do this and requires manual updating) and then opens a pull request with the package updates. Here is an example update for LMOD. The pull request with the update will also rebuild all package containers that depend on the library of interest. Here is an example doing that for Python.
How is Autamus related to spack?
Autamus builds containers from spack packages, and maintains it’s own updated folder in the registry. The driver behind this is a bot named binoc (short for binoculars) that can read any spack package file and then look for updates at whatever source it is derived from. Binoc then knows how to open a pull request with these updates, and the autamus registry uses a few other helper libraries to build a new container along with containers for all dependencies. This functionality could easily be added to spack one day, but it comes at the cost of many more pull requests for maintainers to review, so it wouldn’t be a good decision at this point in time. However, all of the updated package files live in the registry, and could be extended to spack some day.
Autamus serves a different use case than spack as it provides container bases (and tools around that related to containers) and shoud not be considered a competitor. Likely you would use one or the other based on your use case.
How does it work?
Autamus Chef (wasm) is a web assembly application, meaning we’ve actually compiled a small Go library that you can see in the repository linked there. The real driver of this is the autamus/chef library, which is a command line client and library for generating these multi-stage build Dockerfiles from autamus packages. For the command line client we:
- Read in a list of packages and versions from a chef.yaml file
- Validate that they exist by looking for their manifests
- Generate the Dockerfile, with each spack install being copied to a final install folder
We then use these same functions in the chef wasm interface, except instead of requiring validation with an http request, we instead load the known packages from the Autamus library API and allow you to select from only those. We can quickly generate the Dockerfile any time you select or remove a new package. We generate the wasm interface with a slightly different compile command to generate chef.wasm:
GOOS=js GOARCH=wasm go build -o chef.wasm; mv chef.wasm docs/
How do I use it?
You start in the web interface:
And whatever packages are available in autamus (and their versions!) will appear as options in the dropdown. This is possible because the autamus library serves a little JSON library API for you to use. You can search and select packages in the search box, and as you add or remove packages a Dockerfile recipe is updated in the right of the screen. You can then download the recipe, optionally add to version control, and build and interact with your container! Instructions are provided in the README of the repository and re-iterated here.
1. Build the container
You want to do the build in the same directory as your Dockerfile.
I like using
DOCKER_BUILDKIT for more efficient builds:
$ DOCKER_BUILDKIT=1 docker build -t mystack .
When you shell into your container, you will be in the spack root at
$ docker run -it mystack
And spack is available to you!
# which spack /opt/spack/bin/spack
To see your installed software, use
$ spack find root@62b0820b3524:/opt/spack# spack find ==> 61 installed packages -- linux-ubuntu18.04-skylake / firstname.lastname@example.org ------------------------ email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com universal-ctags@master -- linux-ubuntu18.04-x86_64 / firstname.lastname@example.org ------------------------- email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com firstname.lastname@example.org email@example.com
And then to load any particular piece of software (meaning it gets added to your path) use
spack load. Let’s load Python!
# setup your environment $ . /opt/spack/share/spack/setup-env.sh # load Python root@62b0820b3524:/opt/spack# spack load firstname.lastname@example.org # Did we load it? root@62b0820b3524:/opt/spack# which python /opt/spack/opt/spack/linux-ubuntu18.04-x86_64/gcc-7.5.0/python-3.9.5-kykqwyent2svlspsvehqpu4xdgcp54z5/bin/python /opt/spack# python --version Python 3.9.5
And that’s it! I jumped on this fun little project because I love programming in Go, and I’ll take every opportunity to try doing something in Go or wasm. This is pretty new and experimental, so please open an issue if you run into any trouble. Right now we make available all autamus packages, and it could be that we need to limit to a subset (e.g., with just one architecture) for this app.
Sochat, Vanessa. "Chef Autamus." @vsoch (blog), 12 Jul 2021, https://vsoch.github.io/2021/chef-autamus/ (accessed 07 Aug 22).