[FLINK-36744] Document operator's FlinkVersion compatibility

• Type: Improvement
• Status: Open
• Priority: Minor
• Resolution: Unresolved
• Affects Version/s: kubernetes-operator-1.10.0
• Component/s: Kubernetes Operator
• Assignee: Unassigned
• Reporter: Dylan Meissner
• Created: 18/Nov/24 17:09
• Updated: 18/Nov/24 17:10

Description

Starting with Flink Kubernetes Operator 1.7, the operator supports only the last 4 Flink minor versions corresponding to the date of the operator release.

This compatibility notice is hard to discover, and the mapping of versions to release dates is challenging for casual users and even platform teams to perform.

The deprecation information does exist in source code: https://github.com/apache/flink-kubernetes-operator/blob/release-1.10/flink-kubernetes-operator-api/src/main/java/org/apache/flink/kubernetes/operator/api/spec/FlinkVersion.java#L25

However, for best usability we should publish the last-four-versions policy and a history of versions in the operator's Compatibility Guarantees documentation: https://nightlies.apache.org/flink/flink-kubernetes-operator-docs-main/docs/operations/compatibility/