A flexible package manager that supports multiple versions, configurations, platforms, and compilers.
Go to file
Massimiliano Culpo 5b272e3ff3
commands: use a single ThreadPool for spack versions (#16749)
This fixes a fork bomb in `spack versions`. Recursive generation of pools
to scrape URLs in `_spider` was creating large numbers of processes.
Instead of recursively creating process pools, we now use a single
`ThreadPool` with a concurrency limit.

More on the issue: having ~10 users running at the same time spack
versions on front-end nodes caused kernel lockup due to the high number
of sockets opened (sys-admin reports ~210k distributed over 3 nodes).
Users were internal, so they had ulimit -n set to ~70k.

The forking behavior could be observed by just running:

    $ spack versions boost

and checking the number of processes spawned. Number of processes
per se was not the issue, but each one of them opens a socket
which can stress `iptables`.

In the original issue the kernel watchdog was reporting:

    Message from syslogd@login03 at May 19 12:01:30 ...
    kernel:Watchdog CPU:110 Hard LOCKUP
    Message from syslogd@login03 at May 19 12:01:31 ...
    kernel:watchdog: BUG: soft lockup - CPU#110 stuck for 23s! [python3:2756]
    Message from syslogd@login03 at May 19 12:01:31 ...
    kernel:watchdog: BUG: soft lockup - CPU#94 stuck for 22s! [iptables:5603]
2020-06-05 00:08:32 -07:00
.github Fix MacOS tests on develop 2020-05-09 17:41:57 -07:00
bin spack-python should exec spack python (#15738) 2020-03-29 19:38:15 -07:00
etc/spack/defaults hdf: new version, variants and refactoring (#16469) 2020-05-25 19:20:04 -05:00
lib/spack commands: use a single ThreadPool for spack versions (#16749) 2020-06-05 00:08:32 -07:00
share/spack commands: use a single ThreadPool for spack versions (#16749) 2020-06-05 00:08:32 -07:00
var/spack add erlang version 23.0 (#16961) 2020-06-04 22:49:46 -07:00
.codecov.yml Add unit test on MacOS using Github Actions (#14220) 2020-05-09 13:35:14 -07:00
.coveragerc Use spack commands --format=bash to generate shell completion (#14393) 2020-01-22 21:31:12 -08:00
.dockerignore fix multiple issues with the docker images (#9718) 2018-12-20 11:11:55 -08:00
.flake8 flake8: add exceptions for overly pedantic camelcase rules from pep8-naming (#11477) 2019-05-16 09:47:02 +02:00
.flake8_packages Spelling fixes (#15805) 2020-04-01 12:02:26 -05:00
.gitattributes git: add .gitattributes file (#13947) 2019-12-02 01:35:38 -08:00
.gitignore Ignore __pycache__ directory (#16836) 2020-06-03 22:09:06 -05:00
.mailmap Update for 'eccodes'. (#6604) 2017-12-08 09:34:37 +01:00
.readthedocs.yml Updated Sphinx configuration (#11165) 2019-04-11 14:38:52 -07:00
.travis.yml travis: use bionic as default for Linux (#16521) 2020-05-12 13:56:01 -07:00
CHANGELOG.md Merge branch 'releases/v0.14' into develop 2020-04-15 15:27:00 -07:00
COPYRIGHT tests: finish removing pyqver from the repository (#14294) 2019-12-24 17:37:03 -08:00
LICENSE-APACHE relicense: update COPYRIGHT, LICENSE-*, README, CONTRIBUTING, and NOTICE 2018-10-17 14:42:06 -07:00
LICENSE-MIT copyright: update copyright dates for 2020 (#14328) 2019-12-30 22:36:56 -08:00
NOTICE relicense: update COPYRIGHT, LICENSE-*, README, CONTRIBUTING, and NOTICE 2018-10-17 14:42:06 -07:00
pytest.ini Recover coverage from subprocesses during unit tests (#15354) 2020-03-05 16:54:29 -08:00
README.md Add unit test on MacOS using Github Actions (#14220) 2020-05-09 13:35:14 -07:00

Spack Spack

Build Status Linux Builds macOS Builds (nightly) codecov Read the Docs Slack

Spack is a multi-platform package manager that builds and installs multiple versions and configurations of software. It works on Linux, macOS, and many supercomputers. Spack is non-destructive: installing a new version of a package does not break existing installations, so many configurations of the same package can coexist.

Spack offers a simple "spec" syntax that allows users to specify versions and configuration options. Package files are written in pure Python, and specs allow package authors to write a single script for many different builds of the same package. With Spack, you can build your software all the ways you want to.

See the Feature Overview for examples and highlights.

To install spack and your first package, make sure you have Python. Then:

$ git clone https://github.com/spack/spack.git
$ cd spack/bin
$ ./spack install zlib

Documentation

Full documentation is available, or run spack help or spack help --all.

Tutorial

We maintain a hands-on tutorial. It covers basic to advanced usage, packaging, developer features, and large HPC deployments. You can do all of the exercises on your own laptop using a Docker container.

Feel free to use these materials to teach users at your organization about Spack.

Community

Spack is an open source project. Questions, discussion, and contributions are welcome. Contributions can be anything from new packages to bugfixes, documentation, or even new core features.

Resources:

Contributing

Contributing to Spack is relatively easy. Just send us a pull request. When you send your request, make develop the destination branch on the Spack repository.

Your PR must pass Spack's unit tests and documentation tests, and must be PEP 8 compliant. We enforce these guidelines with Travis CI. To run these tests locally, and for helpful tips on git, see our Contribution Guide.

Spack uses a rough approximation of the Git Flow branching model. The develop branch contains the latest contributions, and master is always tagged and points to the latest stable release.

Code of Conduct

Please note that Spack has a Code of Conduct. By participating in the Spack community, you agree to abide by its rules.

Authors

Many thanks go to Spack's contributors.

Spack was created by Todd Gamblin, tgamblin@llnl.gov.

Citing Spack

If you are referencing Spack in a publication, please cite the following paper:

License

Spack is distributed under the terms of both the MIT license and the Apache License (Version 2.0). Users may choose either license, at their option.

All new contributions must be made under both the MIT and Apache-2.0 licenses.

See LICENSE-MIT, LICENSE-APACHE, COPYRIGHT, and NOTICE for details.

SPDX-License-Identifier: (Apache-2.0 OR MIT)

LLNL-CODE-647188