From f99f7df727eb2c609480e4e403d441e455529482 Mon Sep 17 00:00:00 2001 From: Jarek Potiuk Date: Tue, 25 Jan 2022 12:16:55 +0100 Subject: [PATCH] Add documentation and release policy on "latest" constraints (#21093) (cherry picked from commit aac5a1dba8b2b1a2b66fd4b1271dc03170c64dfb) --- dev/README_RELEASE_AIRFLOW.md | 10 +++++++++- .../installation/installing-from-pypi.rst | 7 +++++++ 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/dev/README_RELEASE_AIRFLOW.md b/dev/README_RELEASE_AIRFLOW.md index c8310642e3228..4aae94537d3ab 100644 --- a/dev/README_RELEASE_AIRFLOW.md +++ b/dev/README_RELEASE_AIRFLOW.md @@ -156,7 +156,7 @@ For now this is done manually, example run `git log --oneline v2-2-test..HEAD - popd ``` -- Tag & Push the latest constraints files. This pushes constraints with rc suffix (this is expected)! +- Tag & Push the constraints files. This pushes constraints with rc suffix (this is expected)! ```shell script git checkout origin/constraints-${VERSION_BRANCH} @@ -298,6 +298,7 @@ protected_branches: git push origin tag constraints-${BRANCH_PREFIX} ``` + ## Prepare PyPI convenience "snapshot" packages At this point we have the artifact that we vote on, but as a convenience to developers we also want to @@ -796,6 +797,13 @@ At this point we release an official package: git push origin tag "constraints-${VERSION}" ``` +- In case you release "latest stable" version, also update "latest" constraints + + ```shell script + git tag -f -s "constraints-latest" -m "Latest constraints set to Apache Airflow ${VERSION}" + git push origin tag "constraints-latest" + ``` + - Push Tag for the final version This step should only be done now and not before, because it triggers an automated build of diff --git a/docs/apache-airflow/installation/installing-from-pypi.rst b/docs/apache-airflow/installation/installing-from-pypi.rst index 33a7d7c9a4918..5edf5e1148042 100644 --- a/docs/apache-airflow/installation/installing-from-pypi.rst +++ b/docs/apache-airflow/installation/installing-from-pypi.rst @@ -81,6 +81,13 @@ You can create the URL to the file substituting the variables in the template be https://raw.githubusercontent.com/apache/airflow/constraints-${AIRFLOW_VERSION}/constraints-no-providers-${PYTHON_VERSION}.txt +You can also use "latest" as version when you install "latest" stable version of Airflow. The "latest" +constraints always points to the "latest" released Airflow version constraints: + +.. code-block:: + + https://raw.githubusercontent.com/apache/airflow/constraints-latest/constraints-3.7.txt + Installation and upgrade scenarios ''''''''''''''''''''''''''''''''''