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 fa20f18ea44 Add suspending providers section to provider governance
(#64252)
fa20f18ea44 is described below
commit fa20f18ea44d2726d7395b0ddc1e2093a0f26b86
Author: Jarek Potiuk <[email protected]>
AuthorDate: Thu Mar 26 14:22:36 2026 +0100
Add suspending providers section to provider governance (#64252)
Document that providers can be suspended from CI builds and releases
when their dependencies block upgrades, including per-Python-version
suspension. Stewards are responsible for resolving issues and ensuring
green CI before unsuspension.
---
providers/PROVIDER_GOVERNANCE.rst | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)
diff --git a/providers/PROVIDER_GOVERNANCE.rst
b/providers/PROVIDER_GOVERNANCE.rst
index 0fe29b0c57b..e7d509bf7d2 100644
--- a/providers/PROVIDER_GOVERNANCE.rst
+++ b/providers/PROVIDER_GOVERNANCE.rst
@@ -200,6 +200,26 @@ HTTP provider integration). At the discretion of the
Airflow PMC, certain provid
as **"mature providers"**, which will not automatically be deprecated and
moved into the attic due
to lack of activity alone.
+Suspending providers
+^^^^^^^^^^^^^^^^^^^^
+
+When a provider's dependencies prevent the broader Airflow project from
upgrading shared
+dependencies or otherwise block CI builds and releases, the provider may be
**suspended**. Suspension
+removes the provider from CI builds and releases until the underlying
dependency issues are resolved.
+
+Suspension may also be applied selectively for **individual Python versions**
when a dependency
+problem only affects a specific Python version rather than all supported
versions.
+
+It is the responsibility of the provider's **stewards** to:
+
+* Work with upstream maintainers to resolve the dependency issues
+* Ensure that unsuspending the provider results in a green CI across all
affected Python versions
+* Communicate progress and resolution on the dev list
+
+Suspension is not a lifecycle stage---it is a temporary operational measure
that can apply to providers
+at any lifecycle stage (incubation, production, or mature). Once the
dependency issues are resolved and
+CI is green, the provider is unsuspended and returns to normal operations.
+
Periodic reviews
^^^^^^^^^^^^^^^^