Skip to content

Fix broken download URLs and variable names in airflow-ctl docs#67046

Merged
potiuk merged 1 commit into
apache:mainfrom
srchilukoori:fix/67025-airflow-ctl-docs-broken-urls
May 17, 2026
Merged

Fix broken download URLs and variable names in airflow-ctl docs#67046
potiuk merged 1 commit into
apache:mainfrom
srchilukoori:fix/67025-airflow-ctl-docs-broken-urls

Conversation

@srchilukoori
Copy link
Copy Markdown
Contributor

Fix broken download URLs and variable names in airflow-ctl installing-from-sources docs

The installing-from-sources.rst page for airflow-ctl has two categories of bugs:

Broken URLs (HTTP 404)

The KEYS link and one of the curl commands use downloads.apache.org/airflowctl/...
which doesn't exist. The correct base path is downloads.apache.org/airflow/KEYS
(shared across all Airflow distributions) and downloads.apache.org/airflow/airflow-ctl/{version}/
(matching the base_url already defined in airflow-ctl/docs/conf.py line 210).

The second curl command was slightly different — it used downloads.apache.org/airflow/${version}/
but omitted the airflow-ctl/ subdirectory.

Undefined shell variables

The bash verification script defines ctl_download_dir but then references two
non-existent variables (airflow_download_dir and airflowctl_download_dir).
Unified all references to ctl_download_dir.

closes: #67025


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

  • 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.

The installing-from-sources page for airflow-ctl had URLs pointing to
a non-existent `downloads.apache.org/airflowctl/` path. The correct
path is `downloads.apache.org/airflow/airflow-ctl/` (matching the
base_url defined in conf.py) and `downloads.apache.org/airflow/KEYS`
for the shared PGP key file.

Also fixes the bash script using three inconsistent variable names
for the download directory — unified to `ctl_download_dir` which is
the variable actually defined in the script.

Closes: apache#67025
@potiuk potiuk merged commit 09545ec into apache:main May 17, 2026
70 checks passed
@github-actions
Copy link
Copy Markdown
Contributor

Backport successfully created: airflow-ctl/v0-1-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
airflow-ctl/v0-1-test PR Link

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.

Broken URLs to apache.org downloads in airflow-ctl installing-from-sources docs (404)

2 participants