76 lines
2.4 KiB
ReStructuredText
76 lines
2.4 KiB
ReStructuredText
.. Copyright 2013-2019 Lawrence Livermore National Security, LLC and other
|
|
Spack Project Developers. See the top-level COPYRIGHT file for details.
|
|
|
|
SPDX-License-Identifier: (Apache-2.0 OR MIT)
|
|
|
|
.. _spack-101:
|
|
|
|
=============================
|
|
Tutorial: Spack 101
|
|
=============================
|
|
|
|
This is a full-day introduction to Spack with lectures and live demos.
|
|
It was last presented at the `First Workshop on NSF and DOE High
|
|
Performance Computing Tools
|
|
<http://oaciss.uoregon.edu/NSFDOE19/agenda.html>`_ on July 10, 2019.
|
|
|
|
You can use these materials to teach a course on Spack at your own site,
|
|
or you can just skip ahead and read the live demo scripts to see how
|
|
Spack is used in practice.
|
|
|
|
.. _sc16-slides:
|
|
|
|
.. rubric:: Slides
|
|
|
|
.. figure:: tutorial/sc16-tutorial-slide-preview.png
|
|
:target: https://spack.io/slides/Spack-ISC19-Tutorial.pdf
|
|
:height: 72px
|
|
:align: left
|
|
:alt: Slide Preview
|
|
|
|
`Download Slides <https://spack.io/slides/Spack-DOE-NSF-Tutorial-2019.pdf>`_.
|
|
|
|
**Full citation:** Todd Gamblin and Gregory Becker. Managing HPC Software
|
|
Complexity with Spack. Tutorial presented at the First Workshop on NSF
|
|
and DOE High Performance Computing Tools. July 9, 2019. Eugene, Oregon,
|
|
USA.
|
|
|
|
.. _sc16-live-demos:
|
|
|
|
.. rubric:: Live Demos
|
|
|
|
We provide scripts that take you step-by-step through basic Spack tasks.
|
|
They correspond to sections in the slides above. You can use one of the
|
|
following methods to run through the scripts:
|
|
|
|
1. We provide the `spack/tutorial
|
|
<https://hub.docker.com/r/spack/tutorial>`_ container image on
|
|
Docker Hub that you can use to do the tutorial on your local
|
|
machine. You can invoke ``docker run -it spack/tutorial`` to start
|
|
using the container.
|
|
|
|
2. When we host the tutorial, we also provision VM instances in `AWS
|
|
<https://aws.amazon.com/>`_, so that users who are unfamiliar with
|
|
Docker can simply log into a VPM to do the demo exercises.
|
|
|
|
You should now be ready to run through our demo scripts:
|
|
|
|
1. :ref:`basics-tutorial`
|
|
2. :ref:`configs-tutorial`
|
|
3. :ref:`packaging-tutorial`
|
|
4. :ref:`environments-tutorial`
|
|
5. :ref:`modules-tutorial`
|
|
6. :ref:`build-systems-tutorial`
|
|
7. :ref:`advanced-packaging-tutorial`
|
|
|
|
Full contents:
|
|
|
|
.. toctree::
|
|
tutorial_basics
|
|
tutorial_configuration
|
|
tutorial_packaging
|
|
tutorial_environments
|
|
tutorial_modules
|
|
tutorial_buildsystems
|
|
tutorial_advanced_packaging
|