Skip to content

Commit b6a3948

Browse files
bentshermanchristopher-hakkaart
authored andcommitted
Update task hash documentation (#6697) [ci fast]
Co-authored-by: Chris Hakkaart <[email protected]>
1 parent 35aa5a1 commit b6a3948

File tree

1 file changed

+4
-7
lines changed

1 file changed

+4
-7
lines changed

docs/cache-and-resume.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -25,21 +25,18 @@ The task hash is computed from the following metadata:
2525
- Task {ref}`Conda environment <process-conda>` (if applicable)
2626
- Task {ref}`Spack environment <process-spack>` and {ref}`CPU architecture <process-arch>` (if applicable)
2727
- Task {ref}`inputs <process-input>`
28+
- *New in 25.10:* Task {ref}`eval commands <process-out-eval>`
2829
- Task {ref}`script <process-script>`
29-
- Any global variables referenced in the task script
30-
- Any task {ref}`process-ext` properties referenced in the task script
30+
- Global variables referenced in the task script
31+
- *New in 23.10:* Task {ref}`process-ext` properties referenced in the task script
3132
- Any {ref}`bundled scripts <bundling-executables>` used in the task script
3233
- Whether the task is a {ref}`stub run <process-stub>`
3334

3435
:::{note}
3536
Nextflow also includes an incrementing component in the hash generation process, which allows it to iterate through multiple hash values until it finds one that does not match an existing execution directory. This mechanism typically aligns with task retries (i.e., task attempts), however this is not guaranteed.
3637
:::
3738

38-
:::{versionchanged} 23.09.2-edge
39-
The {ref}`process-ext` directive was added to the task hash.
40-
:::
41-
42-
Nextflow computes this hash for every task when it is created but before it is executed. If resumability is enabled and there is an entry in the task cache with the same hash, Nextflow tries to recover the previous task execution. A cache hit does not guarantee that the task will be resumed, because it must also recover the task outputs from the [work directory](#work-directory).
39+
Nextflow computes this hash for every task before it is executed. If resumability is enabled, Nextflow checks whether the task cache contains a matching hash and whether the task outputs are still present in the [work directory](#work-directory). If both conditions are met, the task is resumed; otherwise, it is re-executed.
4340

4441
Files are hashed differently depending on the caching mode. See the {ref}`process-cache` directive for more details.
4542

0 commit comments

Comments
 (0)