This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch v2-3-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/v2-3-test by this push:
new 51465a65d0 Clarify that bundle extras should not be used for PyPi
installs (#23697)
51465a65d0 is described below
commit 51465a65d0ef22c7ae10e4b2e9c1049a7c7e2b26
Author: Jarek Potiuk <[email protected]>
AuthorDate: Fri May 13 13:33:17 2022 +0200
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 a75e1d87d6..6fbba68fd8 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 |