From 9befeb77f52ec264b4acbffda3845ee932d01583 Mon Sep 17 00:00:00 2001 From: merobi-hub Date: Thu, 13 Jun 2024 21:42:25 -0400 Subject: [PATCH 1/6] More detailed guidance about upgrading in docs. Signed-off-by: merobi-hub --- docs/apache-airflow/installation/upgrading.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/apache-airflow/installation/upgrading.rst b/docs/apache-airflow/installation/upgrading.rst index fa972680fccc6..ba5d4e19ae8f7 100644 --- a/docs/apache-airflow/installation/upgrading.rst +++ b/docs/apache-airflow/installation/upgrading.rst @@ -57,6 +57,10 @@ when you choose to upgrade airflow via their UI. How to upgrade ============== +Reinstall Apache Airflow™, specifying the desired new version. For example, in the case of a bootstrapped +local instance, this can be accomplished easily with the ``AIRFLOW_VERSION`` environment variable. For more +details, see :doc:`/installation/index`. + In order to manually migrate the database you should run the ``airflow db migrate`` command in your environment. It can be run either in your virtual environment or in the containers that give you access to Airflow ``CLI`` :doc:`/howto/usage-cli` and the database. From efe61ca40970c0545467c8b75dac18d5744b10ac Mon Sep 17 00:00:00 2001 From: merobi-hub Date: Fri, 14 Jun 2024 08:49:54 -0400 Subject: [PATCH 2/6] More detailed guidance. Signed-off-by: merobi-hub --- docs/apache-airflow/installation/upgrading.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/apache-airflow/installation/upgrading.rst b/docs/apache-airflow/installation/upgrading.rst index ba5d4e19ae8f7..e35bca7e9294d 100644 --- a/docs/apache-airflow/installation/upgrading.rst +++ b/docs/apache-airflow/installation/upgrading.rst @@ -58,8 +58,9 @@ How to upgrade ============== Reinstall Apache Airflow™, specifying the desired new version. For example, in the case of a bootstrapped -local instance, this can be accomplished easily with the ``AIRFLOW_VERSION`` environment variable. For more -details, see :doc:`/installation/index`. +local instance, you can upgrade easily by setting the ``AIRFLOW_VERSION`` environment variable +to the intended version prior to rerunning the installation command. For more details, see :doc:`/start` +and :doc:`/installation/index`. In order to manually migrate the database you should run the ``airflow db migrate`` command in your environment. It can be run either in your virtual environment or in the containers that give From eeb75198f6021462ed65cf4b2528f945a9520e22 Mon Sep 17 00:00:00 2001 From: merobi-hub Date: Fri, 14 Jun 2024 09:22:36 -0400 Subject: [PATCH 3/6] Linter fix. Signed-off-by: merobi-hub --- docs/apache-airflow/installation/upgrading.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/apache-airflow/installation/upgrading.rst b/docs/apache-airflow/installation/upgrading.rst index e35bca7e9294d..dc0751e2b9f41 100644 --- a/docs/apache-airflow/installation/upgrading.rst +++ b/docs/apache-airflow/installation/upgrading.rst @@ -58,7 +58,7 @@ How to upgrade ============== Reinstall Apache Airflow™, specifying the desired new version. For example, in the case of a bootstrapped -local instance, you can upgrade easily by setting the ``AIRFLOW_VERSION`` environment variable +local instance, you can upgrade easily by setting the ``AIRFLOW_VERSION`` environment variable to the intended version prior to rerunning the installation command. For more details, see :doc:`/start` and :doc:`/installation/index`. From 4c99f52264b1625d96da1ff426e5d3865c176220 Mon Sep 17 00:00:00 2001 From: merobi-hub Date: Fri, 14 Jun 2024 10:27:43 -0400 Subject: [PATCH 4/6] Advice about incremental upgrades. Signed-off-by: merobi-hub --- docs/apache-airflow/installation/upgrading.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/apache-airflow/installation/upgrading.rst b/docs/apache-airflow/installation/upgrading.rst index dc0751e2b9f41..b3819ceb5e96c 100644 --- a/docs/apache-airflow/installation/upgrading.rst +++ b/docs/apache-airflow/installation/upgrading.rst @@ -59,8 +59,9 @@ How to upgrade Reinstall Apache Airflow™, specifying the desired new version. For example, in the case of a bootstrapped local instance, you can upgrade easily by setting the ``AIRFLOW_VERSION`` environment variable -to the intended version prior to rerunning the installation command. For more details, see :doc:`/start` -and :doc:`/installation/index`. +to the intended version prior to rerunning the installation command. Upgrade incrementally by patch version: +e.g., if upgrading from version 2.8.2 to 2.8.4, upgrade first to 2.8.3. For detailed installation guidance, +see :doc:`/start` and :doc:`/installation/index`. In order to manually migrate the database you should run the ``airflow db migrate`` command in your environment. It can be run either in your virtual environment or in the containers that give From 9aef3d1095b36456d022df7f3b9bbb4df6cb2705 Mon Sep 17 00:00:00 2001 From: merobi-hub Date: Fri, 14 Jun 2024 10:55:36 -0400 Subject: [PATCH 5/6] Guidance for pypi packages. Signed-off-by: merobi-hub --- docs/apache-airflow/installation/upgrading.rst | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/apache-airflow/installation/upgrading.rst b/docs/apache-airflow/installation/upgrading.rst index b3819ceb5e96c..73d9f7725a015 100644 --- a/docs/apache-airflow/installation/upgrading.rst +++ b/docs/apache-airflow/installation/upgrading.rst @@ -57,11 +57,15 @@ when you choose to upgrade airflow via their UI. How to upgrade ============== -Reinstall Apache Airflow™, specifying the desired new version. For example, in the case of a bootstrapped -local instance, you can upgrade easily by setting the ``AIRFLOW_VERSION`` environment variable -to the intended version prior to rerunning the installation command. Upgrade incrementally by patch version: -e.g., if upgrading from version 2.8.2 to 2.8.4, upgrade first to 2.8.3. For detailed installation guidance, -see :doc:`/start` and :doc:`/installation/index`. +Reinstall Apache Airflow™, specifying the desired new version. + +To upgrade a bootstrapped local instance, you can set the ``AIRFLOW_VERSION`` environment variable to the +intended version prior to rerunning the installation command. Upgrade incrementally by patch version: e.g., +if upgrading from version 2.8.2 to 2.8.4, upgrade first to 2.8.3. For detailed installation guidance, see +:doc:`/start`. + +To upgrade a PyPI package, rerun the ``pip install`` command in your environment using the desired version +as a constraint. For more detailed guidance, see :doc:`/installation/installing-from-pypi`. In order to manually migrate the database you should run the ``airflow db migrate`` command in your environment. It can be run either in your virtual environment or in the containers that give From 65f57bd1ddafdb0d560cdc09461d87d3cfa99a7f Mon Sep 17 00:00:00 2001 From: merobi-hub Date: Fri, 14 Jun 2024 10:57:53 -0400 Subject: [PATCH 6/6] Wording fix. Signed-off-by: merobi-hub --- docs/apache-airflow/installation/upgrading.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/apache-airflow/installation/upgrading.rst b/docs/apache-airflow/installation/upgrading.rst index 73d9f7725a015..5ab8100287e8c 100644 --- a/docs/apache-airflow/installation/upgrading.rst +++ b/docs/apache-airflow/installation/upgrading.rst @@ -61,7 +61,7 @@ Reinstall Apache Airflow™, specifying the desired new version. To upgrade a bootstrapped local instance, you can set the ``AIRFLOW_VERSION`` environment variable to the intended version prior to rerunning the installation command. Upgrade incrementally by patch version: e.g., -if upgrading from version 2.8.2 to 2.8.4, upgrade first to 2.8.3. For detailed installation guidance, see +if upgrading from version 2.8.2 to 2.8.4, upgrade first to 2.8.3. For more detailed guidance, see :doc:`/start`. To upgrade a PyPI package, rerun the ``pip install`` command in your environment using the desired version