Document task cancellation latency in CLOUD_DEPLOYMENT.md (task-cancellation 8.1)
This commit is contained in:
@@ -540,6 +540,14 @@ device workflows to tolerate repeated actions when the target operation allows
|
|||||||
it. Do not use this release for operations that require a transactional
|
it. Do not use this release for operations that require a transactional
|
||||||
exactly-once guarantee across the cloud database and an external device.
|
exactly-once guarantee across the cloud database and an external device.
|
||||||
|
|
||||||
|
Task cancellation is collaborative, not instantaneous, for tasks that have
|
||||||
|
already left the queue. Cancelling a `queued` task takes effect immediately.
|
||||||
|
Cancelling an `assigned`/`dispatched` task only records the request; the
|
||||||
|
owning Host Agent learns about it at its next lease renewal (at most roughly
|
||||||
|
one third of `lease_duration_seconds`, the same interval used for lease-loss
|
||||||
|
detection) and then stops at the next cooperative checkpoint. As with lease
|
||||||
|
loss, an action already sent to a device cannot be rolled back mid-flight.
|
||||||
|
|
||||||
## Shutdown And Rollback
|
## Shutdown And Rollback
|
||||||
|
|
||||||
For a normal shutdown, stop Host Agents first so they stop polling, interrupt
|
For a normal shutdown, stop Host Agents first so they stop polling, interrupt
|
||||||
|
|||||||
@@ -59,7 +59,7 @@
|
|||||||
|
|
||||||
## 8. Docs
|
## 8. Docs
|
||||||
|
|
||||||
- [ ] 8.1 Add a short section to `docs/CLOUD_DEPLOYMENT.md` documenting that cancellation is collaborative (not instantaneous) for `assigned`/`dispatched` tasks, bounded by roughly one third of the configured lease duration, with immediate effect for `queued` tasks.
|
- [x] 8.1 Add a short section to `docs/CLOUD_DEPLOYMENT.md` documenting that cancellation is collaborative (not instantaneous) for `assigned`/`dispatched` tasks, bounded by roughly one third of the configured lease duration, with immediate effect for `queued` tasks.
|
||||||
|
|
||||||
## 9. End-to-end verification
|
## 9. End-to-end verification
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user