Skip to content

Docs: Expand Helm Chart upgrade tasks in Airflow 3 migration guide#66118

Merged
jscheffl merged 2 commits into
apache:mainfrom
andreahlert:issue-57519-helm-migration
May 2, 2026
Merged

Docs: Expand Helm Chart upgrade tasks in Airflow 3 migration guide#66118
jscheffl merged 2 commits into
apache:mainfrom
andreahlert:issue-57519-helm-migration

Conversation

@andreahlert

@andreahlert andreahlert commented Apr 29, 2026

Copy link
Copy Markdown
Contributor

Replaces the two-line note about the Airflow Helm Chart in the Airflow 3 migration guide with a dedicated, action-focused subsection so users running the official chart get a concrete checklist when upgrading from Airflow 2.x to 3.x.

The previous text only mentioned renaming webserver to apiServer in values.yaml. The new subsection covers the full set of breaking changes that landed across chart 1.16.0..1.18.0:

  • Bumping defaultAirflowTag / airflowVersion to a 3.x release.
  • Renaming webserver to apiServer (with a values.yaml before/after example), including the new port 8080 and the airflow api-server startup command.
  • Moving [webserver] secret_key to [api] secret_key.
  • The new jwtSecretName and required jwt-secret Secret key for short-lived JWT auth between workers/triggerers and the API server.
  • The standalone dagProcessor Deployment and the RBAC / Dag bundle access it needs.
  • FabAuthManager becoming the default config.core.auth_manager and how to override it.
  • Reworking webserver_config.py and Flask-AppBuilder plugins under apiServer: plus installing the FAB provider.
  • Minimum Kubernetes 1.30 from chart 1.17.0.
  • Running database migrations as part of helm upgrade.
  • Diffing values.yaml against the chart's defaults and the chart release notes for renamed/removed keys.

Adds a _helm-chart-upgrade: label so the section can be cross-referenced from other docs, and links the chart release notes via the existing helm-chart: intersphinx mapping.

closes: #57519

Was generative AI tooling used to co-author this PR?
  • Yes

@andreahlert
Docs: Expand Helm Chart upgrade tasks in Airflow 3 migration guide
80a1cc8 
Replace the two-line Helm Chart note in the Airflow 3 migration guide
with a dedicated subsection that lists the concrete action items for
upgrading the official chart from Airflow 2.x to 3.x: webserver to
apiServer rename with a values.yaml before/after, secret_key relocation,
jwtSecretName, the standalone dagProcessor deployment, FabAuthManager
default, webserver_config.py rework, minimum Kubernetes 1.30, the DB
migration job, and a pointer to the chart release notes for renamed and
removed keys.

Signed-off-by: André Ahlert <andre@aex.partners>
@Miretpl

Miretpl commented May 1, 2026

Copy link
Copy Markdown
Contributor

Hi @andreahlert, I believe that this doc should be placed under Helm Chart-related docs chart/docs dir instead of core. Could you move it?

@andreahlert
Move Helm Chart upgrade tasks to chart/docs
8ba3f62 
Address review from @Miretpl: chart-specific upgrade content belongs
under chart/docs, mirroring the providers/fab/docs/upgrading.rst pattern
where each component owns its upgrade guide and the core migration guide
links to it.

Move the expanded Helm Chart upgrade checklist from
airflow-core/docs/installation/upgrading_to_airflow3.rst to a new
chart/docs/upgrading-to-airflow-3.rst, restore the original two-line
note in the core guide, and add a pointer to the chart doc from the
core guide. Register the new file in chart/docs/index.rst under Guides.

Signed-off-by: André Ahlert <andre@aex.partners>
@andreahlert

andreahlert commented May 2, 2026

Copy link
Copy Markdown
Contributor Author

Hi @andreahlert, I believe that this doc should be placed under Helm Chart-related docs chart/docs dir instead of core. Could you move it?

Hey @Miretpl! Thanks... Moved the expanded checklist to a new chart/docs/upgrading-to-airflow-3.rst and kept just a short pointer in the core migration guide, think it is useful, mirroring how providers/fab/docs/upgrading.rst is structured.

