2023-09-02 22:48:05 +02:00
|
|
|
---
|
|
|
|
|
slug: /experiments/gentle-force/
|
|
|
|
|
---
|
|
|
|
|
|
2023-12-29 22:24:23 +02:00
|
|
|
# Gentle Force (#1200)
|
2023-09-02 22:48:05 +02:00
|
|
|
|
2023-12-29 22:24:23 +02:00
|
|
|
:::caution
|
|
|
|
|
|
|
|
|
|
All experimental features are subject to breaking changes and/or removal _at any
|
|
|
|
|
time_. We strongly recommend that you do not use these features in a production
|
|
|
|
|
environment. They are intended for testing and feedback only.
|
|
|
|
|
|
|
|
|
|
:::
|
|
|
|
|
|
|
|
|
|
:::warning
|
|
|
|
|
|
|
|
|
|
This experiment breaks the following functionality:
|
|
|
|
|
|
|
|
|
|
- The `--force` flag
|
|
|
|
|
|
|
|
|
|
:::
|
|
|
|
|
|
|
|
|
|
:::info
|
|
|
|
|
|
2024-03-11 12:34:58 +02:00
|
|
|
To enable this experiment, set the environment variable:
|
|
|
|
|
`TASK_X_GENTLE_FORCE=1`. Check out [our guide to enabling experiments
|
|
|
|
|
][enabling-experiments] for more information.
|
2023-12-29 22:24:23 +02:00
|
|
|
|
|
|
|
|
:::
|
2023-09-02 22:48:05 +02:00
|
|
|
|
|
|
|
|
The `--force` flag currently forces _all_ tasks to run regardless of the status
|
|
|
|
|
checks. This can be useful, but we have found that most of the time users only
|
|
|
|
|
expect the direct task they are calling to be forced and _not_ all of its
|
|
|
|
|
dependant tasks.
|
|
|
|
|
|
|
|
|
|
This experiment changes the `--force` flag to only force the directly called
|
|
|
|
|
task. All dependant tasks will have their statuses checked as normal and will
|
|
|
|
|
only run if Task considers them to be out of date. A new `--force-all` flag will
|
|
|
|
|
also be added to maintain the current behavior for users that need this
|
|
|
|
|
functionality.
|
|
|
|
|
|
|
|
|
|
If you want to migrate, but continue to force all dependant tasks to run, you
|
|
|
|
|
should replace all uses of the `--force` flag with `--force-all`. Alternatively,
|
|
|
|
|
if you want to adopt the new behavior, you can continue to use the `--force`
|
|
|
|
|
flag as you do now!
|
2023-12-29 22:24:23 +02:00
|
|
|
|
|
|
|
|
<!-- prettier-ignore-start -->
|
|
|
|
|
[enabling-experiments]: /experiments/#enabling-experiments
|
|
|
|
|
<!-- prettier-ignore-end -->
|
