From 32aa1ac6ba9bdde26c7ab6fd0733db6b9ce2720a Mon Sep 17 00:00:00 2001 From: Jarek Potiuk Date: Fri, 13 May 2022 13:33:17 +0200 Subject: [PATCH] Clarify that bundle extras should not be used for PyPi installs (#23697) The bundle extras we have are only used for development and they should not be used to install airflow from PyPI. This update to documentation clarifies it. Closes: #23692 (cherry picked from commit 310002e44887847991b0864bbf9a921c7b11e930) --- docs/apache-airflow/extra-packages-ref.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/apache-airflow/extra-packages-ref.rst b/docs/apache-airflow/extra-packages-ref.rst index a75e1d87d6ad2e..6fbba68fd8f0c6 100644 --- a/docs/apache-airflow/extra-packages-ref.rst +++ b/docs/apache-airflow/extra-packages-ref.rst @@ -294,7 +294,12 @@ Those are extras that provide support for integration with external systems via Bundle extras ------------- -Those are extras that install one ore more extras as a bundle. +Those are extras that install one ore more extras as a bundle. Note that those extras should only be used for "development" version +of Airflow - i.e. when Airflow is installed from sources. Because of the way how bundle extras are constructed they might not +work when airflow is installed from 'PyPI`. + +If you want to install Airflow from PyPI with "all" extras (which should basically be never needed - you almost never need all extras from Airflow), +you need to list explicitly all the non-bundle extras that you want to install. +---------------------+-----------------------------------------------------+------------------------------------------------------------------------+ | extra | install command | enables |