@jscheffl jscheffl added this to the Airflow Helm Chart 1.22.0 milestone May 2, 2026
@jscheffl jscheffl added backport-to-v3-2-test backport-to-chart/v1-2x-test Automatic backport to chart 1.2x maintenance branch labels May 2, 2026
@jscheffl jscheffl merged commit 8fc2467 into apache:main May 2, 2026
96 checks passed
@github-actions

github-actions Bot commented May 2, 2026

Copy link
Copy Markdown
Contributor

Backport successfully created: v3-2-test

Note: As of Merging PRs targeted for Airflow 3.X
the committer who merges the PR is responsible for backporting the PRs that are bug fixes (generally speaking) to the maintenance branches.

In matter of doubt please ask in #release-management Slack channel.

Status Branch Result
✅ v3-2-test PR Link

@github-actions

github-actions Bot commented May 2, 2026

Copy link
Copy Markdown
Contributor

Backport successfully created: chart/v1-2x-test

Note: As of Merging PRs targeted for Airflow 3.X
the committer who merges the PR is responsible for backporting the PRs that are bug fixes (generally speaking) to the maintenance branches.

In matter of doubt please ask in #release-management Slack channel.

Status Branch Result
✅ chart/v1-2x-test PR Link

jscheffl pushed a commit that referenced this pull request May 2, 2026
@github-actions @andreahlert
[chart/v1-2x-test] Docs: Expand Helm Chart upgrade tasks in Airflow 3…
1f0165e 
… migration guide (#66118) (#66260)

* Docs: Expand Helm Chart upgrade tasks in Airflow 3 migration guide

Replace the two-line Helm Chart note in the Airflow 3 migration guide
with a dedicated subsection that lists the concrete action items for
upgrading the official chart from Airflow 2.x to 3.x: webserver to
apiServer rename with a values.yaml before/after, secret_key relocation,
jwtSecretName, the standalone dagProcessor deployment, FabAuthManager
default, webserver_config.py rework, minimum Kubernetes 1.30, the DB
migration job, and a pointer to the chart release notes for renamed and
removed keys.



* Move Helm Chart upgrade tasks to chart/docs

Address review from @Miretpl: chart-specific upgrade content belongs
under chart/docs, mirroring the providers/fab/docs/upgrading.rst pattern
where each component owns its upgrade guide and the core migration guide
links to it.

Move the expanded Helm Chart upgrade checklist from
airflow-core/docs/installation/upgrading_to_airflow3.rst to a new
chart/docs/upgrading-to-airflow-3.rst, restore the original two-line
note in the core guide, and add a pointer to the chart doc from the
core guide. Register the new file in chart/docs/index.rst under Guides.



---------
(cherry picked from commit 8fc2467)

Signed-off-by: André Ahlert <andre@aex.partners>
Co-authored-by: André Ahlert <andre@aex.partners>
github-actions Bot pushed a commit to aws-mwaa/upstream-to-airflow that referenced this pull request May 2, 2026
@andreahlert
[v3-2-test] Docs: Expand Helm Chart upgrade tasks in Airflow 3 migrat…
a2573e6 
…ion guide (apache#66118)

* Docs: Expand Helm Chart upgrade tasks in Airflow 3 migration guide

Replace the two-line Helm Chart note in the Airflow 3 migration guide
with a dedicated subsection that lists the concrete action items for
upgrading the official chart from Airflow 2.x to 3.x: webserver to
apiServer rename with a values.yaml before/after, secret_key relocation,
jwtSecretName, the standalone dagProcessor deployment, FabAuthManager
default, webserver_config.py rework, minimum Kubernetes 1.30, the DB
migration job, and a pointer to the chart release notes for renamed and
removed keys.

Signed-off-by: André Ahlert <andre@aex.partners>

* Move Helm Chart upgrade tasks to chart/docs

Address review from @Miretpl: chart-specific upgrade content belongs
under chart/docs, mirroring the providers/fab/docs/upgrading.rst pattern
where each component owns its upgrade guide and the core migration guide
links to it.

Move the expanded Helm Chart upgrade checklist from
airflow-core/docs/installation/upgrading_to_airflow3.rst to a new
chart/docs/upgrading-to-airflow-3.rst, restore the original two-line
note in the core guide, and add a pointer to the chart doc from the
core guide. Register the new file in chart/docs/index.rst under Guides.

Signed-off-by: André Ahlert <andre@aex.partners>

---------
(cherry picked from commit 8fc2467)

Co-authored-by: André Ahlert <andre@aex.partners>
Signed-off-by: André Ahlert <andre@aex.partners>
aws-airflow-bot pushed a commit to aws-mwaa/upstream-to-airflow that referenced this pull request May 2, 2026
@andreahlert
[v3-2-test] Docs: Expand Helm Chart upgrade tasks in Airflow 3 migrat…
58d74f2 
…ion guide (apache#66118)

* Docs: Expand Helm Chart upgrade tasks in Airflow 3 migration guide

Replace the two-line Helm Chart note in the Airflow 3 migration guide
with a dedicated subsection that lists the concrete action items for
upgrading the official chart from Airflow 2.x to 3.x: webserver to
apiServer rename with a values.yaml before/after, secret_key relocation,
jwtSecretName, the standalone dagProcessor deployment, FabAuthManager
default, webserver_config.py rework, minimum Kubernetes 1.30, the DB
migration job, and a pointer to the chart release notes for renamed and
removed keys.

Signed-off-by: André Ahlert <andre@aex.partners>

* Move Helm Chart upgrade tasks to chart/docs

Address review from @Miretpl: chart-specific upgrade content belongs
under chart/docs, mirroring the providers/fab/docs/upgrading.rst pattern
where each component owns its upgrade guide and the core migration guide
links to it.

Move the expanded Helm Chart upgrade checklist from
airflow-core/docs/installation/upgrading_to_airflow3.rst to a new
chart/docs/upgrading-to-airflow-3.rst, restore the original two-line
note in the core guide, and add a pointer to the chart doc from the
core guide. Register the new file in chart/docs/index.rst under Guides.

Signed-off-by: André Ahlert <andre@aex.partners>

---------
(cherry picked from commit 8fc2467)

Co-authored-by: André Ahlert <andre@aex.partners>
Signed-off-by: André Ahlert <andre@aex.partners>
jscheffl pushed a commit that referenced this pull request May 2, 2026
@andreahlert @jscheffl
[v3-2-test] Docs: Expand Helm Chart upgrade tasks in Airflow 3 migrat…
7bfdd72 
…ion guide (#66118)

* Docs: Expand Helm Chart upgrade tasks in Airflow 3 migration guide

Replace the two-line Helm Chart note in the Airflow 3 migration guide
with a dedicated subsection that lists the concrete action items for
upgrading the official chart from Airflow 2.x to 3.x: webserver to
apiServer rename with a values.yaml before/after, secret_key relocation,
jwtSecretName, the standalone dagProcessor deployment, FabAuthManager
default, webserver_config.py rework, minimum Kubernetes 1.30, the DB
migration job, and a pointer to the chart release notes for renamed and
removed keys.

Signed-off-by: André Ahlert <andre@aex.partners>

* Move Helm Chart upgrade tasks to chart/docs

Address review from @Miretpl: chart-specific upgrade content belongs
under chart/docs, mirroring the providers/fab/docs/upgrading.rst pattern
where each component owns its upgrade guide and the core migration guide
links to it.

Move the expanded Helm Chart upgrade checklist from
airflow-core/docs/installation/upgrading_to_airflow3.rst to a new
chart/docs/upgrading-to-airflow-3.rst, restore the original two-line
note in the core guide, and add a pointer to the chart doc from the
core guide. Register the new file in chart/docs/index.rst under Guides.

Signed-off-by: André Ahlert <andre@aex.partners>

---------
(cherry picked from commit 8fc2467)

Co-authored-by: André Ahlert <andre@aex.partners>
Signed-off-by: André Ahlert <andre@aex.partners>
jscheffl added a commit that referenced this pull request May 2, 2026
@github-actions @andreahlert @jscheffl
[v3-2-test] Docs: Expand Helm Chart upgrade tasks in Airflow 3 migrat…
032a891 
…ion guide (#66118) (#66259)

* [v3-2-test] Docs: Expand Helm Chart upgrade tasks in Airflow 3 migration guide (#66118)

* Docs: Expand Helm Chart upgrade tasks in Airflow 3 migration guide

Replace the two-line Helm Chart note in the Airflow 3 migration guide
with a dedicated subsection that lists the concrete action items for
upgrading the official chart from Airflow 2.x to 3.x: webserver to
apiServer rename with a values.yaml before/after, secret_key relocation,
jwtSecretName, the standalone dagProcessor deployment, FabAuthManager
default, webserver_config.py rework, minimum Kubernetes 1.30, the DB
migration job, and a pointer to the chart release notes for renamed and
removed keys.

Signed-off-by: André Ahlert <andre@aex.partners>

* Move Helm Chart upgrade tasks to chart/docs

Address review from @Miretpl: chart-specific upgrade content belongs
under chart/docs, mirroring the providers/fab/docs/upgrading.rst pattern
where each component owns its upgrade guide and the core migration guide
links to it.

Move the expanded Helm Chart upgrade checklist from
airflow-core/docs/installation/upgrading_to_airflow3.rst to a new
chart/docs/upgrading-to-airflow-3.rst, restore the original two-line
note in the core guide, and add a pointer to the chart doc from the
core guide. Register the new file in chart/docs/index.rst under Guides.

Signed-off-by: André Ahlert <andre@aex.partners>

---------
(cherry picked from commit 8fc2467)

Co-authored-by: André Ahlert <andre@aex.partners>
Signed-off-by: André Ahlert <andre@aex.partners>

* Upgrade uv.lock

---------

Signed-off-by: André Ahlert <andre@aex.partners>
Co-authored-by: André Ahlert <andre@aex.partners>
Co-authored-by: Jens Scheffler <jscheffl@apache.org>
vatsrahul1001 pushed a commit that referenced this pull request May 20, 2026
@github-actions @andreahlert
@jscheffl @vatsrahul1001
[v3-2-test] Docs: Expand Helm Chart upgrade tasks in Airflow 3 migrat…
5577972 
…ion guide (#66118) (#66259)

* [v3-2-test] Docs: Expand Helm Chart upgrade tasks in Airflow 3 migration guide (#66118)

* Docs: Expand Helm Chart upgrade tasks in Airflow 3 migration guide

Replace the two-line Helm Chart note in the Airflow 3 migration guide
with a dedicated subsection that lists the concrete action items for
upgrading the official chart from Airflow 2.x to 3.x: webserver to
apiServer rename with a values.yaml before/after, secret_key relocation,
jwtSecretName, the standalone dagProcessor deployment, FabAuthManager
default, webserver_config.py rework, minimum Kubernetes 1.30, the DB
migration job, and a pointer to the chart release notes for renamed and
removed keys.

Signed-off-by: André Ahlert <andre@aex.partners>

* Move Helm Chart upgrade tasks to chart/docs

Address review from @Miretpl: chart-specific upgrade content belongs
under chart/docs, mirroring the providers/fab/docs/upgrading.rst pattern
where each component owns its upgrade guide and the core migration guide
links to it.

Move the expanded Helm Chart upgrade checklist from
airflow-core/docs/installation/upgrading_to_airflow3.rst to a new
chart/docs/upgrading-to-airflow-3.rst, restore the original two-line
note in the core guide, and add a pointer to the chart doc from the
core guide. Register the new file in chart/docs/index.rst under Guides.

Signed-off-by: André Ahlert <andre@aex.partners>

---------
(cherry picked from commit 8fc2467)

Co-authored-by: André Ahlert <andre@aex.partners>
Signed-off-by: André Ahlert <andre@aex.partners>

* Upgrade uv.lock

---------

Signed-off-by: André Ahlert <andre@aex.partners>
Co-authored-by: André Ahlert <andre@aex.partners>
Co-authored-by: Jens Scheffler <jscheffl@apache.org>
@potiuk potiuk mentioned this pull request Jun 1, 2026
Closed
29 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@jscheffl jscheffl jscheffl approved these changes
@jedcunningham jedcunningham Awaiting requested review from jedcunningham jedcunningham is a code owner
@hussein-awala hussein-awala Awaiting requested review from hussein-awala hussein-awala is a code owner
@bugraoz93 bugraoz93 Awaiting requested review from bugraoz93 bugraoz93 is a code owner

Assignees

No one assigned

Labels

backport-to-chart/v1-2x-test Automatic backport to chart 1.2x maintenance branch kind:documentation

Projects

None yet

Milestone

Airflow Helm Chart 1.22.0

Development

Successfully merging this pull request may close these issues.

Add Helm Chart tasks to migration guide for Airflow 3.0

3 participants

@andreahlert @Miretpl @jscheffl