Skip to content

Add Helm Chart Development Guide#66659

Draft
bugraoz93 wants to merge 1 commit intoapache:mainfrom
bugraoz93:add-chart-development-guide
Draft

Add Helm Chart Development Guide#66659
bugraoz93 wants to merge 1 commit intoapache:mainfrom
bugraoz93:add-chart-development-guide

Conversation

@bugraoz93
Copy link
Copy Markdown
Contributor


Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

  • Read the Pull Request Guidelines for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
  • For fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
  • When adding dependency, check compliance with the ASF 3rd Party License Policy.
  • For significant user-facing changes create newsfragment: {pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.

@bugraoz93 bugraoz93 changed the title [WIP] Add Helm Chart Development Guide Add Helm Chart Development Guide May 10, 2026
@bugraoz93
Copy link
Copy Markdown
Contributor Author

Please don't merge until Lazy Consensus has been reached. Keeping in Draft.

@bugraoz93
Copy link
Copy Markdown
Contributor Author

cc: @Miretpl and @wolfdn

Comment on lines +23 to +25
it. It is the contributor-facing guide for chart development; the full
alignment narrative lives on Confluence (`Helm Refurbish
<https://cwiki.apache.org/confluence/display/AIRFLOW/Helm+Refurbish>`__).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I would assume the document in Confluence is kind of "transitional" and after the project is completed we might move this to Archived/Compled AIP side? Not sure if we should reference here in the code as this is a longer staying artifact?

How about:

Suggested change
it. It is the contributor-facing guide for chart development; the full
alignment narrative lives on Confluence (`Helm Refurbish
<https://cwiki.apache.org/confluence/display/AIRFLOW/Helm+Refurbish>`__).
it. It is the contributor-facing guide for chart development; while the
chart is in active rework please take a look to the full
alignment narrative lives on Confluence (`Helm Refurbish
<https://cwiki.apache.org/confluence/display/AIRFLOW/Helm+Refurbish>`__).

Decision tree
-------------

Start here when adding or modifying a chart parameter or component.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Have you considered making this a flowchart visually in MarkDown e.g. via https://asciiflow.com/#/ ?

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

https://mermaid.js.org/ could be also a good option for visualizing this flowchart in Markdown.

-------------------

Where each component currently lives. Use this when adding parameters or
templates that touch a specific component.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Should this add that the list is the target state and currently migration is WIP?

- Service only; PgBouncer ingress is not part of the chart.
* - Jobs
- Chart
- Lives under the kubernetes section.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I think this is not 100% true for all jobs. The CreateUser Job for example is independent of K8s Executor.

I think we discussed about this only for K8s Executor specific Jobs.

- Lives under the kubernetes section.
* - OpenTelemetry
- Chart
- Default telemetry path.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Wording

Suggested change
- Default telemetry path.
- OTel is the designated primary telemetry path and is to be supported by the chart.

Copy link
Copy Markdown
Contributor

@jscheffl jscheffl left a comment

Choose a reason for hiding this comment

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

Some wording not, otherwise great!

@bugraoz93 bugraoz93 mentioned this pull request May 10, 2026
36 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants