Document and use the correct parallel build count envvars
Metadata
Current evaluation
Parallel-build documentation moved to canonical/craft-application#540; #4537 was closed without completing the requested Snapcraft documentation, as the maintainer later noted.
Resolution: closed superseded
Reason: Maintainer mr-cal stated on 2024-10-21 that Snapcraft documentation was not added and that the remaining work was now tracked in canonical/craft-application#540. No resolving Snapcraft PR or commit for the incomplete documentation was identified.
Evaluated by: mr-cal-bot
No scores available.
Issue body
### What needs to get done
- fix the documentation
- create the following logic:
1. Snapcraft should use `SNAPCRAFT_PARALLEL_BUILD_COUNT`.
2. If it is not set, use `CRAFT_PARALLEL_BUILD_COUNT`
3. If it is not set, take the lesser of `SNAPCRAFT_MAX_PARALLEL_BUILD_COUNT` and the total number of CPUs on the system.
- If `SNAPCRAFT_MAX_PARALLEL_BUILD_COUNT` is not set, then use `CRAFT_MAX_PARALLEL_BUILD_COUNT`
4. If neither `MAX` envvars are set and the number of CPUs on the system cannot be determined, default to 1.
### Why it needs to get done
1. Documentation is incomplete and unclear
2. `CRAFT_PARALLEL_BUILD_COUNT` is not being read by any craft-parts
4. `SNAPCRAFT_PARALLEL_BUILD_COUNT` is not being read for core22 and onwards
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed superseded | Parallel-build documentation moved to canonical/craft-application#540; #4537 was closed without completing the requested Snapcraft documentation, as the maintainer later noted. | |
| stealth/space-bunny-alpha | — | closed stale | Closed without the requested documentation or environment-variable logic; documentation was moved to canonical/craft-application#540. | |
| qwen/qwen3.6-35b-a3b | — | — | Closed without implementation. Documentation and environment variable logic updates were deferred and are now tracked in craft-application issue 540. The requested code changes remain unaddressed. | |
| qwen/qwen3.6-35b-a3b | — | — | Superseded and closed without implementation or documentation. The maintainer noted the documentation requirement is now tracked separately in craft-application#540. | |
| qwen/qwen3.6-35b-a3b | — | — | Closed without implementation or documentation updates. Superseded, with documentation tracking moved to a separate issue. Code changes for parallel build environment variables remain unaddressed. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Closed without implementation. Documentation tracking moved to craft-application issue #540. Superseded. |
Update history
No update history recorded yet.
Related work
-
Superseded By:
canonical/craft-application#540
(confidence 98%)
The maintainer explicitly linked this issue as the new tracker for the outstanding documentation work.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #180 Support setting a parallel build count | craft-application | closed | Parallel build-count controls landed in canonical/craft-application#191 via commit 35b49c8f, adding app/CRAFT fixed settings and CPU-capped maximum settings. | |
| #540 Document parallel build count environment variables | craft-application | open | Documentation request to define and explain CRAFT_PARALLEL_BUILD_COUNT and CRAFT_MAX_PARALLEL_BUILD_COUNT; docs/reference/environment-variables.rst still omits them while util/system.py defines precedence. | |
| #631 Read `CRAFT_PARALLEL_BUILD_COUNT` | craft-parts | closed | Closed without code changes after parallel build-count configuration was moved upstream; craft-parts no longer needed to read CRAFT_PARALLEL_BUILD_COUNT. |