Skip to content

docs: Add clarification on required Kafka version field in cloud_even…#6502

Merged
Sovietaced merged 1 commit into
flyteorg:masterfrom
daadc:patch-1
Jun 21, 2025
Merged

docs: Add clarification on required Kafka version field in cloud_even…#6502
Sovietaced merged 1 commit into
flyteorg:masterfrom
daadc:patch-1

Conversation

@daadc
Copy link
Copy Markdown
Contributor

@daadc daadc commented Jun 18, 2025

…ts configuration for FlyteAdmin

The current documentation for the FlyteAdmin cloudEvents Kafka configuration does not mention that the version field under the kafka block is required.

If this field is omitted, attempting to start FlyteAdmin with Kafka cloud events enabled leads to a panic error with the message "caught panic: invalid version".

An example of a minimal valid configuration is as follows:

cloudEvents:
  enable: true
  kafka:
    brokers: 127.0.0.1:9092
    version: my-kafka-version
  eventsPublisher:
    eventTypes:
      - all
    topicName: myTopic
  type: kafka

This change aims to help users avoid runtime errors and improve the ease of adoption for this feature.

Tracking issue

Why are the changes needed?

What changes were proposed in this pull request?

How was this patch tested?

Labels

Please add one or more of the following labels to categorize your PR:

  • added: For new features.
  • changed: For changes in existing functionality.
  • deprecated: For soon-to-be-removed features.
  • removed: For features being removed.
  • fixed: For any bug fixed.
  • security: In case of vulnerabilities

This is important to improve the readability of release notes.

Setup process

Screenshots

Check all the applicable boxes

  • I updated the documentation accordingly.
  • All new and existing tests passed.
  • All commits are signed-off.

Related PRs

Docs link

Summary by Bito

This pull request enhances the FlyteAdmin cloudEvents Kafka configuration documentation by clarifying that the 'version' field is required, which helps prevent runtime errors. An example of a minimal valid configuration is also included to assist users.

…ts configuration for FlyteAdmin

The current documentation for the FlyteAdmin cloudEvents Kafka configuration does not mention that the `version` field under the `kafka` block is required. 

If this field is omitted, attempting to start FlyteAdmin with Kafka cloud events enabled leads to a panic error with the message "caught panic: invalid version".

An example of a minimal valid configuration is as follows:
```
cloudEvents:
  enable: true
  kafka:
    brokers: 127.0.0.1:9092
    version: my-kafka-version
  eventsPublisher:
    eventTypes:
      - all
    topicName: myTopic
  type: kafka
```
This change aims to help users avoid runtime errors and improve the ease of adoption for this feature.



Signed-off-by: Daaa <[email protected]>
@daadc daadc requested a review from davidmirror-ops as a code owner June 18, 2025 04:09
@welcome
Copy link
Copy Markdown

welcome Bot commented Jun 18, 2025

Thank you for opening this pull request! 🙌

These tips will help get your PR across the finish line:

  • Most of the repos have a PR template; if not, fill it out to the best of your knowledge.
  • Sign off your commits (Reference: DCO Guide).

@codecov
Copy link
Copy Markdown

codecov Bot commented Jun 21, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 58.52%. Comparing base (9c536fb) to head (37bfe29).
Report is 1 commits behind head on master.

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #6502   +/-   ##
=======================================
  Coverage   58.52%   58.52%           
=======================================
  Files         940      940           
  Lines       71532    71532           
=======================================
+ Hits        41864    41865    +1     
+ Misses      26489    26488    -1     
  Partials     3179     3179           
Flag Coverage Δ
unittests-datacatalog 59.03% <ø> (ø)
unittests-flyteadmin 56.25% <ø> (ø)
unittests-flytecopilot 30.99% <ø> (ø)
unittests-flytectl 64.72% <ø> (ø)
unittests-flyteidl 76.12% <ø> (ø)
unittests-flyteplugins 61.08% <ø> (ø)
unittests-flytepropeller 54.83% <ø> (ø)
unittests-flytestdlib 64.04% <ø> (+0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@Sovietaced Sovietaced added the documentation Improvements or additions to documentation label Jun 21, 2025
@Sovietaced Sovietaced merged commit 2cd006a into flyteorg:master Jun 21, 2025
49 checks passed
@welcome
Copy link
Copy Markdown

welcome Bot commented Jun 21, 2025

Congrats on merging your first pull request! 🎉

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants