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 <[email protected]>
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
