You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airflow.apache.org by po...@apache.org on 2026/07/06 17:13:14 UTC
(airflow) branch main updated: Shorten constraints refresh dispatch inputs and document how to run it (#69472)
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 c3e2d1d7648 Shorten constraints refresh dispatch inputs and document how to run it (#69472)
c3e2d1d7648 is described below
commit c3e2d1d76482844056957c0176a1985853a15969
Author: Jarek Potiuk <ja...@potiuk.com>
AuthorDate: Mon Jul 6 19:13:05 2026 +0200
Shorten constraints refresh dispatch inputs and document how to run it (#69472)
The workflow_dispatch input descriptions rendered as long paragraphs in
the "Run workflow" form, which is hard to scan. Shorten them to concise
labels and make the ref optional (empty refreshes the branch you run
from). Add a job-summary step that shows how the run was triggered and
with which parameters, and document the manual run - including a
screenshot of the "Run workflow" form - in
dev/MANUALLY_GENERATING_IMAGE_CACHE_AND_CONSTRAINTS.md.
---
.github/workflows/update-constraints-on-push.yml | 38 ++++++++++++++++-----
...UALLY_GENERATING_IMAGE_CACHE_AND_CONSTRAINTS.md | 15 ++++----
dev/images/update_constraints_run_workflow.png | Bin 0 -> 505265 bytes
3 files changed, 38 insertions(+), 15 deletions(-)
diff --git a/.github/workflows/update-constraints-on-push.yml b/.github/workflows/update-constraints-on-push.yml
index b65168c53da..f72c444ab19 100644
--- a/.github/workflows/update-constraints-on-push.yml
+++ b/.github/workflows/update-constraints-on-push.yml
@@ -39,18 +39,18 @@ on: # yamllint disable-line rule:truthy
- 'uv.lock'
workflow_dispatch:
inputs:
+ # `ref` is optional. Leave it empty to refresh constraints for the branch
+ # you run the workflow from (normally `main` -> `constraints-main`). Set a
+ # branch, tag or commit to refresh a specific line, e.g.
+ # `v3-3-stable` -> `constraints-3-3`. The target `constraints-X-Y` branch
+ # is derived from that ref's branch_defaults.py.
ref:
- description: >-
- Commit-ish to refresh constraints from (branch, tag or commit hash),
- e.g. `v3-3-test`, `v3-3-stable`, `constraints-3-3` or a tag/hash.
- The matching `constraints-X-Y` branch is derived from that ref.
- required: true
+ description: "Optional repo reference to build constraints (e.g. v3-3-stable)"
+ required: false
+ default: ""
type: string
upgrade-to-newer-dependencies:
- description: >-
- Re-resolve to the newest matching dependencies (picks up newly
- released providers/dependencies from PyPI). Leave enabled when
- refreshing constraints before promoting an RC.
+ description: "Upgrade deps to newest from PyPI"
type: boolean
default: true
permissions:
@@ -123,6 +123,26 @@ jobs:
VERBOSE: "false"
GITHUB_CONTEXT_INPUT: "${{ runner.temp }}/github_context.json"
run: breeze ci selective-check 2>> ${GITHUB_OUTPUT}
+ - name: "Parameters summary"
+ shell: bash
+ env:
+ EVENT_NAME: ${{ github.event_name }}
+ REF: ${{ inputs.ref }}
+ UPGRADE: ${{ inputs.upgrade-to-newer-dependencies }}
+ CONSTRAINTS_BRANCH: ${{ steps.selective-checks.outputs.default-constraints-branch }}
+ run: |
+ {
+ echo "## Update constraints"
+ echo ""
+ echo "| Parameter | Value |"
+ echo "|---|---|"
+ echo "| Triggered by | \`${EVENT_NAME}\` |"
+ if [[ "${EVENT_NAME}" == "workflow_dispatch" ]]; then
+ echo "| Refresh from ref | \`${REF}\` |"
+ echo "| Upgrade to newer dependencies | \`${UPGRADE}\` |"
+ fi
+ echo "| Target constraints branch | \`${CONSTRAINTS_BRANCH}\` |"
+ } | tee -a "${GITHUB_STEP_SUMMARY}"
build-ci-images:
name: "Build CI images"
diff --git a/dev/MANUALLY_GENERATING_IMAGE_CACHE_AND_CONSTRAINTS.md b/dev/MANUALLY_GENERATING_IMAGE_CACHE_AND_CONSTRAINTS.md
index 4a794333ab6..01bdd7f7504 100644
--- a/dev/MANUALLY_GENERATING_IMAGE_CACHE_AND_CONSTRAINTS.md
+++ b/dev/MANUALLY_GENERATING_IMAGE_CACHE_AND_CONSTRAINTS.md
@@ -236,18 +236,21 @@ workflow); the automatic `uv.lock`-push runs are not restricted.
To run it:
+
+
1. Go to the [`Update constraints`](https://github.com/apache/airflow/actions/workflows/update-constraints-on-push.yml)
workflow in the Actions tab.
2. Click **Run workflow** and keep the branch set to `main` (this is where the workflow runs
from - it is not the branch whose constraints get refreshed).
-3. In the **ref** field, enter the commit-ish to refresh constraints from - for example
- `v3-3-test`, `v3-3-stable`, `constraints-3-3`, an RC tag, or a commit hash. The matching
- `constraints-X-Y` branch to push to is derived automatically from that ref's
+3. In the **Optional repo reference to build constraints** field, enter the ref to refresh
+ constraints from - for example `v3-3-test`, `v3-3-stable`, `constraints-3-3`, an RC tag, or a
+ commit hash. Leave it empty to refresh the branch you run from (`main` -> `constraints-main`).
+ The matching `constraints-X-Y` branch to push to is derived automatically from that ref's
`dev/breeze/src/airflow_breeze/branch_defaults.py`, so pointing at anything on the 3.3 line
refreshes `constraints-3-3`.
-4. Keep **Re-resolve to the newest matching dependencies** enabled (the default) so the run
- picks up the latest released providers/dependencies from PyPI. Disable it only if you want
- to regenerate constraints strictly from that ref's `uv.lock` without upgrading.
+4. Keep **Upgrade deps to newest from PyPI** enabled (the default) so the run picks up the
+ latest released providers/dependencies from PyPI. Disable it only if you want to regenerate
+ constraints strictly from that ref's `uv.lock` without upgrading.
5. Once the run finishes, verify the new commit on the matching constraints branch
(for example `constraints-3-3` for a 3.3 refresh):
diff --git a/dev/images/update_constraints_run_workflow.png b/dev/images/update_constraints_run_workflow.png
new file mode 100644
index 00000000000..16eead4701b
Binary files /dev/null and b/dev/images/update_constraints_run_workflow.png differ