This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new ba7cdbf9f98 feat(breeze): enable airflowctl docs to be released
(#54880)
ba7cdbf9f98 is described below
commit ba7cdbf9f98c3f92ce0f1986fc9ccc78ca41d8c6
Author: Bugra Ozturk <[email protected]>
AuthorDate: Sun Aug 24 22:00:02 2025 +0200
feat(breeze): enable airflowctl docs to be released (#54880)
* feat(breeze): enable airflowctl docs to be released
* Update dev/breeze/src/airflow_breeze/utils/selective_checks.py
Co-authored-by: Jarek Potiuk <[email protected]>
* Update docs/README.md
Co-authored-by: Jarek Potiuk <[email protected]>
* feat(docs): add function to retrieve airflowctl version and use it in
DocsPublisher
* feat(docs): add function to retrieve airflowctl version and use it in
DocsPublisher
---------
Co-authored-by: Jarek Potiuk <[email protected]>
---
.github/workflows/ci-image-checks.yml | 2 ++
dev/breeze/doc/images/output_build-docs.svg | 8 ++++----
dev/breeze/doc/images/output_build-docs.txt | 2 +-
.../output_release-management_add-back-references.svg | 8 ++++----
.../output_release-management_add-back-references.txt | 2 +-
.../doc/images/output_release-management_publish-docs.svg | 8 ++++----
.../doc/images/output_release-management_publish-docs.txt | 2 +-
.../doc/images/output_workflow-run_publish-docs.svg | 8 ++++----
.../doc/images/output_workflow-run_publish-docs.txt | 2 +-
dev/breeze/src/airflow_breeze/global_constants.py | 15 +++++++++++++++
dev/breeze/src/airflow_breeze/utils/docs_publisher.py | 4 +++-
dev/breeze/src/airflow_breeze/utils/selective_checks.py | 2 ++
dev/breeze/tests/test_publish_docs_to_s3.py | 2 ++
docs/README.md | 4 ++--
14 files changed, 46 insertions(+), 23 deletions(-)
diff --git a/.github/workflows/ci-image-checks.yml
b/.github/workflows/ci-image-checks.yml
index 32953b67416..8bfff2f0007 100644
--- a/.github/workflows/ci-image-checks.yml
+++ b/.github/workflows/ci-image-checks.yml
@@ -373,6 +373,8 @@ jobs:
run: breeze release-management add-back-references docker-stack
- name: "Generate back references for helm-chart"
run: breeze release-management add-back-references helm-chart
+ - name: "Generate back references for apache-airflow-ctl"
+ run: breeze release-management add-back-references apache-airflow-ctl
- name: "Validate published doc versions"
id: validate-docs-versions
run: cd ./dev/breeze && uv run
./src/airflow_breeze/utils/docs_version_validation.py
diff --git a/dev/breeze/doc/images/output_build-docs.svg
b/dev/breeze/doc/images/output_build-docs.svg
index da2e06e5fb6..c441908dd96 100644
--- a/dev/breeze/doc/images/output_build-docs.svg
+++ b/dev/breeze/doc/images/output_build-docs.svg
@@ -222,10 +222,10 @@
<text class="breeze-build-docs-r1" x="1464" y="20" textLength="12.2"
clip-path="url(#breeze-build-docs-line-0)">
</text><text class="breeze-build-docs-r2" x="12.2" y="44.4"
textLength="1439.6"
clip-path="url(#breeze-build-docs-line-1)">Usage:                                                            
[...]
</text><text class="breeze-build-docs-r3" x="12.2" y="68.8"
textLength="1439.6"
clip-path="url(#breeze-build-docs-line-2)">breeze build-docs                                                          
[...]
-</text><text class="breeze-build-docs-r1" x="12.2" y="93.2" textLength="12.2"
clip-path="url(#breeze-build-docs-line-3)">[</text><text
class="breeze-build-docs-r4" x="24.4" y="93.2" textLength="85.4"
clip-path="url(#breeze-build-docs-line-3)">OPTIONS</text><text
class="breeze-build-docs-r1" x="109.8" y="93.2" textLength="36.6"
clip-path="url(#breeze-build-docs-line-3)">] [</text><text
class="breeze-build-docs-r4" x="146.4" y="93.2" textLength="85.4"
clip-path="url(#breeze-build-docs [...]
-</text><text class="breeze-build-docs-r4" x="12.2" y="117.6" textLength="73.2"
clip-path="url(#breeze-build-docs-line-4)">apache</text><text
class="breeze-build-docs-r1" x="85.4" y="117.6" textLength="12.2"
clip-path="url(#breeze-build-docs-line-4)">.</text><text
class="breeze-build-docs-r4" x="97.6" y="117.6" textLength="109.8"
clip-path="url(#breeze-build-docs-line-4)">cassandra</text><text
class="breeze-build-docs-r1" x="207.4" y="117.6" textLength="36.6"
clip-path="url(#breeze-build- [...]
-</text><text class="breeze-build-docs-r4" x="12.2" y="142" textLength="73.2"
clip-path="url(#breeze-build-docs-line-5)">apache</text><text
class="breeze-build-docs-r1" x="85.4" y="142" textLength="12.2"
clip-path="url(#breeze-build-docs-line-5)">.</text><text
class="breeze-build-docs-r4" x="97.6" y="142" textLength="73.2"
clip-path="url(#breeze-build-docs-line-5)">impala</text><text
class="breeze-build-docs-r1" x="170.8" y="142" textLength="36.6"
clip-path="url(#breeze-build-docs-line-5) [...]
-</text><text class="breeze-build-docs-r4" x="12.2" y="166.4" textLength="73.2"
clip-path="url(#breeze-build-docs-line-6)">apache</text><text
class="breeze-build-docs-r1" x="85.4" y="166.4" textLength="12.2"
clip-path="url(#breeze-build-docs-line-6)">.</text><text
class="breeze-build-docs-r4" x="97.6" y="166.4" textLength="109.8"
clip-path="url(#breeze-build-docs-line-6)">tinkerpop</text><text
class="breeze-build-docs-r1" x="207.4" y="166.4" textLength="36.6"
clip-path="url(#breeze-build- [...]
+</text><text class="breeze-build-docs-r1" x="12.2" y="93.2" textLength="12.2"
clip-path="url(#breeze-build-docs-line-3)">[</text><text
class="breeze-build-docs-r4" x="24.4" y="93.2" textLength="85.4"
clip-path="url(#breeze-build-docs-line-3)">OPTIONS</text><text
class="breeze-build-docs-r1" x="109.8" y="93.2" textLength="36.6"
clip-path="url(#breeze-build-docs-line-3)">] [</text><text
class="breeze-build-docs-r4" x="146.4" y="93.2" textLength="85.4"
clip-path="url(#breeze-build-docs [...]
+</text><text class="breeze-build-docs-r1" x="12.2" y="117.6" textLength="24.4"
clip-path="url(#breeze-build-docs-line-4)">| </text><text
class="breeze-build-docs-r4" x="36.6" y="117.6" textLength="73.2"
clip-path="url(#breeze-build-docs-line-4)">apache</text><text
class="breeze-build-docs-r1" x="109.8" y="117.6" textLength="12.2"
clip-path="url(#breeze-build-docs-line-4)">.</text><text
class="breeze-build-docs-r4" x="122" y="117.6" textLength="48.8"
clip-path="url(#breeze-build-docs [...]
+</text><text class="breeze-build-docs-r4" x="12.2" y="142" textLength="73.2"
clip-path="url(#breeze-build-docs-line-5)">apache</text><text
class="breeze-build-docs-r1" x="85.4" y="142" textLength="12.2"
clip-path="url(#breeze-build-docs-line-5)">.</text><text
class="breeze-build-docs-r4" x="97.6" y="142" textLength="85.4"
clip-path="url(#breeze-build-docs-line-5)">iceberg</text><text
class="breeze-build-docs-r1" x="183" y="142" textLength="36.6"
clip-path="url(#breeze-build-docs-line-5)" [...]
+</text><text class="breeze-build-docs-r1" x="12.2" y="166.4" textLength="24.4"
clip-path="url(#breeze-build-docs-line-6)">| </text><text
class="breeze-build-docs-r4" x="36.6" y="166.4" textLength="73.2"
clip-path="url(#breeze-build-docs-line-6)">apache</text><text
class="breeze-build-docs-r1" x="109.8" y="166.4" textLength="12.2"
clip-path="url(#breeze-build-docs-line-6)">.</text><text
class="breeze-build-docs-r4" x="122" y="166.4" textLength="109.8"
clip-path="url(#breeze-build-doc [...]
</text><text class="breeze-build-docs-r4" x="12.2" y="190.8" textLength="73.2"
clip-path="url(#breeze-build-docs-line-7)">common</text><text
class="breeze-build-docs-r1" x="85.4" y="190.8" textLength="12.2"
clip-path="url(#breeze-build-docs-line-7)">.</text><text
class="breeze-build-docs-r4" x="97.6" y="190.8" textLength="73.2"
clip-path="url(#breeze-build-docs-line-7)">compat</text><text
class="breeze-build-docs-r1" x="170.8" y="190.8" textLength="36.6"
clip-path="url(#breeze-build-docs [...]
</text><text class="breeze-build-docs-r4" x="12.2" y="215.2" textLength="73.2"
clip-path="url(#breeze-build-docs-line-8)">docker</text><text
class="breeze-build-docs-r1" x="85.4" y="215.2" textLength="36.6"
clip-path="url(#breeze-build-docs-line-8)"> | </text><text
class="breeze-build-docs-r4" x="122" y="215.2" textLength="73.2"
clip-path="url(#breeze-build-docs-line-8)">docker</text><text
class="breeze-build-docs-r1" x="195.2" y="215.2" textLength="12.2"
clip-path="url(#breeze [...]
</text><text class="breeze-build-docs-r4" x="12.2" y="239.6"
textLength="109.8"
clip-path="url(#breeze-build-docs-line-9)">hashicorp</text><text
class="breeze-build-docs-r1" x="122" y="239.6" textLength="36.6"
clip-path="url(#breeze-build-docs-line-9)"> | </text><text
class="breeze-build-docs-r4" x="158.6" y="239.6" textLength="48.8"
clip-path="url(#breeze-build-docs-line-9)">helm</text><text
class="breeze-build-docs-r1" x="207.4" y="239.6" textLength="12.2"
clip-path="url(#bre [...]
diff --git a/dev/breeze/doc/images/output_build-docs.txt
b/dev/breeze/doc/images/output_build-docs.txt
index 6ec0cbe183a..e05839d9dff 100644
--- a/dev/breeze/doc/images/output_build-docs.txt
+++ b/dev/breeze/doc/images/output_build-docs.txt
@@ -1 +1 @@
-f64fad45c016c4dec0b180b3e7ff2826
+e0f17f59eae9cb8c4a5a66762a9ba990
diff --git
a/dev/breeze/doc/images/output_release-management_add-back-references.svg
b/dev/breeze/doc/images/output_release-management_add-back-references.svg
index 2764be6362d..75b58045516 100644
--- a/dev/breeze/doc/images/output_release-management_add-back-references.svg
+++ b/dev/breeze/doc/images/output_release-management_add-back-references.svg
@@ -146,10 +146,10 @@
<text class="breeze-release-management-add-back-references-r1" x="1464"
y="20" textLength="12.2"
clip-path="url(#breeze-release-management-add-back-references-line-0)">
</text><text class="breeze-release-management-add-back-references-r2" x="12.2"
y="44.4" textLength="1439.6"
clip-path="url(#breeze-release-management-add-back-references-line-1)">Usage:                                                   &
[...]
</text><text class="breeze-release-management-add-back-references-r3" x="12.2"
y="68.8" textLength="1439.6"
clip-path="url(#breeze-release-management-add-back-references-line-2)">breeze release-management add-back-references                                           
[...]
-</text><text class="breeze-release-management-add-back-references-r1" x="12.2"
y="93.2" textLength="12.2"
clip-path="url(#breeze-release-management-add-back-references-line-3)">[</text><text
class="breeze-release-management-add-back-references-r4" x="24.4" y="93.2"
textLength="85.4"
clip-path="url(#breeze-release-management-add-back-references-line-3)">OPTIONS</text><text
class="breeze-release-management-add-back-references-r1" x="109.8" y="93.2"
textLength="36.6" clip-path="url(#breeze- [...]
-</text><text class="breeze-release-management-add-back-references-r4" x="12.2"
y="117.6" textLength="73.2"
clip-path="url(#breeze-release-management-add-back-references-line-4)">apache</text><text
class="breeze-release-management-add-back-references-r1" x="85.4" y="117.6"
textLength="12.2"
clip-path="url(#breeze-release-management-add-back-references-line-4)">.</text><text
class="breeze-release-management-add-back-references-r4" x="97.6" y="117.6"
textLength="109.8" clip-path="url(#breez [...]
-</text><text class="breeze-release-management-add-back-references-r4" x="12.2"
y="142" textLength="73.2"
clip-path="url(#breeze-release-management-add-back-references-line-5)">apache</text><text
class="breeze-release-management-add-back-references-r1" x="85.4" y="142"
textLength="12.2"
clip-path="url(#breeze-release-management-add-back-references-line-5)">.</text><text
class="breeze-release-management-add-back-references-r4" x="97.6" y="142"
textLength="73.2" clip-path="url(#breeze-relea [...]
-</text><text class="breeze-release-management-add-back-references-r4" x="12.2"
y="166.4" textLength="73.2"
clip-path="url(#breeze-release-management-add-back-references-line-6)">apache</text><text
class="breeze-release-management-add-back-references-r1" x="85.4" y="166.4"
textLength="12.2"
clip-path="url(#breeze-release-management-add-back-references-line-6)">.</text><text
class="breeze-release-management-add-back-references-r4" x="97.6" y="166.4"
textLength="109.8" clip-path="url(#breez [...]
+</text><text class="breeze-release-management-add-back-references-r1" x="12.2"
y="93.2" textLength="12.2"
clip-path="url(#breeze-release-management-add-back-references-line-3)">[</text><text
class="breeze-release-management-add-back-references-r4" x="24.4" y="93.2"
textLength="85.4"
clip-path="url(#breeze-release-management-add-back-references-line-3)">OPTIONS</text><text
class="breeze-release-management-add-back-references-r1" x="109.8" y="93.2"
textLength="36.6" clip-path="url(#breeze- [...]
+</text><text class="breeze-release-management-add-back-references-r1" x="12.2"
y="117.6" textLength="24.4"
clip-path="url(#breeze-release-management-add-back-references-line-4)">| </text><text
class="breeze-release-management-add-back-references-r4" x="36.6" y="117.6"
textLength="73.2"
clip-path="url(#breeze-release-management-add-back-references-line-4)">apache</text><text
class="breeze-release-management-add-back-references-r1" x="109.8" y="117.6"
textLength="12.2" clip-path="url( [...]
+</text><text class="breeze-release-management-add-back-references-r4" x="12.2"
y="142" textLength="73.2"
clip-path="url(#breeze-release-management-add-back-references-line-5)">apache</text><text
class="breeze-release-management-add-back-references-r1" x="85.4" y="142"
textLength="12.2"
clip-path="url(#breeze-release-management-add-back-references-line-5)">.</text><text
class="breeze-release-management-add-back-references-r4" x="97.6" y="142"
textLength="85.4" clip-path="url(#breeze-relea [...]
+</text><text class="breeze-release-management-add-back-references-r1" x="12.2"
y="166.4" textLength="24.4"
clip-path="url(#breeze-release-management-add-back-references-line-6)">| </text><text
class="breeze-release-management-add-back-references-r4" x="36.6" y="166.4"
textLength="73.2"
clip-path="url(#breeze-release-management-add-back-references-line-6)">apache</text><text
class="breeze-release-management-add-back-references-r1" x="109.8" y="166.4"
textLength="12.2" clip-path="url( [...]
</text><text class="breeze-release-management-add-back-references-r4" x="12.2"
y="190.8" textLength="73.2"
clip-path="url(#breeze-release-management-add-back-references-line-7)">common</text><text
class="breeze-release-management-add-back-references-r1" x="85.4" y="190.8"
textLength="12.2"
clip-path="url(#breeze-release-management-add-back-references-line-7)">.</text><text
class="breeze-release-management-add-back-references-r4" x="97.6" y="190.8"
textLength="73.2" clip-path="url(#breeze [...]
</text><text class="breeze-release-management-add-back-references-r4" x="12.2"
y="215.2" textLength="73.2"
clip-path="url(#breeze-release-management-add-back-references-line-8)">docker</text><text
class="breeze-release-management-add-back-references-r1" x="85.4" y="215.2"
textLength="36.6"
clip-path="url(#breeze-release-management-add-back-references-line-8)"> | </text><text
class="breeze-release-management-add-back-references-r4" x="122" y="215.2"
textLength="73.2" clip-path=" [...]
</text><text class="breeze-release-management-add-back-references-r4" x="12.2"
y="239.6" textLength="109.8"
clip-path="url(#breeze-release-management-add-back-references-line-9)">hashicorp</text><text
class="breeze-release-management-add-back-references-r1" x="122" y="239.6"
textLength="36.6"
clip-path="url(#breeze-release-management-add-back-references-line-9)"> | </text><text
class="breeze-release-management-add-back-references-r4" x="158.6" y="239.6"
textLength="48.8" clip-p [...]
diff --git
a/dev/breeze/doc/images/output_release-management_add-back-references.txt
b/dev/breeze/doc/images/output_release-management_add-back-references.txt
index 3966c4a0651..c6ccb5bf552 100644
--- a/dev/breeze/doc/images/output_release-management_add-back-references.txt
+++ b/dev/breeze/doc/images/output_release-management_add-back-references.txt
@@ -1 +1 @@
-50ca4583aba68302b3655d463477673a
+bd8777a62f456af2ad5f29bf51b4f57f
diff --git a/dev/breeze/doc/images/output_release-management_publish-docs.svg
b/dev/breeze/doc/images/output_release-management_publish-docs.svg
index db5239192f4..56d51f42050 100644
--- a/dev/breeze/doc/images/output_release-management_publish-docs.svg
+++ b/dev/breeze/doc/images/output_release-management_publish-docs.svg
@@ -197,10 +197,10 @@
<text class="breeze-release-management-publish-docs-r1" x="1464" y="20"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-0)">
</text><text class="breeze-release-management-publish-docs-r2" x="12.2"
y="44.4" textLength="1439.6"
clip-path="url(#breeze-release-management-publish-docs-line-1)">Usage:                                                     
[...]
</text><text class="breeze-release-management-publish-docs-r3" x="12.2"
y="68.8" textLength="1439.6"
clip-path="url(#breeze-release-management-publish-docs-line-2)">breeze release-management publish-docs                                              
[...]
-</text><text class="breeze-release-management-publish-docs-r1" x="12.2"
y="93.2" textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-3)">[</text><text
class="breeze-release-management-publish-docs-r4" x="24.4" y="93.2"
textLength="85.4"
clip-path="url(#breeze-release-management-publish-docs-line-3)">OPTIONS</text><text
class="breeze-release-management-publish-docs-r1" x="109.8" y="93.2"
textLength="36.6" clip-path="url(#breeze-release-management-publish-docs-lin
[...]
-</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="117.6" textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-4)">apache</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="117.6"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-4)">.</text><text
class="breeze-release-management-publish-docs-r4" x="97.6" y="117.6"
textLength="109.8" clip-path="url(#breeze-release-management-publish-docs-l
[...]
-</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="142" textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-5)">apache</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="142"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-5)">.</text><text
class="breeze-release-management-publish-docs-r4" x="97.6" y="142"
textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-5)" [...]
-</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="166.4" textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-6)">apache</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="166.4"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-6)">.</text><text
class="breeze-release-management-publish-docs-r4" x="97.6" y="166.4"
textLength="109.8" clip-path="url(#breeze-release-management-publish-docs-l
[...]
+</text><text class="breeze-release-management-publish-docs-r1" x="12.2"
y="93.2" textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-3)">[</text><text
class="breeze-release-management-publish-docs-r4" x="24.4" y="93.2"
textLength="85.4"
clip-path="url(#breeze-release-management-publish-docs-line-3)">OPTIONS</text><text
class="breeze-release-management-publish-docs-r1" x="109.8" y="93.2"
textLength="36.6" clip-path="url(#breeze-release-management-publish-docs-lin
[...]
+</text><text class="breeze-release-management-publish-docs-r1" x="12.2"
y="117.6" textLength="24.4"
clip-path="url(#breeze-release-management-publish-docs-line-4)">| </text><text
class="breeze-release-management-publish-docs-r4" x="36.6" y="117.6"
textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-4)">apache</text><text
class="breeze-release-management-publish-docs-r1" x="109.8" y="117.6"
textLength="12.2" clip-path="url(#breeze-release-management-publish- [...]
+</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="142" textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-5)">apache</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="142"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-5)">.</text><text
class="breeze-release-management-publish-docs-r4" x="97.6" y="142"
textLength="85.4"
clip-path="url(#breeze-release-management-publish-docs-line-5)" [...]
+</text><text class="breeze-release-management-publish-docs-r1" x="12.2"
y="166.4" textLength="24.4"
clip-path="url(#breeze-release-management-publish-docs-line-6)">| </text><text
class="breeze-release-management-publish-docs-r4" x="36.6" y="166.4"
textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-6)">apache</text><text
class="breeze-release-management-publish-docs-r1" x="109.8" y="166.4"
textLength="12.2" clip-path="url(#breeze-release-management-publish- [...]
</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="190.8" textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-7)">common</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="190.8"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-7)">.</text><text
class="breeze-release-management-publish-docs-r4" x="97.6" y="190.8"
textLength="73.2" clip-path="url(#breeze-release-management-publish-docs-li
[...]
</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="215.2" textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-8)">docker</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="215.2"
textLength="36.6"
clip-path="url(#breeze-release-management-publish-docs-line-8)"> | </text><text
class="breeze-release-management-publish-docs-r4" x="122" y="215.2"
textLength="73.2" clip-path="url(#breeze-release-management-publ [...]
</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="239.6" textLength="109.8"
clip-path="url(#breeze-release-management-publish-docs-line-9)">hashicorp</text><text
class="breeze-release-management-publish-docs-r1" x="122" y="239.6"
textLength="36.6"
clip-path="url(#breeze-release-management-publish-docs-line-9)"> | </text><text
class="breeze-release-management-publish-docs-r4" x="158.6" y="239.6"
textLength="48.8" clip-path="url(#breeze-release-management [...]
diff --git a/dev/breeze/doc/images/output_release-management_publish-docs.txt
b/dev/breeze/doc/images/output_release-management_publish-docs.txt
index ecf2e8cee6c..cc300ab732b 100644
--- a/dev/breeze/doc/images/output_release-management_publish-docs.txt
+++ b/dev/breeze/doc/images/output_release-management_publish-docs.txt
@@ -1 +1 @@
-e529c5ebc1394484334dc188e7ef8f2c
+05431d65004156ec2a9784016a035517
diff --git a/dev/breeze/doc/images/output_workflow-run_publish-docs.svg
b/dev/breeze/doc/images/output_workflow-run_publish-docs.svg
index 1b15b88e6c0..147181e423c 100644
--- a/dev/breeze/doc/images/output_workflow-run_publish-docs.svg
+++ b/dev/breeze/doc/images/output_workflow-run_publish-docs.svg
@@ -194,10 +194,10 @@
<text class="breeze-workflow-run-publish-docs-r1" x="1464" y="20"
textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-0)">
</text><text class="breeze-workflow-run-publish-docs-r2" x="12.2" y="44.4"
textLength="1439.6"
clip-path="url(#breeze-workflow-run-publish-docs-line-1)">Usage:                                                       
[...]
</text><text class="breeze-workflow-run-publish-docs-r3" x="12.2" y="68.8"
textLength="1439.6"
clip-path="url(#breeze-workflow-run-publish-docs-line-2)">breeze workflow-run publish-docs                                                 
[...]
-</text><text class="breeze-workflow-run-publish-docs-r1" x="12.2" y="93.2"
textLength="12.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-3)">[</text><text
class="breeze-workflow-run-publish-docs-r4" x="24.4" y="93.2" textLength="85.4"
clip-path="url(#breeze-workflow-run-publish-docs-line-3)">OPTIONS</text><text
class="breeze-workflow-run-publish-docs-r1" x="109.8" y="93.2"
textLength="36.6"
clip-path="url(#breeze-workflow-run-publish-docs-line-3)">] [</text><text
class="br [...]
-</text><text class="breeze-workflow-run-publish-docs-r4" x="12.2" y="117.6"
textLength="73.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-4)">apache</text><text
class="breeze-workflow-run-publish-docs-r1" x="85.4" y="117.6"
textLength="12.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-4)">.</text><text
class="breeze-workflow-run-publish-docs-r4" x="97.6" y="117.6"
textLength="109.8"
clip-path="url(#breeze-workflow-run-publish-docs-line-4)">cassandra</text><text
class= [...]
-</text><text class="breeze-workflow-run-publish-docs-r4" x="12.2" y="142"
textLength="73.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-5)">apache</text><text
class="breeze-workflow-run-publish-docs-r1" x="85.4" y="142" textLength="12.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-5)">.</text><text
class="breeze-workflow-run-publish-docs-r4" x="97.6" y="142" textLength="73.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-5)">impala</text><text
class="breeze-wo [...]
-</text><text class="breeze-workflow-run-publish-docs-r4" x="12.2" y="166.4"
textLength="73.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-6)">apache</text><text
class="breeze-workflow-run-publish-docs-r1" x="85.4" y="166.4"
textLength="12.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-6)">.</text><text
class="breeze-workflow-run-publish-docs-r4" x="97.6" y="166.4"
textLength="109.8"
clip-path="url(#breeze-workflow-run-publish-docs-line-6)">tinkerpop</text><text
class= [...]
+</text><text class="breeze-workflow-run-publish-docs-r1" x="12.2" y="93.2"
textLength="12.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-3)">[</text><text
class="breeze-workflow-run-publish-docs-r4" x="24.4" y="93.2" textLength="85.4"
clip-path="url(#breeze-workflow-run-publish-docs-line-3)">OPTIONS</text><text
class="breeze-workflow-run-publish-docs-r1" x="109.8" y="93.2"
textLength="36.6"
clip-path="url(#breeze-workflow-run-publish-docs-line-3)">] [</text><text
class="br [...]
+</text><text class="breeze-workflow-run-publish-docs-r1" x="12.2" y="117.6"
textLength="24.4"
clip-path="url(#breeze-workflow-run-publish-docs-line-4)">| </text><text
class="breeze-workflow-run-publish-docs-r4" x="36.6" y="117.6"
textLength="73.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-4)">apache</text><text
class="breeze-workflow-run-publish-docs-r1" x="109.8" y="117.6"
textLength="12.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-4)">.</text><text
class="b [...]
+</text><text class="breeze-workflow-run-publish-docs-r4" x="12.2" y="142"
textLength="73.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-5)">apache</text><text
class="breeze-workflow-run-publish-docs-r1" x="85.4" y="142" textLength="12.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-5)">.</text><text
class="breeze-workflow-run-publish-docs-r4" x="97.6" y="142" textLength="85.4"
clip-path="url(#breeze-workflow-run-publish-docs-line-5)">iceberg</text><text
class="breeze-w [...]
+</text><text class="breeze-workflow-run-publish-docs-r1" x="12.2" y="166.4"
textLength="24.4"
clip-path="url(#breeze-workflow-run-publish-docs-line-6)">| </text><text
class="breeze-workflow-run-publish-docs-r4" x="36.6" y="166.4"
textLength="73.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-6)">apache</text><text
class="breeze-workflow-run-publish-docs-r1" x="109.8" y="166.4"
textLength="12.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-6)">.</text><text
class="b [...]
</text><text class="breeze-workflow-run-publish-docs-r4" x="12.2" y="190.8"
textLength="73.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-7)">common</text><text
class="breeze-workflow-run-publish-docs-r1" x="85.4" y="190.8"
textLength="12.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-7)">.</text><text
class="breeze-workflow-run-publish-docs-r4" x="97.6" y="190.8"
textLength="73.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-7)">compat</text><text
class="bre [...]
</text><text class="breeze-workflow-run-publish-docs-r4" x="12.2" y="215.2"
textLength="73.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-8)">docker</text><text
class="breeze-workflow-run-publish-docs-r1" x="85.4" y="215.2"
textLength="36.6"
clip-path="url(#breeze-workflow-run-publish-docs-line-8)"> | </text><text
class="breeze-workflow-run-publish-docs-r4" x="122" y="215.2"
textLength="73.2"
clip-path="url(#breeze-workflow-run-publish-docs-line-8)">docker</text><text
[...]
</text><text class="breeze-workflow-run-publish-docs-r4" x="12.2" y="239.6"
textLength="109.8"
clip-path="url(#breeze-workflow-run-publish-docs-line-9)">hashicorp</text><text
class="breeze-workflow-run-publish-docs-r1" x="122" y="239.6" textLength="36.6"
clip-path="url(#breeze-workflow-run-publish-docs-line-9)"> | </text><text
class="breeze-workflow-run-publish-docs-r4" x="158.6" y="239.6"
textLength="48.8"
clip-path="url(#breeze-workflow-run-publish-docs-line-9)">helm</text><t [...]
diff --git a/dev/breeze/doc/images/output_workflow-run_publish-docs.txt
b/dev/breeze/doc/images/output_workflow-run_publish-docs.txt
index 27fda1797b1..766844968d5 100644
--- a/dev/breeze/doc/images/output_workflow-run_publish-docs.txt
+++ b/dev/breeze/doc/images/output_workflow-run_publish-docs.txt
@@ -1 +1 @@
-1385adb9fa87baa129a4108b39c1f2dc
+cbc65829535f05db7d7cf55869ccbed1
diff --git a/dev/breeze/src/airflow_breeze/global_constants.py
b/dev/breeze/src/airflow_breeze/global_constants.py
index 3c62fd0b54c..c2a5c8591fc 100644
--- a/dev/breeze/src/airflow_breeze/global_constants.py
+++ b/dev/breeze/src/airflow_breeze/global_constants.py
@@ -31,6 +31,7 @@ from airflow_breeze.utils.functools_cache import
clearable_cache
from airflow_breeze.utils.host_info_utils import Architecture
from airflow_breeze.utils.path_utils import (
AIRFLOW_CORE_SOURCES_PATH,
+ AIRFLOW_CTL_SOURCES_PATH,
AIRFLOW_PYPROJECT_TOML_FILE_PATH,
AIRFLOW_ROOT_PATH,
AIRFLOW_TASK_SDK_SOURCES_PATH,
@@ -212,6 +213,7 @@ REGULAR_DOC_PACKAGES = [
"helm-chart",
"apache-airflow-providers",
"task-sdk",
+ "apache-airflow-ctl",
]
DESTINATION_LOCATIONS = [
@@ -561,6 +563,19 @@ COMMITTERS = [
]
+def get_airflowctl_version():
+ airflowctl_init_py_file = AIRFLOW_CTL_SOURCES_PATH / "airflowctl" /
"__init__.py"
+ airflowctl_version = "unknown"
+ with open(airflowctl_init_py_file) as init_file:
+ while line := init_file.readline():
+ if "__version__ = " in line:
+ airflowctl_version = line.split()[2][1:-1]
+ break
+ if airflowctl_version == "unknown":
+ raise RuntimeError("Unable to determine AirflowCTL version")
+ return airflowctl_version
+
+
def get_airflow_version():
airflow_init_py_file = AIRFLOW_CORE_SOURCES_PATH / "airflow" /
"__init__.py"
airflow_version = "unknown"
diff --git a/dev/breeze/src/airflow_breeze/utils/docs_publisher.py
b/dev/breeze/src/airflow_breeze/utils/docs_publisher.py
index 6028877db16..861a7730ded 100644
--- a/dev/breeze/src/airflow_breeze/utils/docs_publisher.py
+++ b/dev/breeze/src/airflow_breeze/utils/docs_publisher.py
@@ -19,7 +19,7 @@ from __future__ import annotations
import os
import shutil
-from airflow_breeze.global_constants import get_airflow_version,
get_task_sdk_version
+from airflow_breeze.global_constants import get_airflow_version,
get_airflowctl_version, get_task_sdk_version
from airflow_breeze.utils.console import Output, get_console
from airflow_breeze.utils.helm_chart_utils import chart_version
from airflow_breeze.utils.packages import get_provider_distributions_metadata,
get_short_package_name
@@ -70,6 +70,8 @@ class DocsPublisher:
return get_task_sdk_version()
if self.package_name == "helm-chart":
return chart_version()
+ if self.package_name == "apache-airflow-ctl":
+ return get_airflowctl_version()
raise SystemExit(f"Unsupported package: {self.package_name}")
@property
diff --git a/dev/breeze/src/airflow_breeze/utils/selective_checks.py
b/dev/breeze/src/airflow_breeze/utils/selective_checks.py
index 34f4a767b99..fdfa6bbf384 100644
--- a/dev/breeze/src/airflow_breeze/utils/selective_checks.py
+++ b/dev/breeze/src/airflow_breeze/utils/selective_checks.py
@@ -1198,6 +1198,8 @@ class SelectiveChecks:
packages.append("docker-stack")
if any(file.startswith("task-sdk/src/") for file in self._files):
packages.append("task-sdk")
+ if any(file.startswith("airflow-ctl/") for file in self._files):
+ packages.append("apache-airflow-ctl")
if providers_affected:
for provider in providers_affected:
packages.append(provider.replace("-", "."))
diff --git a/dev/breeze/tests/test_publish_docs_to_s3.py
b/dev/breeze/tests/test_publish_docs_to_s3.py
index 86c1edbe567..f3193e4f989 100644
--- a/dev/breeze/tests/test_publish_docs_to_s3.py
+++ b/dev/breeze/tests/test_publish_docs_to_s3.py
@@ -59,6 +59,7 @@ class TestPublishDocsToS3:
"apache-airflow-providers-apache-kafka",
"apache-airflow-providers-apache-cassandra",
"helm-chart",
+ "apache-airflow-ctl",
]
self.publish_docs_to_s3.exclude_docs =
"amazon,docker-stack,apache.kafka"
@@ -69,6 +70,7 @@ class TestPublishDocsToS3:
"apache-airflow",
"apache-airflow-providers-apache-cassandra",
"helm-chart",
+ "apache-airflow-ctl",
]
)
diff --git a/docs/README.md b/docs/README.md
index 4aced88a18d..37d35e57657 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -49,7 +49,7 @@ Documentation in separate distributions:
* `providers/**/docs` - documentation for Providers
* `chart/docs` - documentation for the Helm Chart
* `task-sdk/docs` - documentation for Task SDK (new format not yet published)
-* `airflow-ctl/docs` - documentation for Airflow CLI (future)
+* `airflow-ctl/docs` - documentation for Airflow CLI
Documentation for a general overview and summaries not connected with any
specific distribution:
@@ -130,7 +130,7 @@ the auto-detection.
The person who triggers the build (release manager) should specify the tag
name of the docs to be published
and the list of documentation packages to be published. Usually it is:
-* Airflow: `apache-airflow docker-stack task-sdk` (later we will add
`airflow-ctl`)
+* Airflow: `apache-airflow docker-stack task-sdk apache-airflow-ctl`
* Helm chart: `helm-chart`
* Providers: `provider_id1 provider_id2` or `all providers` if all providers
should be published.
