Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[FLINK-35357][docs] Add kubernetes.operator.plugins.listeners config #845

Merged
merged 3 commits into from
Jul 4, 2024

Conversation

xinzhuxiansheng
Copy link
Contributor

What is the purpose of the change

Brief change log

1.Edit docs/layouts/shortcodes/generated/dynamic_section.html
2.Add kubernetes.operator.plugins.listeners config

Verifying this change

Does this pull request potentially affect one of the following parts:

  • Dependencies (does it add or upgrade a dependency): (yes / no) no
  • The public API, i.e., is any changes to the CustomResourceDescriptors: (yes / no) no
  • Core observer or reconciler logic that is regularly executed: (yes / no) no

Documentation

  • Does this pull request introduce a new feature? (yes / no) no
  • If yes, how is the feature documented? (not applicable / docs / JavaDocs / not documented)

@1996fanrui 1996fanrui self-assigned this Jun 28, 2024
@1996fanrui 1996fanrui self-requested a review June 28, 2024 06:38
@@ -182,5 +182,11 @@
<td>Map</td>
<td>Custom HTTP header for HttpArtifactFetcher. The header will be applied when getting the session job artifacts. Expected format: headerKey1:headerValue1,headerKey2:headerValue2.</td>
</tr>
<tr>
<td><h5>kubernetes.operator.plugins.listeners.<listener-name>.class</h5></td>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, these html files are generated instead of changing manually.

As I understand, you need to update the KubernetesOperatorConfigOptions and run mvn clean install -DskipTests -Pgenerate-docs.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for your advice. It seems I have some misconceptions about its construction. I will fix it。

@@ -333,6 +333,14 @@ public static String operatorConfigKey(String key) {
+ "WARNING: not intended to be used together with the cron-based "
+ "periodic checkpoint triggering");

@Documentation.Section(SECTION_DYNAMIC)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
@Documentation.Section(SECTION_DYNAMIC)
@SuppressWarnings("unused")
@Documentation.Section(SECTION_DYNAMIC)

Adding the @SuppressWarnings("unused") to avoid warning.

public static final ConfigOption<String> PLUGINS_LISTENERS_CLASS =
operatorConfig("plugins.listeners.<listener-name>.class")
.stringType()
.defaultValue("")
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
.defaultValue("")
.noDefaultValue()

@xinzhuxiansheng
Copy link
Contributor Author

hi @1996fanrui . Thank you very much for your advice, I have optimized it

Copy link
Member

@1996fanrui 1996fanrui left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the update!

LGTM, I will merge it if no objections within 2 days.

@1996fanrui 1996fanrui merged commit ffaa3dd into apache:main Jul 4, 2024
169 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants