[Docs] Add a contributor guide for running Python on a local Flink cluster - #39580
[Docs] Add a contributor guide for running Python on a local Flink cluster#39580Eliaaazzz wants to merge 1 commit into
Conversation
…uster Covers getting a Flink distribution, cluster configuration and startup, running a pipeline with FlinkRunner and LOOPBACK, troubleshooting, and teardown. Linked from the contributor docs README.
|
Caution The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased. |
|
Assigning reviewers: R: @Abacn added as fallback since no labels match configuration Note: If you would like to opt out of this review, comment Available commands:
The PR bot will only process comments in the main thread (not review comments). |
bvolpato
left a comment
There was a problem hiding this comment.
LGTM. Small non-blocking wording note inline.
|
|
||
| ## What this setup validates | ||
|
|
||
| This setup runs three separate processes: |
There was a problem hiding this comment.
non-blocking: could call these three components rather than three separate processes? The standalone cluster already has separate JobManager and TaskManager processes, while LOOPBACK hosts user code in the submitting Python process by default.
Adds
contributor-docs/local-flink-python.md, a guide for running Beam Python pipelines against a local Flink standalone cluster: obtaining a Flink distribution, cluster configuration and startup, running a pipeline withFlinkRunnerand--environment_type=LOOPBACK, troubleshooting, and teardown. Linked from the contributor docs README.This is useful when embedded Flink is not enough, for example when validating unbounded source behaviour, checkpoint boundaries, or runner-visible job state in the Flink dashboard, since embedded mode starts a cluster only for the lifetime of one job.
Split out of #39212, which now carries only the Flink version reference updates on the runner page, so the two can be reviewed independently.
Thank you for your contribution! Follow this checklist to help us incorporate your contribution quickly and easily:
R: @username).addresses #123), if applicable. This will automatically add a link to the pull request in the issue. If you would like the issue to automatically close on merging the pull request, commentfixes #<ISSUE NUMBER>instead.CHANGES.mdwith noteworthy changes.See the Contributor Guide for more tips on how to make review process smoother.
To check the build health, please visit https://github.com/apache/beam/blob/master/.test-infra/BUILD_STATUS.md