[
https://issues.apache.org/jira/browse/FLINK-21666?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Flink Jira Bot updated FLINK-21666:
-----------------------------------
Labels: stale-major (was: )
I am the [Flink Jira Bot|https://github.com/apache/flink-jira-bot/] and I help
the community manage its development. I see this issues has been marked as
Major but is unassigned and neither itself nor its Sub-Tasks have been updated
for 30 days. I have gone ahead and added a "stale-major" to the issue". If this
ticket is a Major, please either assign yourself or give an update. Afterwards,
please remove the label or in 7 days the issue will be deprioritized.
> Consistent documentation and recommendations regarding Stop vs Cancel with
> savepoint
> ------------------------------------------------------------------------------------
>
> Key: FLINK-21666
> URL: https://issues.apache.org/jira/browse/FLINK-21666
> Project: Flink
> Issue Type: Improvement
> Components: Client / Job Submission, Documentation, Runtime / REST
> Affects Versions: 1.11.0, 1.11.1, 1.11.2, 1.11.3, 1.12.0, 1.12.1, 1.12.2
> Reporter: Thomas Eckestad
> Priority: Major
> Labels: stale-major
>
> *Background*
> Cancel with savepoint is marked as deprecated in the cli-documentation.
> Cancel with savepoint is not marked as deprecated in the REST-API
> documentation.
> The documentation explaining why stop should be preferred over cancel with
> savepoint could be improved for the CLI-case and is non existent for the REST
> case.
> *Actions needed*
> * Make it clear what the semantics of cancel with savepoint and stop with
> savepoint are.
> ** I think that the documentation in
> [https://ci.apache.org/projects/flink/flink-docs-stable/deployment/cli.html]
> for Stop is a good start but could be further improved. Especially to mention
> that no new data will be processed by the sources after the stop is initiated.
> ** For Cancel, the documentation on the same page as above is really sparse.
> In exactly what way is a job terminated ungracefully when using Cancel with
> savepoint?
> * If there are no valid use cases when anyone could benefit from using
> cancel with savepoint, document/deprecate to make it less likely that cancel
> with savepoint will be used by mistake instead of stop.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
