diff --git a/airflow/providers/airbyte/CHANGELOG.rst b/airflow/providers/airbyte/CHANGELOG.rst index 271c689430144..6d8f34d5cd49c 100644 --- a/airflow/providers/airbyte/CHANGELOG.rst +++ b/airflow/providers/airbyte/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-airbyte`` +-------------------------------------------------- 3.3.1 diff --git a/airflow/providers/alibaba/CHANGELOG.rst b/airflow/providers/alibaba/CHANGELOG.rst index 3c730893131d9..be0b33e07a978 100644 --- a/airflow/providers/alibaba/CHANGELOG.rst +++ b/airflow/providers/alibaba/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-alibaba`` +-------------------------------------------------- 2.4.1 ..... diff --git a/airflow/providers/amazon/CHANGELOG.rst b/airflow/providers/amazon/CHANGELOG.rst index 906de481a7851..ea6abb7c61ac1 100644 --- a/airflow/providers/amazon/CHANGELOG.rst +++ b/airflow/providers/amazon/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-amazon`` +------------------------------------------------- 8.2.0 ..... diff --git a/airflow/providers/apache/beam/CHANGELOG.rst b/airflow/providers/apache/beam/CHANGELOG.rst index 72ce0e4fe0a5d..495fba99e9102 100644 --- a/airflow/providers/apache/beam/CHANGELOG.rst +++ b/airflow/providers/apache/beam/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-beam`` +------------------------------------------------------ 5.1.1 ..... diff --git a/airflow/providers/apache/cassandra/CHANGELOG.rst b/airflow/providers/apache/cassandra/CHANGELOG.rst index 69ddcff864819..00bfcb83f816d 100644 --- a/airflow/providers/apache/cassandra/CHANGELOG.rst +++ b/airflow/providers/apache/cassandra/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-cassandra`` +----------------------------------------------------------- 3.2.1 ..... diff --git a/airflow/providers/apache/drill/CHANGELOG.rst b/airflow/providers/apache/drill/CHANGELOG.rst index 1be86afa269bc..60df655ec462e 100644 --- a/airflow/providers/apache/drill/CHANGELOG.rst +++ b/airflow/providers/apache/drill/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-drill`` +------------------------------------------------------- 2.4.1 diff --git a/airflow/providers/apache/druid/CHANGELOG.rst b/airflow/providers/apache/druid/CHANGELOG.rst index 7285306f819a4..9a95a041ef713 100644 --- a/airflow/providers/apache/druid/CHANGELOG.rst +++ b/airflow/providers/apache/druid/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-druid`` +------------------------------------------------------- 3.4.1 ..... diff --git a/airflow/providers/apache/flink/CHANGELOG.rst b/airflow/providers/apache/flink/CHANGELOG.rst index 38ba08d809511..40af6d54d4522 100644 --- a/airflow/providers/apache/flink/CHANGELOG.rst +++ b/airflow/providers/apache/flink/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-flink`` +------------------------------------------------------- 1.1.1 ..... diff --git a/airflow/providers/apache/hdfs/CHANGELOG.rst b/airflow/providers/apache/hdfs/CHANGELOG.rst index c8615f3db296f..7a8000b202a5c 100644 --- a/airflow/providers/apache/hdfs/CHANGELOG.rst +++ b/airflow/providers/apache/hdfs/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-hdfs`` +------------------------------------------------------ 4.1.0 ----- diff --git a/airflow/providers/apache/hive/CHANGELOG.rst b/airflow/providers/apache/hive/CHANGELOG.rst index a5ffc8dd4511a..87c44ca909aaa 100644 --- a/airflow/providers/apache/hive/CHANGELOG.rst +++ b/airflow/providers/apache/hive/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-hive`` +------------------------------------------------------ 6.1.1 diff --git a/airflow/providers/apache/impala/CHANGELOG.rst b/airflow/providers/apache/impala/CHANGELOG.rst index b94522be045c2..95e6fca155f01 100644 --- a/airflow/providers/apache/impala/CHANGELOG.rst +++ b/airflow/providers/apache/impala/CHANGELOG.rst @@ -16,12 +16,12 @@ under the License. .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-impala`` +-------------------------------------------------------- 1.1.1 ..... diff --git a/airflow/providers/apache/kafka/CHANGELOG.rst b/airflow/providers/apache/kafka/CHANGELOG.rst index 4c467c6822b0b..3bde0c11ded14 100644 --- a/airflow/providers/apache/kafka/CHANGELOG.rst +++ b/airflow/providers/apache/kafka/CHANGELOG.rst @@ -16,12 +16,12 @@ under the License. .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-kafka`` +------------------------------------------------------- 1.1.1 ..... diff --git a/airflow/providers/apache/kylin/CHANGELOG.rst b/airflow/providers/apache/kylin/CHANGELOG.rst index 6b145026f2bc2..a40ddec0324ca 100644 --- a/airflow/providers/apache/kylin/CHANGELOG.rst +++ b/airflow/providers/apache/kylin/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-kylin`` +------------------------------------------------------- 3.2.1 diff --git a/airflow/providers/apache/livy/CHANGELOG.rst b/airflow/providers/apache/livy/CHANGELOG.rst index 049172b51ea72..40cf76463937f 100644 --- a/airflow/providers/apache/livy/CHANGELOG.rst +++ b/airflow/providers/apache/livy/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-livy`` +------------------------------------------------------ 3.5.1 ..... diff --git a/airflow/providers/apache/pig/CHANGELOG.rst b/airflow/providers/apache/pig/CHANGELOG.rst index ef7f7b932e28a..72ba0f4a39111 100644 --- a/airflow/providers/apache/pig/CHANGELOG.rst +++ b/airflow/providers/apache/pig/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-pig`` +----------------------------------------------------- 4.1.1 ..... diff --git a/airflow/providers/apache/pinot/CHANGELOG.rst b/airflow/providers/apache/pinot/CHANGELOG.rst index 3f31f49320f2c..eb49423199566 100644 --- a/airflow/providers/apache/pinot/CHANGELOG.rst +++ b/airflow/providers/apache/pinot/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-pinot`` +------------------------------------------------------- 4.1.1 diff --git a/airflow/providers/apache/spark/CHANGELOG.rst b/airflow/providers/apache/spark/CHANGELOG.rst index 95586f99b1857..2ec87940533d4 100644 --- a/airflow/providers/apache/spark/CHANGELOG.rst +++ b/airflow/providers/apache/spark/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-spark`` +------------------------------------------------------- 4.1.1 ..... diff --git a/airflow/providers/apache/sqoop/CHANGELOG.rst b/airflow/providers/apache/sqoop/CHANGELOG.rst index b9efe86dc7d34..a8a5dca3cd5f4 100644 --- a/airflow/providers/apache/sqoop/CHANGELOG.rst +++ b/airflow/providers/apache/sqoop/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-apache-sqoop`` +------------------------------------------------------- 3.2.1 diff --git a/airflow/providers/apprise/CHANGELOG.rst b/airflow/providers/apprise/CHANGELOG.rst index 450e8ed420cd7..0b1586bbfafd9 100644 --- a/airflow/providers/apprise/CHANGELOG.rst +++ b/airflow/providers/apprise/CHANGELOG.rst @@ -17,6 +17,6 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. diff --git a/airflow/providers/apprise/__init__.py b/airflow/providers/apprise/__init__.py index c88b314548bd6..e37b88dcc94b0 100644 --- a/airflow/providers/apprise/__init__.py +++ b/airflow/providers/apprise/__init__.py @@ -22,3 +22,20 @@ # IF YOU WANT TO MODIFY IT, YOU SHOULD MODIFY THE TEMPLATE # `PROVIDER__INIT__PY_TEMPLATE.py.jinja2` IN the `dev/provider_packages` DIRECTORY # +from __future__ import annotations + +import packaging.version + +__all__ = ["__version__"] + +__version__ = "1.0.0" + +try: + from airflow import __version__ as airflow_version +except ImportError: + from airflow.version import version as airflow_version + +if packaging.version.parse(airflow_version) < packaging.version.parse("2.4.0"): + raise RuntimeError( + f"The package `apache-airflow-providers-apprise:{__version__}` requires Apache Airflow 2.4.0+" # NOQA: E501 + ) diff --git a/airflow/providers/arangodb/CHANGELOG.rst b/airflow/providers/arangodb/CHANGELOG.rst index 6eb420713ecb7..e72e8963d432a 100644 --- a/airflow/providers/arangodb/CHANGELOG.rst +++ b/airflow/providers/arangodb/CHANGELOG.rst @@ -18,12 +18,12 @@ under the License. .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-arangodb`` +--------------------------------------------------- 2.2.1 ..... diff --git a/airflow/providers/asana/CHANGELOG.rst b/airflow/providers/asana/CHANGELOG.rst index 5a277d5b7b29f..0e8de8a3a5585 100644 --- a/airflow/providers/asana/CHANGELOG.rst +++ b/airflow/providers/asana/CHANGELOG.rst @@ -16,12 +16,12 @@ under the License. .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-asana`` +------------------------------------------------ 2.2.1 ..... diff --git a/airflow/providers/atlassian/jira/CHANGELOG.rst b/airflow/providers/atlassian/jira/CHANGELOG.rst index f15cae6ff4009..3358ac28cb852 100644 --- a/airflow/providers/atlassian/jira/CHANGELOG.rst +++ b/airflow/providers/atlassian/jira/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-atlassian-jira`` +--------------------------------------------------------- 2.1.1 ..... diff --git a/airflow/providers/celery/CHANGELOG.rst b/airflow/providers/celery/CHANGELOG.rst index df1339a026210..1f3b37ac2d55f 100644 --- a/airflow/providers/celery/CHANGELOG.rst +++ b/airflow/providers/celery/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-celery`` +------------------------------------------------- 3.2.1 ..... diff --git a/airflow/providers/cloudant/CHANGELOG.rst b/airflow/providers/cloudant/CHANGELOG.rst index a26ac6d68c96f..93fea1598dbf9 100644 --- a/airflow/providers/cloudant/CHANGELOG.rst +++ b/airflow/providers/cloudant/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-cloudant`` +--------------------------------------------------- 3.2.1 ..... diff --git a/airflow/providers/cncf/kubernetes/CHANGELOG.rst b/airflow/providers/cncf/kubernetes/CHANGELOG.rst index 01439ce311a31..bae95c0297dd9 100644 --- a/airflow/providers/cncf/kubernetes/CHANGELOG.rst +++ b/airflow/providers/cncf/kubernetes/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-cncf-kubernetes`` +---------------------------------------------------------- 7.1.0 ..... diff --git a/airflow/providers/common/sql/CHANGELOG.rst b/airflow/providers/common/sql/CHANGELOG.rst index 9d8e58e69accc..73400cd5c6273 100644 --- a/airflow/providers/common/sql/CHANGELOG.rst +++ b/airflow/providers/common/sql/CHANGELOG.rst @@ -16,13 +16,13 @@ under the License. .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-common-sql`` +----------------------------------------------------- 1.5.2 ..... diff --git a/airflow/providers/databricks/CHANGELOG.rst b/airflow/providers/databricks/CHANGELOG.rst index 53b1b211d5f2f..de5a5df4cc7c2 100644 --- a/airflow/providers/databricks/CHANGELOG.rst +++ b/airflow/providers/databricks/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-databricks`` +----------------------------------------------------- 4.3.0 ..... diff --git a/airflow/providers/datadog/CHANGELOG.rst b/airflow/providers/datadog/CHANGELOG.rst index 84df803c1a122..d7e966661e173 100644 --- a/airflow/providers/datadog/CHANGELOG.rst +++ b/airflow/providers/datadog/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-datadog`` +-------------------------------------------------- 3.3.1 ..... diff --git a/airflow/providers/dbt/cloud/CHANGELOG.rst b/airflow/providers/dbt/cloud/CHANGELOG.rst index 92cbb954c9899..e87ecaf4b8ee3 100644 --- a/airflow/providers/dbt/cloud/CHANGELOG.rst +++ b/airflow/providers/dbt/cloud/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-dbt-cloud`` +---------------------------------------------------- 3.2.1 ..... diff --git a/airflow/providers/dingding/CHANGELOG.rst b/airflow/providers/dingding/CHANGELOG.rst index 23d4a92d56bc3..78620c282a9c5 100644 --- a/airflow/providers/dingding/CHANGELOG.rst +++ b/airflow/providers/dingding/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-dingding`` +--------------------------------------------------- 3.2.1 diff --git a/airflow/providers/discord/CHANGELOG.rst b/airflow/providers/discord/CHANGELOG.rst index a8f3d977e885d..23b9b970dc0f3 100644 --- a/airflow/providers/discord/CHANGELOG.rst +++ b/airflow/providers/discord/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-discord`` +-------------------------------------------------- 3.3.0 ..... diff --git a/airflow/providers/docker/CHANGELOG.rst b/airflow/providers/docker/CHANGELOG.rst index b7df5fa08e745..8d52fb8577a1d 100644 --- a/airflow/providers/docker/CHANGELOG.rst +++ b/airflow/providers/docker/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-docker`` +------------------------------------------------- 3.7.1 ..... diff --git a/airflow/providers/elasticsearch/CHANGELOG.rst b/airflow/providers/elasticsearch/CHANGELOG.rst index e0f2aa0894574..bb489325a6e4d 100644 --- a/airflow/providers/elasticsearch/CHANGELOG.rst +++ b/airflow/providers/elasticsearch/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-elasticsearch`` +-------------------------------------------------------- 5.0.0 ..... @@ -30,6 +30,7 @@ Changelog .. note:: Deprecate non-official elasticsearch libraries. Only the official elasticsearch library was used + 4.5.1 ..... diff --git a/airflow/providers/exasol/CHANGELOG.rst b/airflow/providers/exasol/CHANGELOG.rst index 5fb93a897e1f9..a6bbf16595682 100644 --- a/airflow/providers/exasol/CHANGELOG.rst +++ b/airflow/providers/exasol/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-exasol`` +------------------------------------------------- 4.2.1 ..... diff --git a/airflow/providers/facebook/CHANGELOG.rst b/airflow/providers/facebook/CHANGELOG.rst index ee7574fc46603..4aca578d134c4 100644 --- a/airflow/providers/facebook/CHANGELOG.rst +++ b/airflow/providers/facebook/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-facebook`` +--------------------------------------------------- 3.2.1 ..... diff --git a/airflow/providers/ftp/CHANGELOG.rst b/airflow/providers/ftp/CHANGELOG.rst index e5aec43f86e4d..d1377ea1152b8 100644 --- a/airflow/providers/ftp/CHANGELOG.rst +++ b/airflow/providers/ftp/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-ftp`` +---------------------------------------------- 3.4.2 ..... diff --git a/airflow/providers/github/CHANGELOG.rst b/airflow/providers/github/CHANGELOG.rst index d9ee1b1d19ecb..6e0fcca472e6b 100644 --- a/airflow/providers/github/CHANGELOG.rst +++ b/airflow/providers/github/CHANGELOG.rst @@ -18,12 +18,12 @@ under the License. .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-github`` +------------------------------------------------- 2.3.1 ..... diff --git a/airflow/providers/google/CHANGELOG.rst b/airflow/providers/google/CHANGELOG.rst index 95942d6e6dade..7c39d83e3c8d5 100644 --- a/airflow/providers/google/CHANGELOG.rst +++ b/airflow/providers/google/CHANGELOG.rst @@ -16,12 +16,12 @@ under the License. .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-google`` +------------------------------------------------- 10.2.0 ...... diff --git a/airflow/providers/grpc/CHANGELOG.rst b/airflow/providers/grpc/CHANGELOG.rst index c71b34b4171b0..b65a9b0a75874 100644 --- a/airflow/providers/grpc/CHANGELOG.rst +++ b/airflow/providers/grpc/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-grpc`` +----------------------------------------------- 3.2.1 ..... diff --git a/airflow/providers/hashicorp/CHANGELOG.rst b/airflow/providers/hashicorp/CHANGELOG.rst index 38dc1396da1c8..88ca2da0256d1 100644 --- a/airflow/providers/hashicorp/CHANGELOG.rst +++ b/airflow/providers/hashicorp/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-hashicorp`` +---------------------------------------------------- 3.4.1 ..... diff --git a/airflow/providers/http/CHANGELOG.rst b/airflow/providers/http/CHANGELOG.rst index df2165460a1c3..bab59fd533ba0 100644 --- a/airflow/providers/http/CHANGELOG.rst +++ b/airflow/providers/http/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-http`` +----------------------------------------------- 4.4.2 ..... diff --git a/airflow/providers/imap/CHANGELOG.rst b/airflow/providers/imap/CHANGELOG.rst index 1dd64ab057b05..e5ae86a416d10 100644 --- a/airflow/providers/imap/CHANGELOG.rst +++ b/airflow/providers/imap/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-imap`` +----------------------------------------------- 3.2.2 ..... diff --git a/airflow/providers/influxdb/CHANGELOG.rst b/airflow/providers/influxdb/CHANGELOG.rst index 8a03f33a974d8..081456722f9a3 100644 --- a/airflow/providers/influxdb/CHANGELOG.rst +++ b/airflow/providers/influxdb/CHANGELOG.rst @@ -18,12 +18,12 @@ under the License. .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-influxdb`` +--------------------------------------------------- 2.2.1 ..... diff --git a/airflow/providers/jdbc/CHANGELOG.rst b/airflow/providers/jdbc/CHANGELOG.rst index b54dcaabad34c..a8a079568ba89 100644 --- a/airflow/providers/jdbc/CHANGELOG.rst +++ b/airflow/providers/jdbc/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-jdbc`` +----------------------------------------------- 4.0.0 ..... diff --git a/airflow/providers/jenkins/CHANGELOG.rst b/airflow/providers/jenkins/CHANGELOG.rst index c9054cceaf304..1f9328f892aa7 100644 --- a/airflow/providers/jenkins/CHANGELOG.rst +++ b/airflow/providers/jenkins/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-jenkins`` +-------------------------------------------------- 3.3.1 ..... diff --git a/airflow/providers/microsoft/azure/CHANGELOG.rst b/airflow/providers/microsoft/azure/CHANGELOG.rst index e495ea31ee4ee..87424de9b6242 100644 --- a/airflow/providers/microsoft/azure/CHANGELOG.rst +++ b/airflow/providers/microsoft/azure/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-microsoft-azure`` +---------------------------------------------------------- 6.1.2 ..... diff --git a/airflow/providers/microsoft/mssql/CHANGELOG.rst b/airflow/providers/microsoft/mssql/CHANGELOG.rst index c4c32385cd125..e161e6fa33e93 100644 --- a/airflow/providers/microsoft/mssql/CHANGELOG.rst +++ b/airflow/providers/microsoft/mssql/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-microsoft-mssql`` +---------------------------------------------------------- 3.4.1 ..... diff --git a/airflow/providers/microsoft/psrp/CHANGELOG.rst b/airflow/providers/microsoft/psrp/CHANGELOG.rst index 163a7a82fba33..f4fcf01bd10f0 100644 --- a/airflow/providers/microsoft/psrp/CHANGELOG.rst +++ b/airflow/providers/microsoft/psrp/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-microsoft-psrp`` +--------------------------------------------------------- 2.3.1 ..... diff --git a/airflow/providers/microsoft/winrm/CHANGELOG.rst b/airflow/providers/microsoft/winrm/CHANGELOG.rst index 98c8300f0a35c..e30d846332688 100644 --- a/airflow/providers/microsoft/winrm/CHANGELOG.rst +++ b/airflow/providers/microsoft/winrm/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-microsoft-winrm`` +---------------------------------------------------------- 3.2.1 ..... diff --git a/airflow/providers/mongo/CHANGELOG.rst b/airflow/providers/mongo/CHANGELOG.rst index 982db5719e1d3..2b07ba58d5486 100644 --- a/airflow/providers/mongo/CHANGELOG.rst +++ b/airflow/providers/mongo/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-mongo`` +------------------------------------------------ 3.2.1 ..... diff --git a/airflow/providers/mysql/CHANGELOG.rst b/airflow/providers/mysql/CHANGELOG.rst index d9730a3535812..ec482a62ec963 100644 --- a/airflow/providers/mysql/CHANGELOG.rst +++ b/airflow/providers/mysql/CHANGELOG.rst @@ -16,12 +16,12 @@ under the License. .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-mysql`` +------------------------------------------------ 5.1.1 ..... diff --git a/airflow/providers/neo4j/CHANGELOG.rst b/airflow/providers/neo4j/CHANGELOG.rst index c4b031462b175..bf1ac7044607e 100644 --- a/airflow/providers/neo4j/CHANGELOG.rst +++ b/airflow/providers/neo4j/CHANGELOG.rst @@ -18,12 +18,12 @@ under the License. .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-neo4j`` +------------------------------------------------ 3.3.1 ..... diff --git a/airflow/providers/odbc/CHANGELOG.rst b/airflow/providers/odbc/CHANGELOG.rst index 4acfd8996c2da..9e2495ef292bc 100644 --- a/airflow/providers/odbc/CHANGELOG.rst +++ b/airflow/providers/odbc/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-odbc`` +----------------------------------------------- 4.0.0 ..... diff --git a/airflow/providers/openfaas/CHANGELOG.rst b/airflow/providers/openfaas/CHANGELOG.rst index 5968d6c797ce7..5213b63000c8b 100644 --- a/airflow/providers/openfaas/CHANGELOG.rst +++ b/airflow/providers/openfaas/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-openfaas`` +--------------------------------------------------- 3.2.1 ..... diff --git a/airflow/providers/openlineage/CHANGELOG.rst b/airflow/providers/openlineage/CHANGELOG.rst index 8e4a4fb2ea899..c54c6ebc05803 100644 --- a/airflow/providers/openlineage/CHANGELOG.rst +++ b/airflow/providers/openlineage/CHANGELOG.rst @@ -16,12 +16,12 @@ under the License. .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-openlineage`` +------------------------------------------------------ 1.0.0 ..... diff --git a/airflow/providers/opsgenie/CHANGELOG.rst b/airflow/providers/opsgenie/CHANGELOG.rst index 8bb16430d5b5c..69fd9383045e5 100644 --- a/airflow/providers/opsgenie/CHANGELOG.rst +++ b/airflow/providers/opsgenie/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-opsgenie`` +--------------------------------------------------- 5.1.1 ..... diff --git a/airflow/providers/oracle/CHANGELOG.rst b/airflow/providers/oracle/CHANGELOG.rst index 537c48ed3b67b..bc7e86d76c0be 100644 --- a/airflow/providers/oracle/CHANGELOG.rst +++ b/airflow/providers/oracle/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-oracle`` +------------------------------------------------- 3.7.1 ..... diff --git a/airflow/providers/pagerduty/CHANGELOG.rst b/airflow/providers/pagerduty/CHANGELOG.rst index 349c0843cd97c..cddb9e34ee3d0 100644 --- a/airflow/providers/pagerduty/CHANGELOG.rst +++ b/airflow/providers/pagerduty/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-pagerduty`` +---------------------------------------------------- 3.3.0 ..... diff --git a/airflow/providers/papermill/CHANGELOG.rst b/airflow/providers/papermill/CHANGELOG.rst index 7494f2001d12e..933b456a49f49 100644 --- a/airflow/providers/papermill/CHANGELOG.rst +++ b/airflow/providers/papermill/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-papermill`` +---------------------------------------------------- 3.2.1 ..... diff --git a/airflow/providers/plexus/CHANGELOG.rst b/airflow/providers/plexus/CHANGELOG.rst index 280fbb895f56c..d9ed577d220c6 100644 --- a/airflow/providers/plexus/CHANGELOG.rst +++ b/airflow/providers/plexus/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-plexus`` +------------------------------------------------- 3.2.1 ..... diff --git a/airflow/providers/postgres/CHANGELOG.rst b/airflow/providers/postgres/CHANGELOG.rst index 65f6a496a1378..46f391a0fad48 100644 --- a/airflow/providers/postgres/CHANGELOG.rst +++ b/airflow/providers/postgres/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-postgres`` +--------------------------------------------------- 5.5.1 ..... diff --git a/airflow/providers/presto/CHANGELOG.rst b/airflow/providers/presto/CHANGELOG.rst index 7d172fa5eb2da..d35e42c51847d 100644 --- a/airflow/providers/presto/CHANGELOG.rst +++ b/airflow/providers/presto/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-presto`` +------------------------------------------------- 5.1.1 ..... diff --git a/airflow/providers/qubole/CHANGELOG.rst b/airflow/providers/qubole/CHANGELOG.rst index 0ef4af239f389..c8c7c76aa9dc8 100644 --- a/airflow/providers/qubole/CHANGELOG.rst +++ b/airflow/providers/qubole/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-qubole`` +------------------------------------------------- 3.4.1 ..... diff --git a/airflow/providers/redis/CHANGELOG.rst b/airflow/providers/redis/CHANGELOG.rst index c836a108f1663..87b538ec7c075 100644 --- a/airflow/providers/redis/CHANGELOG.rst +++ b/airflow/providers/redis/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-redis`` +------------------------------------------------ 3.2.1 ..... diff --git a/airflow/providers/salesforce/CHANGELOG.rst b/airflow/providers/salesforce/CHANGELOG.rst index fe5b961b41fb9..78505ad7c8701 100644 --- a/airflow/providers/salesforce/CHANGELOG.rst +++ b/airflow/providers/salesforce/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-salesforce`` +----------------------------------------------------- 5.4.1 ..... diff --git a/airflow/providers/samba/CHANGELOG.rst b/airflow/providers/samba/CHANGELOG.rst index 746e88f5d7336..190b1f73f77b6 100644 --- a/airflow/providers/samba/CHANGELOG.rst +++ b/airflow/providers/samba/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-samba`` +------------------------------------------------ 4.2.1 ..... diff --git a/airflow/providers/segment/CHANGELOG.rst b/airflow/providers/segment/CHANGELOG.rst index 3148c8eb4391b..059ae0472defe 100644 --- a/airflow/providers/segment/CHANGELOG.rst +++ b/airflow/providers/segment/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-segment`` +-------------------------------------------------- 3.2.1 ..... diff --git a/airflow/providers/sendgrid/CHANGELOG.rst b/airflow/providers/sendgrid/CHANGELOG.rst index a8ee20f4e8293..7e677678f5dbd 100644 --- a/airflow/providers/sendgrid/CHANGELOG.rst +++ b/airflow/providers/sendgrid/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-sendgrid`` +--------------------------------------------------- 3.2.1 ..... diff --git a/airflow/providers/sftp/CHANGELOG.rst b/airflow/providers/sftp/CHANGELOG.rst index 6f3891b20fbfb..dcea4aad31718 100644 --- a/airflow/providers/sftp/CHANGELOG.rst +++ b/airflow/providers/sftp/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-sftp`` +----------------------------------------------- 4.3.1 ..... diff --git a/airflow/providers/singularity/CHANGELOG.rst b/airflow/providers/singularity/CHANGELOG.rst index 95e463f3104e8..1ad3b4bc1d544 100644 --- a/airflow/providers/singularity/CHANGELOG.rst +++ b/airflow/providers/singularity/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-singularity`` +------------------------------------------------------ 3.2.1 ..... diff --git a/airflow/providers/slack/CHANGELOG.rst b/airflow/providers/slack/CHANGELOG.rst index 19d70f4dcd64e..ca1dc3895dfeb 100644 --- a/airflow/providers/slack/CHANGELOG.rst +++ b/airflow/providers/slack/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-slack`` +------------------------------------------------ 7.3.1 ..... diff --git a/airflow/providers/smtp/CHANGELOG.rst b/airflow/providers/smtp/CHANGELOG.rst index 29bb4951db6aa..103e9a73c3499 100644 --- a/airflow/providers/smtp/CHANGELOG.rst +++ b/airflow/providers/smtp/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-smtp`` +----------------------------------------------- 1.2.0 ..... diff --git a/airflow/providers/snowflake/CHANGELOG.rst b/airflow/providers/snowflake/CHANGELOG.rst index a0272b3987fcd..ee9fca09d8e4f 100644 --- a/airflow/providers/snowflake/CHANGELOG.rst +++ b/airflow/providers/snowflake/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-snowflake`` +---------------------------------------------------- 4.2.0 ..... diff --git a/airflow/providers/sqlite/CHANGELOG.rst b/airflow/providers/sqlite/CHANGELOG.rst index 723cd6347efbe..f84ff50a85557 100644 --- a/airflow/providers/sqlite/CHANGELOG.rst +++ b/airflow/providers/sqlite/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-sqlite`` +------------------------------------------------- 3.4.2 ..... diff --git a/airflow/providers/ssh/CHANGELOG.rst b/airflow/providers/ssh/CHANGELOG.rst index 53f731a66c91a..9accc14048aae 100644 --- a/airflow/providers/ssh/CHANGELOG.rst +++ b/airflow/providers/ssh/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-ssh`` +---------------------------------------------- 3.7.1 ..... diff --git a/airflow/providers/tableau/CHANGELOG.rst b/airflow/providers/tableau/CHANGELOG.rst index 86593829c333e..41af7710de9bc 100644 --- a/airflow/providers/tableau/CHANGELOG.rst +++ b/airflow/providers/tableau/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-tableau`` +-------------------------------------------------- 4.2.1 ..... diff --git a/airflow/providers/tabular/CHANGELOG.rst b/airflow/providers/tabular/CHANGELOG.rst index 5036652714352..9db36926d24e9 100644 --- a/airflow/providers/tabular/CHANGELOG.rst +++ b/airflow/providers/tabular/CHANGELOG.rst @@ -16,12 +16,12 @@ under the License. .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-tabular`` +-------------------------------------------------- 1.2.1 ..... diff --git a/airflow/providers/telegram/CHANGELOG.rst b/airflow/providers/telegram/CHANGELOG.rst index d9fc42be0dae6..dcd21d242ff1b 100644 --- a/airflow/providers/telegram/CHANGELOG.rst +++ b/airflow/providers/telegram/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-telegram`` +--------------------------------------------------- 4.1.1 ..... diff --git a/airflow/providers/trino/CHANGELOG.rst b/airflow/providers/trino/CHANGELOG.rst index 24dcf62259ecc..7e5b05538ebca 100644 --- a/airflow/providers/trino/CHANGELOG.rst +++ b/airflow/providers/trino/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-trino`` +------------------------------------------------ 5.1.1 ..... diff --git a/airflow/providers/vertica/CHANGELOG.rst b/airflow/providers/vertica/CHANGELOG.rst index d2e3c54c49a14..db9a5335b85c8 100644 --- a/airflow/providers/vertica/CHANGELOG.rst +++ b/airflow/providers/vertica/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-vertica`` +-------------------------------------------------- 3.4.1 ..... diff --git a/airflow/providers/yandex/CHANGELOG.rst b/airflow/providers/yandex/CHANGELOG.rst index d24e063b1abb1..8eee1ab6c99ec 100644 --- a/airflow/providers/yandex/CHANGELOG.rst +++ b/airflow/providers/yandex/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-yandex`` +------------------------------------------------- .. note:: This release dropped support for Python 3.7 diff --git a/airflow/providers/zendesk/CHANGELOG.rst b/airflow/providers/zendesk/CHANGELOG.rst index 5ff676b94ce4b..3c9f67d9d042d 100644 --- a/airflow/providers/zendesk/CHANGELOG.rst +++ b/airflow/providers/zendesk/CHANGELOG.rst @@ -17,12 +17,12 @@ .. NOTE TO CONTRIBUTORS: - Please, only add notes to the Changelog just below the "Changelog" header when there are some breaking changes + Please, only add notes to the Changelog just below the "Changelog for ..." header when there are some breaking changes and you want to add an explanation to the users on how they are supposed to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- +Changelog for ``apache-airflow-providers-zendex`` +------------------------------------------------- 4.3.1 ..... diff --git a/dev/breeze/src/airflow_breeze/commands/release_management_commands.py b/dev/breeze/src/airflow_breeze/commands/release_management_commands.py index 234daf6fb5ac4..2f95e73c9e559 100644 --- a/dev/breeze/src/airflow_breeze/commands/release_management_commands.py +++ b/dev/breeze/src/airflow_breeze/commands/release_management_commands.py @@ -241,6 +241,12 @@ def prepare_airflow_packages( is_flag=True, help="Only update minimum version in __init__.py files and regenerate corresponding documentation", ) +@click.option( + "--regenerate-missing-docs", + is_flag=True, + help="Only regenerate missing documentation, do not bump version. Useful if templates were added" + " and you need to regenerate documentation.", +) @option_verbose @option_dry_run @option_answer @@ -250,6 +256,7 @@ def prepare_provider_documentation( debug: bool, packages: list[str], only_min_version_update: bool, + regenerate_missing_docs: bool, ): perform_environment_checks() check_remote_ghcr_io_commands() @@ -260,6 +267,7 @@ def prepare_provider_documentation( python=DEFAULT_PYTHON_MAJOR_MINOR_VERSION, base_branch=base_branch, only_min_version_update=only_min_version_update, + regenerate_missing_docs=regenerate_missing_docs, skip_environment_initialization=True, ) rebuild_or_pull_ci_image_if_needed(command_params=shell_params) diff --git a/dev/breeze/src/airflow_breeze/commands/release_management_commands_config.py b/dev/breeze/src/airflow_breeze/commands/release_management_commands_config.py index 16995784e4a5a..abbe671cb4a23 100644 --- a/dev/breeze/src/airflow_breeze/commands/release_management_commands_config.py +++ b/dev/breeze/src/airflow_breeze/commands/release_management_commands_config.py @@ -101,6 +101,7 @@ "--github-repository", "--base-branch", "--only-min-version-update", + "--regenerate-missing-docs", ], } ], diff --git a/dev/breeze/src/airflow_breeze/params/shell_params.py b/dev/breeze/src/airflow_breeze/params/shell_params.py index cb666752bfcf4..22c3b9057fd5f 100644 --- a/dev/breeze/src/airflow_breeze/params/shell_params.py +++ b/dev/breeze/src/airflow_breeze/params/shell_params.py @@ -123,6 +123,7 @@ class ShellParams: celery_broker: str = DEFAULT_CELERY_BROKER celery_flower: bool = False only_min_version_update: bool = False + regenerate_missing_docs: bool = False def clone_with_test(self, test_type: str) -> ShellParams: new_params = deepcopy(self) diff --git a/dev/breeze/src/airflow_breeze/utils/docker_command_utils.py b/dev/breeze/src/airflow_breeze/utils/docker_command_utils.py index 75d838e9d157e..13cd8f060d320 100644 --- a/dev/breeze/src/airflow_breeze/utils/docker_command_utils.py +++ b/dev/breeze/src/airflow_breeze/utils/docker_command_utils.py @@ -626,6 +626,7 @@ def update_expected_environment_variables(env: dict[str, str]) -> None: set_value_to_default_if_not_set(env, "ONLY_MIN_VERSION_UPDATE", "false") set_value_to_default_if_not_set(env, "PACKAGE_FORMAT", ALLOWED_PACKAGE_FORMATS[0]) set_value_to_default_if_not_set(env, "PYTHONDONTWRITEBYTECODE", "true") + set_value_to_default_if_not_set(env, "REGENERATE_MISSING_DOCS", "false") set_value_to_default_if_not_set(env, "REMOVE_ARM_PACKAGES", "false") set_value_to_default_if_not_set(env, "RUN_SYSTEM_TESTS", "false") set_value_to_default_if_not_set(env, "RUN_TESTS", "false") @@ -673,6 +674,7 @@ def update_expected_environment_variables(env: dict[str, str]) -> None: "MYSQL_VERSION": "mysql_version", "NUM_RUNS": "num_runs", "ONLY_MIN_VERSION_UPDATE": "only_min_version_update", + "REGENERATE_MISSING_DOCS": "regenerate_missing_docs", "PACKAGE_FORMAT": "package_format", "POSTGRES_VERSION": "postgres_version", "PYTHON_MAJOR_MINOR_VERSION": "python", diff --git a/dev/provider_packages/PROVIDER_CHANGELOG_TEMPLATE.rst.jinja2 b/dev/provider_packages/PROVIDER_CHANGELOG_TEMPLATE.rst.jinja2 new file mode 100644 index 0000000000000..81d0e42a23ab4 --- /dev/null +++ b/dev/provider_packages/PROVIDER_CHANGELOG_TEMPLATE.rst.jinja2 @@ -0,0 +1,46 @@ +{# + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + + NOTE! THIS FILE IS AUTOMATICALLY GENERATED AND WILL BE + OVERWRITTEN WHEN PREPARING PACKAGES. + + IF YOU WANT TO MODIFY IT, YOU SHOULD MODIFY THE TEMPLATE + `PROVIDER_CHANGELOG_TEMPLATE.rst.jinja2` IN the `dev/provider_packages` DIRECTORY + +#} + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``{{ PACKAGE_PIP_NAME }}`` +{{ '-' * (12 + PACKAGE_PIP_NAME | length) }} + +.. include:: {{ CHANGELOG_RELATIVE_PATH }}/CHANGELOG.rst diff --git a/dev/provider_packages/PROVIDER_INDEX_TEMPLATE.rst.jinja2 b/dev/provider_packages/PROVIDER_INDEX_TEMPLATE.rst.jinja2 index 51175274ad082..01a34b611860c 100644 --- a/dev/provider_packages/PROVIDER_INDEX_TEMPLATE.rst.jinja2 +++ b/dev/provider_packages/PROVIDER_INDEX_TEMPLATE.rst.jinja2 @@ -25,6 +25,7 @@ #} .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -90,5 +91,3 @@ You can download officially released packages and verify their checksums and sig {%- endif %} - -.. include:: {{ CHANGELOG_RELATIVE_PATH }}/CHANGELOG.rst diff --git a/dev/provider_packages/PROVIDER_README_TEMPLATE.rst.jinja2 b/dev/provider_packages/PROVIDER_README_TEMPLATE.rst.jinja2 index 3d1751e913c31..4bc7887d97868 100644 --- a/dev/provider_packages/PROVIDER_README_TEMPLATE.rst.jinja2 +++ b/dev/provider_packages/PROVIDER_README_TEMPLATE.rst.jinja2 @@ -23,6 +23,23 @@ `PROVIDER_INDEX_TEMPLATE.rst.jinja2` IN the `dev/provider_packages` DIRECTORY #} + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + Package ``{{ PACKAGE_PIP_NAME }}`` @@ -77,4 +94,5 @@ You can install such cross-provider dependencies when installing from PyPI. For {%- endif %} -{{ CHANGELOG | safe }} +The changelog for the provider package can be found in the +`changelog `_. diff --git a/dev/provider_packages/PROVIDER_SECURITY_TEMPLATE.rst.jinja2 b/dev/provider_packages/PROVIDER_SECURITY_TEMPLATE.rst.jinja2 new file mode 100644 index 0000000000000..56039a7761c0b --- /dev/null +++ b/dev/provider_packages/PROVIDER_SECURITY_TEMPLATE.rst.jinja2 @@ -0,0 +1,62 @@ +{# + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + + NOTE! THIS FILE IS AUTOMATICALLY GENERATED AND WILL BE + OVERWRITTEN WHEN PREPARING PACKAGES. + + IF YOU WANT TO MODIFY IT, YOU SHOULD MODIFY THE TEMPLATE + `PROVIDER_SECURITY_TEMPLATE.rst.jinja2` IN the `dev/provider_packages` DIRECTORY + +#} + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/dev/provider_packages/SETUP_TEMPLATE.cfg.jinja2 b/dev/provider_packages/SETUP_TEMPLATE.cfg.jinja2 index 5fb6a9c74d321..c3fdba076b568 100644 --- a/dev/provider_packages/SETUP_TEMPLATE.cfg.jinja2 +++ b/dev/provider_packages/SETUP_TEMPLATE.cfg.jinja2 @@ -51,6 +51,7 @@ classifiers = Topic :: System :: Monitoring project_urls= Documentation=https://airflow.apache.org/docs/{{ PACKAGE_PIP_NAME }}/{{RELEASE}}/ + Changelog=https://airflow.apache.org/docs/{{ PACKAGE_PIP_NAME }}/{{RELEASE}}/changelog.html Bug Tracker=https://github.com/apache/airflow/issues Source Code=https://github.com/apache/airflow Slack Chat=https://s.apache.org/airflow-slack diff --git a/dev/provider_packages/prepare_provider_packages.py b/dev/provider_packages/prepare_provider_packages.py index 76fd3f99a1275..8bf6e24852dc9 100755 --- a/dev/provider_packages/prepare_provider_packages.py +++ b/dev/provider_packages/prepare_provider_packages.py @@ -43,6 +43,7 @@ from shutil import copyfile from typing import Any, Generator, Iterable, NamedTuple +import jinja2 import jsonschema import rich_click as click import semver as semver @@ -61,8 +62,6 @@ MIN_AIRFLOW_VERSION_EXCEPTIONS = {"openlineage": "2.6.0"} INITIAL_CHANGELOG_CONTENT = """ - - .. Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information @@ -80,9 +79,14 @@ specific language governing permissions and limitations under the License. +.. NOTE TO CONTRIBUTORS: + Please, only add notes to the Changelog just below the "Changelog for ..." header when there + are some breaking changes and you want to add an explanation to the users on how they are supposed + to deal with them. The changelog is updated and maintained semi-automatically by release manager. -Changelog ---------- + +Changelog for ``{{ package_name }}`` +{{ '-' * (18 + package_name | length) }} 1.0.0 ..... @@ -142,7 +146,7 @@ class ProviderPackageDetails(NamedTuple): full_package_name: str pypi_package_name: str source_provider_package_path: str - documentation_provider_package_path: str + documentation_provider_package_path: Path provider_description: str versions: list[str] excluded_python_versions: list[str] @@ -830,15 +834,13 @@ def get_source_package_path(provider_package_id: str) -> str: return os.path.join(PROVIDERS_PATH, *provider_package_id.split(".")) -def get_documentation_package_path(provider_package_id: str) -> str: +def get_documentation_package_path(provider_package_id: str) -> Path: """Retrieves documentation package path from package id. :param provider_package_id: id of the package :return: path of the documentation folder """ - return os.path.join( - DOCUMENTATION_PATH, f"apache-airflow-providers-{provider_package_id.replace('.','-')}" - ) + return DOCUMENTATION_PATH / f"apache-airflow-providers-{provider_package_id.replace('.','-')}" def get_generated_package_path(provider_package_id: str) -> str: @@ -946,19 +948,21 @@ def get_all_changes_for_package( provider_package_id: str, verbose: bool, base_branch: str, + force: bool, ) -> tuple[bool, list[list[Change]] | Change | None, str]: """Retrieves all changes for the package. :param provider_package_id: provider package id - :param base_branch: base branch to check changes in apache remote for changes :param verbose: whether to print verbose messages + :param base_branch: base branch to check changes in apache remote for changes + :param force: whether to force the check even if the tag exists """ provider_details = get_provider_details(provider_package_id) current_version = provider_details.versions[0] current_tag_no_suffix = get_version_tag(current_version, provider_package_id) if verbose: console.print(f"Checking if tag '{current_tag_no_suffix}' exist.") - if not subprocess.call( + if not force and not subprocess.call( get_git_tag_check_command(current_tag_no_suffix), cwd=provider_details.source_provider_package_path, stderr=subprocess.DEVNULL, @@ -1275,6 +1279,7 @@ def update_release_notes( verbose: bool, answer: str | None, base_branch: str, + regenerate_missing_docs: bool, ) -> bool: """Updates generated files. @@ -1286,10 +1291,13 @@ def update_release_notes( :param verbose: whether to print verbose messages :param answer: force answer to question if set. :param base_branch: base branch to check changes in apache remote for changes + :param regenerate_missing_docs: whether to regenerate missing docs :returns False if the package should be skipped, True if everything generated properly """ verify_provider_package(provider_package_id) - proceed, latest_change, changes = get_all_changes_for_package(provider_package_id, verbose, base_branch) + proceed, latest_change, changes = get_all_changes_for_package( + provider_package_id, verbose, base_branch, force + ) if not force: if proceed: if not confirm("Provider marked for release. Proceed", answer=answer): @@ -1317,7 +1325,7 @@ def update_release_notes( elif type_of_change in [TypeOfChange.BUGFIX, TypeOfChange.FEATURE, TypeOfChange.BREAKING_CHANGE]: add_new_version(type_of_change, provider_package_id) proceed, latest_change, changes = get_all_changes_for_package( - provider_package_id, verbose, base_branch + provider_package_id, verbose, base_branch, force ) provider_details = get_provider_details(provider_package_id) provider_info = get_provider_info_from_provider_yaml(provider_package_id) @@ -1329,9 +1337,25 @@ def update_release_notes( ) jinja_context["DETAILED_CHANGES_RST"] = changes jinja_context["DETAILED_CHANGES_PRESENT"] = len(changes) > 0 - update_commits_rst( - jinja_context, provider_package_id, provider_details.documentation_provider_package_path + update_changelog_rst( + jinja_context, + provider_package_id, + provider_details.documentation_provider_package_path, + regenerate_missing_docs, + ) + update_security_rst( + jinja_context, + provider_package_id, + provider_details.documentation_provider_package_path, + regenerate_missing_docs, ) + if not force: + update_commits_rst( + jinja_context, + provider_package_id, + provider_details.documentation_provider_package_path, + regenerate_missing_docs, + ) return True @@ -1409,9 +1433,9 @@ def replace_content(file_path, old_text, new_text, provider_package_id): def update_index_rst( - context, - provider_package_id, - target_path, + context: dict[str, Any], + provider_package_id: str, + target_path: Path, ): index_update = render_template( template_name="PROVIDER_INDEX", context=context, extension=".rst", keep_trailing_newline=True @@ -1431,20 +1455,78 @@ def update_index_rst( replace_content(index_file_path, old_text, new_text, provider_package_id) -def update_commits_rst( - context, - provider_package_id, - target_path, +def _update_file( + context: dict[str, Any], + template_name: str, + extension: str, + file_name: str, + provider_package_id: str, + target_path: Path, + regenerate_missing_docs: bool, ): + file_path = target_path / file_name + if regenerate_missing_docs and file_path.exists(): + return new_text = render_template( - template_name="PROVIDER_COMMITS", context=context, extension=".rst", keep_trailing_newline=True + template_name=template_name, context=context, extension=extension, keep_trailing_newline=True ) - index_file_path = os.path.join(target_path, "commits.rst") + file_path = target_path / file_name old_text = "" - if os.path.isfile(index_file_path): - with open(index_file_path) as readme_file_read: + if os.path.isfile(file_path): + with open(file_path) as readme_file_read: old_text = readme_file_read.read() - replace_content(index_file_path, old_text, new_text, provider_package_id) + replace_content(file_path, old_text, new_text, provider_package_id) + + +def update_changelog_rst( + context: dict[str, Any], + provider_package_id: str, + target_path: Path, + regenerate_missing_docs: bool, +): + _update_file( + context=context, + template_name="PROVIDER_CHANGELOG", + extension=".rst", + file_name="changelog.rst", + provider_package_id=provider_package_id, + target_path=target_path, + regenerate_missing_docs=regenerate_missing_docs, + ) + + +def update_security_rst( + context: dict[str, Any], + provider_package_id: str, + target_path: Path, + regenerate_missing_docs: bool, +): + _update_file( + context=context, + template_name="PROVIDER_SECURITY", + extension=".rst", + file_name="security.rst", + provider_package_id=provider_package_id, + target_path=target_path, + regenerate_missing_docs=regenerate_missing_docs, + ) + + +def update_commits_rst( + context: dict[str, Any], + provider_package_id: str, + target_path: Path, + regenerate_missing_docs: bool, +): + _update_file( + context=context, + template_name="PROVIDER_COMMITS", + extension=".rst", + file_name="commits.rst", + provider_package_id=provider_package_id, + target_path=target_path, + regenerate_missing_docs=regenerate_missing_docs, + ) def replace_min_airflow_version_in_provider_yaml( @@ -1572,17 +1654,20 @@ def verify_changelog_exists(package: str) -> str: provider_details = get_provider_details(package) changelog_path = os.path.join(provider_details.source_provider_package_path, "CHANGELOG.rst") if not os.path.isfile(changelog_path): - console.print(f"[red]ERROR: Missing ${changelog_path}[/]") - console.print("Please add the file with initial content:") - console.print() + console.print(f"\n[red]ERROR: Missing {changelog_path}[/]\n") + console.print("[info]Please add the file with initial content:") + console.print("----- START COPYING AFTER THIS LINE ------- ") + processed_changelog = jinja2.Template(INITIAL_CHANGELOG_CONTENT, autoescape=True).render( + package_name=provider_details.pypi_package_name, + ) syntax = Syntax( - INITIAL_CHANGELOG_CONTENT, + processed_changelog, "rst", theme="ansi_dark", ) console.print(syntax) - console.print() - raise Exception(f"Missing {changelog_path}") + console.print("----- END COPYING BEFORE THIS LINE ------- ") + sys.exit(1) return changelog_path @@ -1631,14 +1716,16 @@ def update_package_documentation( console.print("Updating documentation for the latest release version.") make_sure_remote_apache_exists_and_fetch(git_update, verbose) only_min_version_upgrade = os.environ.get("ONLY_MIN_VERSION_UPDATE", "false").lower() == "true" + regenerate_missing_docs = os.environ.get("REGENERATE_MISSING_DOCS", "false").lower() == "true" if not only_min_version_upgrade: if not update_release_notes( provider_package_id, version_suffix, - force=force, + force=force or regenerate_missing_docs, verbose=verbose, answer=answer, base_branch=base_branch, + regenerate_missing_docs=regenerate_missing_docs, ): # Returns 64 in case of skipped package sys.exit(64) @@ -1853,11 +1940,11 @@ def get_changes_classified(changes: list[Change]) -> ClassifiedChanges: @option_verbose def update_changelog(package_id: str, base_branch: str, verbose: bool): """Updates changelog for the provider.""" - if _update_changelog(package_id, base_branch, verbose): + if _update_changelog(package_id, base_branch, verbose, True): sys.exit(64) -def _update_changelog(package_id: str, base_branch: str, verbose: bool) -> bool: +def _update_changelog(package_id: str, base_branch: str, verbose: bool, force: bool) -> bool: """Internal update changelog method. :param package_id: package id @@ -1877,13 +1964,22 @@ def _update_changelog(package_id: str, base_branch: str, verbose: bool) -> bool: version_suffix="", ) changelog_path = os.path.join(provider_details.source_provider_package_path, "CHANGELOG.rst") - proceed, changes, _ = get_all_changes_for_package(package_id, verbose, base_branch) + proceed, changes, _ = get_all_changes_for_package(package_id, verbose, base_branch, force) if not proceed: - console.print( - f"[yellow]The provider {package_id} is not being released. Skipping the package.[/]" - ) + if force: + console.print( + f"[info]The provider {package_id} is not being release but we regenerate docs for it " + f"(except commits).[/]" + ) + else: + console.print( + f"[yellow]The provider {package_id} is not being released. Skipping the package.[/]" + ) return True - generate_new_changelog(package_id, provider_details, changelog_path, changes) + if os.environ.get("REGENERATE_MISSING_DOCS", "false").lower() == "true": + console.print("[info]REGENERATE_MISSING_DOCS is set to true, skipping changelog update[/]") + else: + generate_new_changelog(package_id, provider_details, changelog_path, changes) console.print() console.print(f"Update index.rst for {package_id}") console.print() @@ -1969,7 +2065,7 @@ def update_changelogs(changelog_files: list[str], git_update: bool, base_branch: make_sure_remote_apache_exists_and_fetch(git_update, verbose) for changelog_file in changelog_files: package_id = get_package_from_changelog(changelog_file) - _update_changelog(package_id=package_id, base_branch=base_branch, verbose=verbose) + _update_changelog(package_id=package_id, base_branch=base_branch, verbose=verbose, force=True) if __name__ == "__main__": diff --git a/docs/apache-airflow-providers-airbyte/changelog.rst b/docs/apache-airflow-providers-airbyte/changelog.rst new file mode 100644 index 0000000000000..df72f14d050ea --- /dev/null +++ b/docs/apache-airflow-providers-airbyte/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-airbyte`` +-------------------------------------------- + +.. include:: ../../airflow/providers/airbyte/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-airbyte/index.rst b/docs/apache-airflow-providers-airbyte/index.rst index bd27d6cc75d31..0d4e5d99fcf45 100644 --- a/docs/apache-airflow-providers-airbyte/index.rst +++ b/docs/apache-airflow-providers-airbyte/index.rst @@ -18,10 +18,18 @@ ``apache-airflow-providers-airbyte`` ==================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -29,6 +37,7 @@ Content Connection types .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -36,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/airbyte/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -118,5 +130,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-airbyte 3.3.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-airbyte 3.3.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/airbyte/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-airbyte/security.rst b/docs/apache-airflow-providers-airbyte/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-airbyte/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-alibaba/changelog.rst b/docs/apache-airflow-providers-alibaba/changelog.rst new file mode 100644 index 0000000000000..c032cb7d6a486 --- /dev/null +++ b/docs/apache-airflow-providers-alibaba/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-alibaba`` +-------------------------------------------- + +.. include:: ../../airflow/providers/alibaba/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-alibaba/index.rst b/docs/apache-airflow-providers-alibaba/index.rst index c050e7e9da753..2b468623ff99d 100644 --- a/docs/apache-airflow-providers-alibaba/index.rst +++ b/docs/apache-airflow-providers-alibaba/index.rst @@ -18,10 +18,18 @@ ``apache-airflow-providers-alibaba`` ==================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Logging for Tasks .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/alibaba/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -93,5 +105,3 @@ PIP package Version required ``alibabacloud_adb20211201`` ``>=1.0.0`` ``alibabacloud_tea_openapi`` ``>=0.3.7`` ============================ ================== - -.. include:: ../../airflow/providers/alibaba/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-alibaba/security.rst b/docs/apache-airflow-providers-alibaba/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-alibaba/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-amazon/changelog.rst b/docs/apache-airflow-providers-amazon/changelog.rst new file mode 100644 index 0000000000000..aed399da661ef --- /dev/null +++ b/docs/apache-airflow-providers-amazon/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-amazon`` +------------------------------------------- + +.. include:: ../../airflow/providers/amazon/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-amazon/index.rst b/docs/apache-airflow-providers-amazon/index.rst index e0b148425c035..e4fd28da4a369 100644 --- a/docs/apache-airflow-providers-amazon/index.rst +++ b/docs/apache-airflow-providers-amazon/index.rst @@ -18,10 +18,18 @@ ``apache-airflow-providers-amazon`` =================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -33,24 +41,22 @@ Content Logging for Tasks .. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/amazon/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: System tests + System Tests <_api/tests/system/providers/amazon/index> System Tests Dashboard .. toctree:: :hidden: - :caption: System tests - - System Tests <_api/tests/system/providers/amazon/index> - -.. toctree:: :maxdepth: 1 :caption: Resources @@ -62,6 +68,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -149,5 +156,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-amazon 8.2.0 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-amazon 8.2.0 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/amazon/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-amazon/security.rst b/docs/apache-airflow-providers-amazon/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-amazon/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-beam/changelog.rst b/docs/apache-airflow-providers-apache-beam/changelog.rst new file mode 100644 index 0000000000000..f8bf09df1c3ab --- /dev/null +++ b/docs/apache-airflow-providers-apache-beam/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-beam`` +------------------------------------------------ + +.. include:: ../../airflow/providers/apache/beam/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-beam/index.rst b/docs/apache-airflow-providers-apache-beam/index.rst index 30ceaf0868993..3ca1179cae918 100644 --- a/docs/apache-airflow-providers-apache-beam/index.rst +++ b/docs/apache-airflow-providers-apache-beam/index.rst @@ -18,10 +18,18 @@ ``apache-airflow-providers-apache-beam`` ======================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -29,11 +37,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/apache/beam/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -41,6 +51,7 @@ Content Example DAGs .. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -51,6 +62,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -117,5 +129,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-apache-beam 5.1.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-apache-beam 5.1.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/apache/beam/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-beam/security.rst b/docs/apache-airflow-providers-apache-beam/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-beam/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-cassandra/changelog.rst b/docs/apache-airflow-providers-apache-cassandra/changelog.rst new file mode 100644 index 0000000000000..ff78c1158e3ee --- /dev/null +++ b/docs/apache-airflow-providers-apache-cassandra/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-cassandra`` +----------------------------------------------------- + +.. include:: ../../airflow/providers/apache/cassandra/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-cassandra/index.rst b/docs/apache-airflow-providers-apache-cassandra/index.rst index d33605c9fcfcc..81e6cc6aa8738 100644 --- a/docs/apache-airflow-providers-apache-cassandra/index.rst +++ b/docs/apache-airflow-providers-apache-cassandra/index.rst @@ -18,10 +18,18 @@ ``apache-airflow-providers-apache-cassandra`` ============================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -29,6 +37,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -36,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/apache/cassandra/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -90,5 +102,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``cassandra-driver`` ``>=3.13.0`` ==================== ================== - -.. include:: ../../airflow/providers/apache/cassandra/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-cassandra/security.rst b/docs/apache-airflow-providers-apache-cassandra/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-cassandra/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-drill/changelog.rst b/docs/apache-airflow-providers-apache-drill/changelog.rst new file mode 100644 index 0000000000000..d1cdd2f3040d6 --- /dev/null +++ b/docs/apache-airflow-providers-apache-drill/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-drill`` +------------------------------------------------- + +.. include:: ../../airflow/providers/apache/drill/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-drill/index.rst b/docs/apache-airflow-providers-apache-drill/index.rst index 461f5c009eb7f..c36ef96f894b1 100644 --- a/docs/apache-airflow-providers-apache-drill/index.rst +++ b/docs/apache-airflow-providers-apache-drill/index.rst @@ -18,10 +18,18 @@ ``apache-airflow-providers-apache-drill`` ========================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -29,6 +37,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -36,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/apache/drill/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -119,5 +131,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-apache-drill 2.4.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-apache-drill 2.4.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/apache/drill/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-drill/security.rst b/docs/apache-airflow-providers-apache-drill/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-drill/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-druid/changelog.rst b/docs/apache-airflow-providers-apache-druid/changelog.rst new file mode 100644 index 0000000000000..a77d36598a8e3 --- /dev/null +++ b/docs/apache-airflow-providers-apache-druid/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-druid`` +------------------------------------------------- + +.. include:: ../../airflow/providers/apache/druid/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-druid/index.rst b/docs/apache-airflow-providers-apache-druid/index.rst index 967203ca639ae..5c5771d7028e9 100644 --- a/docs/apache-airflow-providers-apache-druid/index.rst +++ b/docs/apache-airflow-providers-apache-druid/index.rst @@ -18,16 +18,25 @@ ``apache-airflow-providers-apache-druid`` ========================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -35,12 +44,14 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/apache/druid/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -120,5 +132,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-apache-druid 3.4.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-apache-druid 3.4.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/apache/druid/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-druid/security.rst b/docs/apache-airflow-providers-apache-druid/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-druid/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-flink/changelog.rst b/docs/apache-airflow-providers-apache-flink/changelog.rst new file mode 100644 index 0000000000000..5738f55e53d23 --- /dev/null +++ b/docs/apache-airflow-providers-apache-flink/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-flink`` +------------------------------------------------- + +.. include:: ../../airflow/providers/apache/flink/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-flink/index.rst b/docs/apache-airflow-providers-apache-flink/index.rst index cb5958b778bac..0a50ed7491793 100644 --- a/docs/apache-airflow-providers-apache-flink/index.rst +++ b/docs/apache-airflow-providers-apache-flink/index.rst @@ -18,22 +18,32 @@ ``apache-airflow-providers-apache-flink`` ========================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/apache/flink/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -45,6 +55,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -112,5 +123,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-apache-flink 1.1.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-apache-flink 1.1.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/apache/flink/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-flink/security.rst b/docs/apache-airflow-providers-apache-flink/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-flink/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-hdfs/changelog.rst b/docs/apache-airflow-providers-apache-hdfs/changelog.rst new file mode 100644 index 0000000000000..85395a91c9199 --- /dev/null +++ b/docs/apache-airflow-providers-apache-hdfs/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-hdfs`` +------------------------------------------------ + +.. include:: ../../airflow/providers/apache/hdfs/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-hdfs/index.rst b/docs/apache-airflow-providers-apache-hdfs/index.rst index 00c9dba631b56..6178e9c5d7129 100644 --- a/docs/apache-airflow-providers-apache-hdfs/index.rst +++ b/docs/apache-airflow-providers-apache-hdfs/index.rst @@ -19,10 +19,18 @@ ======================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -31,6 +39,7 @@ Content Logging for Tasks .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -42,6 +51,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -81,5 +91,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``hdfs[avro,dataframe,kerberos]`` ``>=2.0.4`` ================================= ================== - -.. include:: ../../airflow/providers/apache/hdfs/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-hdfs/security.rst b/docs/apache-airflow-providers-apache-hdfs/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-hdfs/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-hive/changelog.rst b/docs/apache-airflow-providers-apache-hive/changelog.rst new file mode 100644 index 0000000000000..d93dba54e3974 --- /dev/null +++ b/docs/apache-airflow-providers-apache-hive/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-hive`` +------------------------------------------------ + +.. include:: ../../airflow/providers/apache/hive/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-hive/index.rst b/docs/apache-airflow-providers-apache-hive/index.rst index da4d4e397ddc6..76ea9a6f4ea4e 100644 --- a/docs/apache-airflow-providers-apache-hive/index.rst +++ b/docs/apache-airflow-providers-apache-hive/index.rst @@ -19,10 +19,18 @@ ======================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/apache/hive/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -54,6 +65,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -131,5 +143,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-apache-hive 6.1.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-apache-hive 6.1.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/apache/hive/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-hive/security.rst b/docs/apache-airflow-providers-apache-hive/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-hive/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-impala/changelog.rst b/docs/apache-airflow-providers-apache-impala/changelog.rst new file mode 100644 index 0000000000000..5f504622be8a7 --- /dev/null +++ b/docs/apache-airflow-providers-apache-impala/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-impala`` +-------------------------------------------------- + +.. include:: ../../airflow/providers/apache/impala/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-impala/index.rst b/docs/apache-airflow-providers-apache-impala/index.rst index 516043d5a5c83..c9a6b364dd904 100644 --- a/docs/apache-airflow-providers-apache-impala/index.rst +++ b/docs/apache-airflow-providers-apache-impala/index.rst @@ -19,22 +19,32 @@ ========================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Connection Types .. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API<_api/airflow/providers/apache/impala/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -42,6 +52,7 @@ Content Installing from sources .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -51,6 +62,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -117,5 +129,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-apache-impala 1.1.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-apache-impala 1.1.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/apache/impala/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-impala/security.rst b/docs/apache-airflow-providers-apache-impala/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-impala/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-kafka/changelog.rst b/docs/apache-airflow-providers-apache-kafka/changelog.rst new file mode 100644 index 0000000000000..b2b294b36cc4f --- /dev/null +++ b/docs/apache-airflow-providers-apache-kafka/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-kafka`` +------------------------------------------------- + +.. include:: ../../airflow/providers/apache/kafka/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-kafka/index.rst b/docs/apache-airflow-providers-apache-kafka/index.rst index 278a3accb2ab9..2c56ce00460f2 100644 --- a/docs/apache-airflow-providers-apache-kafka/index.rst +++ b/docs/apache-airflow-providers-apache-kafka/index.rst @@ -18,10 +18,18 @@ ``apache-airflow-providers-apache-kafka`` ========================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -34,6 +42,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -41,12 +50,14 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/apache/kafka/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -58,6 +69,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -97,5 +109,3 @@ PIP package Version required ``asgiref`` ``confluent-kafka`` ``>=1.8.2`` =================== ================== - -.. include:: ../../airflow/providers/apache/kafka/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-kafka/security.rst b/docs/apache-airflow-providers-apache-kafka/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-kafka/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-kylin/changelog.rst b/docs/apache-airflow-providers-apache-kylin/changelog.rst new file mode 100644 index 0000000000000..30e11d3bde01d --- /dev/null +++ b/docs/apache-airflow-providers-apache-kylin/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-kylin`` +------------------------------------------------- + +.. include:: ../../airflow/providers/apache/kylin/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-kylin/index.rst b/docs/apache-airflow-providers-apache-kylin/index.rst index 6312c91ebd8fe..faac30969b430 100644 --- a/docs/apache-airflow-providers-apache-kylin/index.rst +++ b/docs/apache-airflow-providers-apache-kylin/index.rst @@ -19,10 +19,18 @@ ========================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -30,11 +38,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/apache/kylin/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -46,6 +56,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -84,5 +95,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``kylinpy`` ``>=2.6`` ================== ================== - -.. include:: ../../airflow/providers/apache/kylin/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-kylin/security.rst b/docs/apache-airflow-providers-apache-kylin/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-kylin/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-livy/changelog.rst b/docs/apache-airflow-providers-apache-livy/changelog.rst new file mode 100644 index 0000000000000..1e0af37c44c6b --- /dev/null +++ b/docs/apache-airflow-providers-apache-livy/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-livy`` +------------------------------------------------ + +.. include:: ../../airflow/providers/apache/livy/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-livy/index.rst b/docs/apache-airflow-providers-apache-livy/index.rst index fcfd569ad0be1..4db63c3ae9085 100644 --- a/docs/apache-airflow-providers-apache-livy/index.rst +++ b/docs/apache-airflow-providers-apache-livy/index.rst @@ -18,16 +18,25 @@ ``apache-airflow-providers-apache-livy`` ======================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -35,11 +44,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/apache/livy/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -51,6 +62,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -119,5 +131,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-apache-livy 3.5.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-apache-livy 3.5.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/apache/livy/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-livy/security.rst b/docs/apache-airflow-providers-apache-livy/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-livy/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-pig/changelog.rst b/docs/apache-airflow-providers-apache-pig/changelog.rst new file mode 100644 index 0000000000000..355f67835bf7a --- /dev/null +++ b/docs/apache-airflow-providers-apache-pig/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-pig`` +----------------------------------------------- + +.. include:: ../../airflow/providers/apache/pig/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-pig/index.rst b/docs/apache-airflow-providers-apache-pig/index.rst index 554c54ac1d04a..19e6b16613c23 100644 --- a/docs/apache-airflow-providers-apache-pig/index.rst +++ b/docs/apache-airflow-providers-apache-pig/index.rst @@ -18,16 +18,25 @@ ``apache-airflow-providers-apache-pig`` ======================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -35,11 +44,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/apache/pig/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -51,6 +62,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -88,5 +100,3 @@ PIP package Version required ================== ================== ``apache-airflow`` ``>=2.4.0`` ================== ================== - -.. include:: ../../airflow/providers/apache/pig/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-pig/security.rst b/docs/apache-airflow-providers-apache-pig/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-pig/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-pinot/changelog.rst b/docs/apache-airflow-providers-apache-pinot/changelog.rst new file mode 100644 index 0000000000000..4e510c766ef07 --- /dev/null +++ b/docs/apache-airflow-providers-apache-pinot/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-pinot`` +------------------------------------------------- + +.. include:: ../../airflow/providers/apache/pinot/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-pinot/index.rst b/docs/apache-airflow-providers-apache-pinot/index.rst index b0f9b2c3aa822..83c7899d567dc 100644 --- a/docs/apache-airflow-providers-apache-pinot/index.rst +++ b/docs/apache-airflow-providers-apache-pinot/index.rst @@ -18,15 +18,25 @@ ``apache-airflow-providers-apache-pinot`` ========================================= -Content -------- + .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,6 +47,7 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/apache/pinot/index> @@ -45,6 +56,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -112,5 +124,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-apache-pinot 4.1.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-apache-pinot 4.1.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/apache/pinot/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-pinot/security.rst b/docs/apache-airflow-providers-apache-pinot/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-pinot/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-spark/changelog.rst b/docs/apache-airflow-providers-apache-spark/changelog.rst new file mode 100644 index 0000000000000..9817d195020df --- /dev/null +++ b/docs/apache-airflow-providers-apache-spark/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-spark`` +------------------------------------------------- + +.. include:: ../../airflow/providers/apache/spark/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-spark/index.rst b/docs/apache-airflow-providers-apache-spark/index.rst index da58352a8fc46..1bd8a1def93cb 100644 --- a/docs/apache-airflow-providers-apache-spark/index.rst +++ b/docs/apache-airflow-providers-apache-spark/index.rst @@ -18,10 +18,18 @@ ``apache-airflow-providers-apache-spark`` ========================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -29,6 +37,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -36,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/apache/spark/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -90,5 +102,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``pyspark`` ================== ================== - -.. include:: ../../airflow/providers/apache/spark/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-spark/security.rst b/docs/apache-airflow-providers-apache-spark/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-spark/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apache-sqoop/changelog.rst b/docs/apache-airflow-providers-apache-sqoop/changelog.rst new file mode 100644 index 0000000000000..b17af28da0e92 --- /dev/null +++ b/docs/apache-airflow-providers-apache-sqoop/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apache-sqoop`` +------------------------------------------------- + +.. include:: ../../airflow/providers/apache/sqoop/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-sqoop/index.rst b/docs/apache-airflow-providers-apache-sqoop/index.rst index 0d627bf7c146d..b855d24edc9a8 100644 --- a/docs/apache-airflow-providers-apache-sqoop/index.rst +++ b/docs/apache-airflow-providers-apache-sqoop/index.rst @@ -18,9 +18,18 @@ ``apache-airflow-providers-apache-sqoop`` ========================================= -Content -------- + +.. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + .. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -28,6 +37,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -39,6 +49,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -76,5 +87,3 @@ PIP package Version required ================== ================== ``apache-airflow`` ``>=2.4.0`` ================== ================== - -.. include:: ../../airflow/providers/apache/sqoop/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apache-sqoop/security.rst b/docs/apache-airflow-providers-apache-sqoop/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apache-sqoop/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-apprise/changelog.rst b/docs/apache-airflow-providers-apprise/changelog.rst new file mode 100644 index 0000000000000..3dc9d66f9f63c --- /dev/null +++ b/docs/apache-airflow-providers-apprise/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-apprise`` +-------------------------------------------- + +.. include:: ../../airflow/providers/apprise/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-apprise/index.rst b/docs/apache-airflow-providers-apprise/index.rst index 36cec302cb0a5..36e314095bc57 100644 --- a/docs/apache-airflow-providers-apprise/index.rst +++ b/docs/apache-airflow-providers-apprise/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-apprise`` ====================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -37,6 +46,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -71,3 +81,47 @@ PIP package Version required ================== ================== ``apache-airflow`` ``>=2.4.0`` ================== ================== + +.. THE REMAINDER OF THE FILE IS AUTOMATICALLY GENERATED. IT WILL BE OVERWRITTEN AT RELEASE TIME! + + +.. toctree:: + :hidden: + :maxdepth: 1 + :caption: Commits + + Detailed list of commits + + +Package apache-airflow-providers-apprise +------------------------------------------------------ + +`Apprise `__ + + +Release: 1.0.0 + +Provider package +---------------- + +This is a provider package for ``apprise`` provider. All classes for this provider package +are in ``airflow.providers.apprise`` python package. + +Installation +------------ + +You can install this package on top of an existing Airflow 2 installation (see ``Requirements`` below) +for the minimum Airflow version supported) via +``pip install apache-airflow-providers-apprise`` + +Requirements +------------ + +The minimum Apache Airflow version supported by this provider package is ``2.4.0``. + +================== ================== +PIP package Version required +================== ================== +``apache-airflow`` ``>=2.4.0`` +``apprise`` +================== ================== diff --git a/docs/apache-airflow-providers-apprise/security.rst b/docs/apache-airflow-providers-apprise/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-apprise/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-arangodb/changelog.rst b/docs/apache-airflow-providers-arangodb/changelog.rst new file mode 100644 index 0000000000000..53d58b062323c --- /dev/null +++ b/docs/apache-airflow-providers-arangodb/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-arangodb`` +--------------------------------------------- + +.. include:: ../../airflow/providers/arangodb/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-arangodb/index.rst b/docs/apache-airflow-providers-arangodb/index.rst index 2e926f8746c25..6a515c9d95d65 100644 --- a/docs/apache-airflow-providers-arangodb/index.rst +++ b/docs/apache-airflow-providers-arangodb/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-arangodb`` ===================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,18 +38,21 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/arangodb/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources Example DAGs .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -90,5 +102,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``python-arango`` ``>=7.3.2`` ================== ================== - -.. include:: ../../airflow/providers/arangodb/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-arangodb/security.rst b/docs/apache-airflow-providers-arangodb/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-arangodb/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-asana/changelog.rst b/docs/apache-airflow-providers-asana/changelog.rst new file mode 100644 index 0000000000000..f27de03b77d9f --- /dev/null +++ b/docs/apache-airflow-providers-asana/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-asana`` +------------------------------------------ + +.. include:: ../../airflow/providers/asana/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-asana/index.rst b/docs/apache-airflow-providers-asana/index.rst index 447e19066d43c..8c901f39c2c3b 100644 --- a/docs/apache-airflow-providers-asana/index.rst +++ b/docs/apache-airflow-providers-asana/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-asana`` ================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/asana/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -91,5 +103,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``asana`` ``>=0.10`` ================== ================== - -.. include:: ../../airflow/providers/asana/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-asana/security.rst b/docs/apache-airflow-providers-asana/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-asana/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-atlassian-jira/changelog.rst b/docs/apache-airflow-providers-atlassian-jira/changelog.rst new file mode 100644 index 0000000000000..f5b77baa5dc9c --- /dev/null +++ b/docs/apache-airflow-providers-atlassian-jira/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-atlassian-jira`` +--------------------------------------------------- + +.. include:: ../../airflow/providers/atlassian/jira/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-atlassian-jira/index.rst b/docs/apache-airflow-providers-atlassian-jira/index.rst index 9f73c3bd832f3..62d9eff1614f4 100644 --- a/docs/apache-airflow-providers-atlassian-jira/index.rst +++ b/docs/apache-airflow-providers-atlassian-jira/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-atlassian-jira`` =========================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/atlassian/jira/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -39,6 +48,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -77,5 +87,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``atlassian-python-api`` ``>=1.14.2`` ======================== ================== - -.. include:: ../../airflow/providers/atlassian/jira/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-atlassian-jira/security.rst b/docs/apache-airflow-providers-atlassian-jira/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-atlassian-jira/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-celery/changelog.rst b/docs/apache-airflow-providers-celery/changelog.rst new file mode 100644 index 0000000000000..3a3395be9862b --- /dev/null +++ b/docs/apache-airflow-providers-celery/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-celery`` +------------------------------------------- + +.. include:: ../../airflow/providers/celery/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-celery/index.rst b/docs/apache-airflow-providers-celery/index.rst index 1bc1a5f7e01b6..fbf57bead943d 100644 --- a/docs/apache-airflow-providers-celery/index.rst +++ b/docs/apache-airflow-providers-celery/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-celery`` =================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -34,6 +42,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -73,5 +82,3 @@ PIP package Version required ``celery`` ``>=5.2.3,<6`` ``flower`` ``>=1.0.0`` ================== ================== - -.. include:: ../../airflow/providers/celery/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-celery/security.rst b/docs/apache-airflow-providers-celery/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-celery/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-cloudant/changelog.rst b/docs/apache-airflow-providers-cloudant/changelog.rst new file mode 100644 index 0000000000000..d92c198cfced2 --- /dev/null +++ b/docs/apache-airflow-providers-cloudant/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-cloudant`` +--------------------------------------------- + +.. include:: ../../airflow/providers/cloudant/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-cloudant/index.rst b/docs/apache-airflow-providers-cloudant/index.rst index 067ab2e6c3667..143626b7804d9 100644 --- a/docs/apache-airflow-providers-cloudant/index.rst +++ b/docs/apache-airflow-providers-cloudant/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-cloudant`` ===================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -34,6 +42,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -72,5 +81,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``cloudant`` ``>=2.0`` ================== ================== - -.. include:: ../../airflow/providers/cloudant/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-cloudant/security.rst b/docs/apache-airflow-providers-cloudant/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-cloudant/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-cncf-kubernetes/changelog.rst b/docs/apache-airflow-providers-cncf-kubernetes/changelog.rst new file mode 100644 index 0000000000000..284f102488477 --- /dev/null +++ b/docs/apache-airflow-providers-cncf-kubernetes/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-cncf-kubernetes`` +---------------------------------------------------- + +.. include:: ../../airflow/providers/cncf/kubernetes/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-cncf-kubernetes/index.rst b/docs/apache-airflow-providers-cncf-kubernetes/index.rst index 5947fd9a7422d..f511ea5ecb580 100644 --- a/docs/apache-airflow-providers-cncf-kubernetes/index.rst +++ b/docs/apache-airflow-providers-cncf-kubernetes/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-cncf-kubernetes`` ============================================ -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/cncf/kubernetes/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -94,5 +106,3 @@ PIP package Version required ``kubernetes`` ``>=21.7.0,<24`` ``kubernetes_asyncio`` ``>=18.20.1,<25`` ====================== ================== - -.. include:: ../../airflow/providers/cncf/kubernetes/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-cncf-kubernetes/security.rst b/docs/apache-airflow-providers-cncf-kubernetes/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-cncf-kubernetes/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-common-sql/changelog.rst b/docs/apache-airflow-providers-common-sql/changelog.rst new file mode 100644 index 0000000000000..2b8d6ae7e8992 --- /dev/null +++ b/docs/apache-airflow-providers-common-sql/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-common-sql`` +----------------------------------------------- + +.. include:: ../../airflow/providers/common/sql/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-common-sql/index.rst b/docs/apache-airflow-providers-common-sql/index.rst index afcc24d0f9462..027c9a436d3cb 100644 --- a/docs/apache-airflow-providers-common-sql/index.rst +++ b/docs/apache-airflow-providers-common-sql/index.rst @@ -18,10 +18,18 @@ ``apache-airflow-providers-common-sql`` ======================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -29,6 +37,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -36,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/common/sql/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -90,5 +102,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``sqlparse`` ``>=0.4.2`` ================== ================== - -.. include:: ../../airflow/providers/common/sql/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-common-sql/security.rst b/docs/apache-airflow-providers-common-sql/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-common-sql/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-databricks/changelog.rst b/docs/apache-airflow-providers-databricks/changelog.rst new file mode 100644 index 0000000000000..9a262c2567c0e --- /dev/null +++ b/docs/apache-airflow-providers-databricks/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-databricks`` +----------------------------------------------- + +.. include:: ../../airflow/providers/databricks/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-databricks/index.rst b/docs/apache-airflow-providers-databricks/index.rst index a3d96eef7cf4d..c04b6d656c461 100644 --- a/docs/apache-airflow-providers-databricks/index.rst +++ b/docs/apache-airflow-providers-databricks/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-databricks`` ============================================ -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/databricks/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -122,5 +134,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-databricks 4.3.0 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-databricks 4.3.0 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/databricks/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-databricks/security.rst b/docs/apache-airflow-providers-databricks/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-databricks/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-datadog/changelog.rst b/docs/apache-airflow-providers-datadog/changelog.rst new file mode 100644 index 0000000000000..99ff68850f814 --- /dev/null +++ b/docs/apache-airflow-providers-datadog/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-datadog`` +-------------------------------------------- + +.. include:: ../../airflow/providers/datadog/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-datadog/index.rst b/docs/apache-airflow-providers-datadog/index.rst index 74af7c7531579..f3f2c77302090 100644 --- a/docs/apache-airflow-providers-datadog/index.rst +++ b/docs/apache-airflow-providers-datadog/index.rst @@ -19,22 +19,32 @@ ``apache-airflow-providers-datadog`` ==================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Connection types .. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/datadog/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -45,6 +55,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -83,5 +94,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``datadog`` ``>=0.14.0`` ================== ================== - -.. include:: ../../airflow/providers/datadog/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-datadog/security.rst b/docs/apache-airflow-providers-datadog/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-datadog/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-dbt-cloud/changelog.rst b/docs/apache-airflow-providers-dbt-cloud/changelog.rst new file mode 100644 index 0000000000000..7d262eb397b08 --- /dev/null +++ b/docs/apache-airflow-providers-dbt-cloud/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-dbt-cloud`` +---------------------------------------------- + +.. include:: ../../airflow/providers/dbt/cloud/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-dbt-cloud/index.rst b/docs/apache-airflow-providers-dbt-cloud/index.rst index b5052373a968c..0fe39d64a8798 100644 --- a/docs/apache-airflow-providers-dbt-cloud/index.rst +++ b/docs/apache-airflow-providers-dbt-cloud/index.rst @@ -23,10 +23,18 @@ equipped with turnkey support for scheduling jobs, CI/CD, serving documentation, an Integrated Developer Environment (IDE). -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -34,6 +42,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -41,11 +50,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/dbt/cloud/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -57,6 +68,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -125,5 +137,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-dbt-cloud 3.2.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-dbt-cloud 3.2.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/dbt/cloud/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-dbt-cloud/security.rst b/docs/apache-airflow-providers-dbt-cloud/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-dbt-cloud/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-dingding/changelog.rst b/docs/apache-airflow-providers-dingding/changelog.rst new file mode 100644 index 0000000000000..272bd9d017e05 --- /dev/null +++ b/docs/apache-airflow-providers-dingding/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-dingding`` +--------------------------------------------- + +.. include:: ../../airflow/providers/dingding/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-dingding/index.rst b/docs/apache-airflow-providers-dingding/index.rst index eaaca2e8541b9..21991617b3719 100644 --- a/docs/apache-airflow-providers-dingding/index.rst +++ b/docs/apache-airflow-providers-dingding/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-dingding`` ===================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -36,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/dingding/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -118,5 +130,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-dingding 3.2.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-dingding 3.2.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/dingding/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-dingding/security.rst b/docs/apache-airflow-providers-dingding/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-dingding/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-discord/changelog.rst b/docs/apache-airflow-providers-discord/changelog.rst new file mode 100644 index 0000000000000..d26072461d1dc --- /dev/null +++ b/docs/apache-airflow-providers-discord/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-discord`` +-------------------------------------------- + +.. include:: ../../airflow/providers/discord/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-discord/index.rst b/docs/apache-airflow-providers-discord/index.rst index 81f0753b1850c..746732257fb69 100644 --- a/docs/apache-airflow-providers-discord/index.rst +++ b/docs/apache-airflow-providers-discord/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-discord`` ==================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -34,6 +42,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -100,5 +109,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-discord 3.3.0 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-discord 3.3.0 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/discord/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-discord/security.rst b/docs/apache-airflow-providers-discord/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-discord/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-docker/changelog.rst b/docs/apache-airflow-providers-docker/changelog.rst new file mode 100644 index 0000000000000..d92635e586b23 --- /dev/null +++ b/docs/apache-airflow-providers-docker/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-docker`` +------------------------------------------- + +.. include:: ../../airflow/providers/docker/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-docker/index.rst b/docs/apache-airflow-providers-docker/index.rst index d306f55479133..6ba54a0eb2af5 100644 --- a/docs/apache-airflow-providers-docker/index.rst +++ b/docs/apache-airflow-providers-docker/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-docker`` =================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -31,11 +39,13 @@ Content Docker Task Decorator .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/docker/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -47,6 +57,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -86,5 +97,3 @@ PIP package Version required ``docker`` ``>=5.0.3`` ``python-dotenv`` ``>=0.21.0`` ================== ================== - -.. include:: ../../airflow/providers/docker/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-docker/security.rst b/docs/apache-airflow-providers-docker/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-docker/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-elasticsearch/changelog.rst b/docs/apache-airflow-providers-elasticsearch/changelog.rst new file mode 100644 index 0000000000000..287030242def1 --- /dev/null +++ b/docs/apache-airflow-providers-elasticsearch/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-elasticsearch`` +-------------------------------------------------- + +.. include:: ../../airflow/providers/elasticsearch/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-elasticsearch/index.rst b/docs/apache-airflow-providers-elasticsearch/index.rst index 9d9f0b24cbc49..5a4582412aad5 100644 --- a/docs/apache-airflow-providers-elasticsearch/index.rst +++ b/docs/apache-airflow-providers-elasticsearch/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-elasticsearch`` ========================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -31,6 +39,7 @@ Content Elasticsearch hooks .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -38,11 +47,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/elasticsearch/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -54,6 +65,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -66,7 +78,7 @@ Package apache-airflow-providers-elasticsearch `Elasticsearch `__ -Release: 4.5.1 +Release: 5.0.0 Provider package ---------------- @@ -119,7 +131,5 @@ Downloading official packages You can download officially released packages and verify their checksums and signatures from the `Official Apache Download site `_ -* `The apache-airflow-providers-elasticsearch 4.5.1 sdist package `_ (`asc `__, `sha512 `__) -* `The apache-airflow-providers-elasticsearch 4.5.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/elasticsearch/CHANGELOG.rst +* `The apache-airflow-providers-elasticsearch 5.0.0 sdist package `_ (`asc `__, `sha512 `__) +* `The apache-airflow-providers-elasticsearch 5.0.0 wheel package `_ (`asc `__, `sha512 `__) diff --git a/docs/apache-airflow-providers-elasticsearch/security.rst b/docs/apache-airflow-providers-elasticsearch/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-elasticsearch/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-exasol/changelog.rst b/docs/apache-airflow-providers-exasol/changelog.rst new file mode 100644 index 0000000000000..4dc893b566150 --- /dev/null +++ b/docs/apache-airflow-providers-exasol/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-exasol`` +------------------------------------------- + +.. include:: ../../airflow/providers/exasol/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-exasol/index.rst b/docs/apache-airflow-providers-exasol/index.rst index e04c31a3a1019..30821732afca5 100644 --- a/docs/apache-airflow-providers-exasol/index.rst +++ b/docs/apache-airflow-providers-exasol/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-exasol`` =================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/exasol/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -39,6 +48,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -107,5 +117,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-exasol 4.2.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-exasol 4.2.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/exasol/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-exasol/security.rst b/docs/apache-airflow-providers-exasol/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-exasol/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-facebook/changelog.rst b/docs/apache-airflow-providers-facebook/changelog.rst new file mode 100644 index 0000000000000..d58f217b64887 --- /dev/null +++ b/docs/apache-airflow-providers-facebook/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-facebook`` +--------------------------------------------- + +.. include:: ../../airflow/providers/facebook/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-facebook/index.rst b/docs/apache-airflow-providers-facebook/index.rst index 395370256d7c1..6baf2d11d8d42 100644 --- a/docs/apache-airflow-providers-facebook/index.rst +++ b/docs/apache-airflow-providers-facebook/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-facebook`` ===================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/facebook/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -39,6 +48,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -77,5 +87,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``facebook-business`` ``>=6.0.2`` ===================== ================== - -.. include:: ../../airflow/providers/facebook/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-facebook/security.rst b/docs/apache-airflow-providers-facebook/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-facebook/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-ftp/changelog.rst b/docs/apache-airflow-providers-ftp/changelog.rst new file mode 100644 index 0000000000000..6b7a72cefbe54 --- /dev/null +++ b/docs/apache-airflow-providers-ftp/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-ftp`` +---------------------------------------- + +.. include:: ../../airflow/providers/ftp/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-ftp/index.rst b/docs/apache-airflow-providers-ftp/index.rst index e027aabb15767..bc490af3268ed 100644 --- a/docs/apache-airflow-providers-ftp/index.rst +++ b/docs/apache-airflow-providers-ftp/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-ftp`` ================================ -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -30,6 +38,7 @@ Content Python API <_api/airflow/providers/ftp/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Operators @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/ftp/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -51,6 +62,7 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/ftp/index> @@ -59,6 +71,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -96,5 +109,3 @@ PIP package Version required ================== ================== ``apache-airflow`` ``>=2.4.0`` ================== ================== - -.. include:: ../../airflow/providers/ftp/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-ftp/security.rst b/docs/apache-airflow-providers-ftp/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-ftp/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-github/changelog.rst b/docs/apache-airflow-providers-github/changelog.rst new file mode 100644 index 0000000000000..964dfec0fd249 --- /dev/null +++ b/docs/apache-airflow-providers-github/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-github`` +------------------------------------------- + +.. include:: ../../airflow/providers/github/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-github/index.rst b/docs/apache-airflow-providers-github/index.rst index 83c2445b9dec2..ad58032c3bf13 100644 --- a/docs/apache-airflow-providers-github/index.rst +++ b/docs/apache-airflow-providers-github/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-github`` ======================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/github/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -50,6 +61,7 @@ Content Installing from sources .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -59,6 +71,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -97,5 +110,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``PyGithub!`` ``=1.58`` ================== ================== - -.. include:: ../../airflow/providers/github/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-github/security.rst b/docs/apache-airflow-providers-github/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-github/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-google/changelog.rst b/docs/apache-airflow-providers-google/changelog.rst new file mode 100644 index 0000000000000..abda3f330d61d --- /dev/null +++ b/docs/apache-airflow-providers-google/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-google`` +------------------------------------------- + +.. include:: ../../airflow/providers/google/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-google/index.rst b/docs/apache-airflow-providers-google/index.rst index a77877b7ed31e..5e322f9d0054e 100644 --- a/docs/apache-airflow-providers-google/index.rst +++ b/docs/apache-airflow-providers-google/index.rst @@ -18,10 +18,18 @@ ``apache-airflow-providers-google`` =================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -33,6 +41,7 @@ Content Sensors .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -41,11 +50,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/google/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -57,6 +68,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -105,7 +117,7 @@ PIP package Version required ``gcloud-aio-auth`` ``>=4.0.0,<5.0.0`` ``gcloud-aio-bigquery`` ``>=6.1.2`` ``gcloud-aio-storage`` -``google-ads`` ``>=20.0.0`` +``google-ads`` ``>=21.2.0`` ``google-api-core`` ``>=2.11.0`` ``google-api-python-client`` ``>=1.6.0`` ``google-auth`` ``>=1.0.0`` @@ -196,5 +208,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-google 10.2.0 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-google 10.2.0 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/google/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-google/security.rst b/docs/apache-airflow-providers-google/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-google/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-grpc/changelog.rst b/docs/apache-airflow-providers-grpc/changelog.rst new file mode 100644 index 0000000000000..051d23b8a8181 --- /dev/null +++ b/docs/apache-airflow-providers-grpc/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-grpc`` +----------------------------------------- + +.. include:: ../../airflow/providers/grpc/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-grpc/connections/index.rst b/docs/apache-airflow-providers-grpc/connections/index.rst new file mode 100644 index 0000000000000..2b8afb41df936 --- /dev/null +++ b/docs/apache-airflow-providers-grpc/connections/index.rst @@ -0,0 +1,25 @@ + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Connection Types +---------------- + +.. toctree:: + :maxdepth: 1 + :glob: + + * diff --git a/docs/apache-airflow-providers-grpc/index.rst b/docs/apache-airflow-providers-grpc/index.rst index 31f6e599245ce..4180c382a68c0 100644 --- a/docs/apache-airflow-providers-grpc/index.rst +++ b/docs/apache-airflow-providers-grpc/index.rst @@ -19,22 +19,32 @@ ``apache-airflow-providers-grpc`` ================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides - Connection types + Connection types .. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/grpc/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -45,6 +55,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -85,5 +96,3 @@ PIP package Version required ``google-auth-httplib2`` ``>=0.0.1`` ``grpcio`` ``>=1.15.0`` ======================== =================== - -.. include:: ../../airflow/providers/grpc/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-grpc/security.rst b/docs/apache-airflow-providers-grpc/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-grpc/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-hashicorp/changelog.rst b/docs/apache-airflow-providers-hashicorp/changelog.rst new file mode 100644 index 0000000000000..7ba4a83c0aa9f --- /dev/null +++ b/docs/apache-airflow-providers-hashicorp/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-hashicorp`` +---------------------------------------------- + +.. include:: ../../airflow/providers/hashicorp/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-hashicorp/index.rst b/docs/apache-airflow-providers-hashicorp/index.rst index df6c3725dfd53..a1b4007398a76 100644 --- a/docs/apache-airflow-providers-hashicorp/index.rst +++ b/docs/apache-airflow-providers-hashicorp/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-hashicorp`` ====================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,12 +38,14 @@ Content Secrets backends .. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/hashicorp/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -46,6 +56,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -112,5 +123,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-hashicorp 3.4.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-hashicorp 3.4.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/hashicorp/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-hashicorp/security.rst b/docs/apache-airflow-providers-hashicorp/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-hashicorp/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-http/changelog.rst b/docs/apache-airflow-providers-http/changelog.rst new file mode 100644 index 0000000000000..30efed25e3a30 --- /dev/null +++ b/docs/apache-airflow-providers-http/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-http`` +----------------------------------------- + +.. include:: ../../airflow/providers/http/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-http/index.rst b/docs/apache-airflow-providers-http/index.rst index 48c5d42f39697..70d28ec4d6855 100644 --- a/docs/apache-airflow-providers-http/index.rst +++ b/docs/apache-airflow-providers-http/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-http`` ================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/http/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -94,5 +106,3 @@ PIP package Version required ``aiohttp`` ``asgiref`` ===================== ================== - -.. include:: ../../airflow/providers/http/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-http/security.rst b/docs/apache-airflow-providers-http/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-http/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-imap/changelog.rst b/docs/apache-airflow-providers-imap/changelog.rst new file mode 100644 index 0000000000000..b635271658f9a --- /dev/null +++ b/docs/apache-airflow-providers-imap/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-imap`` +----------------------------------------- + +.. include:: ../../airflow/providers/imap/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-imap/index.rst b/docs/apache-airflow-providers-imap/index.rst index dba38f5fd22b4..ef8e28b9e0c67 100644 --- a/docs/apache-airflow-providers-imap/index.rst +++ b/docs/apache-airflow-providers-imap/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-imap`` ================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -30,6 +38,7 @@ Content Python API <_api/airflow/providers/imap/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -40,6 +49,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -77,5 +87,3 @@ PIP package Version required ================== ================== ``apache-airflow`` ``>=2.4.0`` ================== ================== - -.. include:: ../../airflow/providers/imap/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-imap/security.rst b/docs/apache-airflow-providers-imap/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-imap/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-influxdb/changelog.rst b/docs/apache-airflow-providers-influxdb/changelog.rst new file mode 100644 index 0000000000000..2c32bdae5a4a1 --- /dev/null +++ b/docs/apache-airflow-providers-influxdb/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-influxdb`` +--------------------------------------------- + +.. include:: ../../airflow/providers/influxdb/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-influxdb/index.rst b/docs/apache-airflow-providers-influxdb/index.rst index d186e91d1242a..0273013aa5664 100644 --- a/docs/apache-airflow-providers-influxdb/index.rst +++ b/docs/apache-airflow-providers-influxdb/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-influxdb`` ======================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/influxdb/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -50,6 +61,7 @@ Content Installing from sources .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -59,6 +71,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -98,5 +111,3 @@ PIP package Version required ``influxdb-client`` ``>=1.19.0`` ``requests`` ``>=2.26.0`` =================== ================== - -.. include:: ../../airflow/providers/influxdb/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-influxdb/security.rst b/docs/apache-airflow-providers-influxdb/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-influxdb/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-jdbc/changelog.rst b/docs/apache-airflow-providers-jdbc/changelog.rst new file mode 100644 index 0000000000000..e8ff084db25dd --- /dev/null +++ b/docs/apache-airflow-providers-jdbc/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-jdbc`` +----------------------------------------- + +.. include:: ../../airflow/providers/jdbc/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-jdbc/index.rst b/docs/apache-airflow-providers-jdbc/index.rst index 0d6882ea38e4f..bcffc790c8e6e 100644 --- a/docs/apache-airflow-providers-jdbc/index.rst +++ b/docs/apache-airflow-providers-jdbc/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-jdbc`` ================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Connection types .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/jdbc/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -120,5 +132,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-jdbc 4.0.0 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-jdbc 4.0.0 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/jdbc/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-jdbc/security.rst b/docs/apache-airflow-providers-jdbc/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-jdbc/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-jenkins/changelog.rst b/docs/apache-airflow-providers-jenkins/changelog.rst new file mode 100644 index 0000000000000..c8b1b0600a783 --- /dev/null +++ b/docs/apache-airflow-providers-jenkins/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-jenkins`` +-------------------------------------------- + +.. include:: ../../airflow/providers/jenkins/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-jenkins/index.rst b/docs/apache-airflow-providers-jenkins/index.rst index cce710a1d28f8..0dac91f654171 100644 --- a/docs/apache-airflow-providers-jenkins/index.rst +++ b/docs/apache-airflow-providers-jenkins/index.rst @@ -19,15 +19,25 @@ ``apache-airflow-providers-jenkins`` ==================================== -Content -------- + +.. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + .. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Connection types .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -35,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/jenkins/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -51,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -89,5 +102,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``python-jenkins`` ``>=1.0.0`` ================== ================== - -.. include:: ../../airflow/providers/jenkins/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-jenkins/security.rst b/docs/apache-airflow-providers-jenkins/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-jenkins/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-microsoft-azure/changelog.rst b/docs/apache-airflow-providers-microsoft-azure/changelog.rst new file mode 100644 index 0000000000000..5bf8a1b215de3 --- /dev/null +++ b/docs/apache-airflow-providers-microsoft-azure/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-microsoft-azure`` +---------------------------------------------------- + +.. include:: ../../airflow/providers/microsoft/azure/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-microsoft-azure/index.rst b/docs/apache-airflow-providers-microsoft-azure/index.rst index 615e7caf1ad8b..5820216b13dd0 100644 --- a/docs/apache-airflow-providers-microsoft-azure/index.rst +++ b/docs/apache-airflow-providers-microsoft-azure/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-microsoft-azure`` ============================================ -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -32,6 +40,7 @@ Content Logging for Tasks .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -39,11 +48,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/microsoft/azure/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -55,6 +66,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -139,5 +151,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-microsoft-azure 6.1.2 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-microsoft-azure 6.1.2 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/microsoft/azure/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-microsoft-azure/security.rst b/docs/apache-airflow-providers-microsoft-azure/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-microsoft-azure/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-microsoft-mssql/changelog.rst b/docs/apache-airflow-providers-microsoft-mssql/changelog.rst new file mode 100644 index 0000000000000..739c6b8b62a7b --- /dev/null +++ b/docs/apache-airflow-providers-microsoft-mssql/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-microsoft-mssql`` +---------------------------------------------------- + +.. include:: ../../airflow/providers/microsoft/mssql/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-microsoft-mssql/index.rst b/docs/apache-airflow-providers-microsoft-mssql/index.rst index a74410ded9151..aaf868118cb2f 100644 --- a/docs/apache-airflow-providers-microsoft-mssql/index.rst +++ b/docs/apache-airflow-providers-microsoft-mssql/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-microsoft-mssql`` ============================================ -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/microsoft/mssql/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -120,5 +132,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-microsoft-mssql 3.4.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-microsoft-mssql 3.4.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/microsoft/mssql/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-microsoft-mssql/security.rst b/docs/apache-airflow-providers-microsoft-mssql/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-microsoft-mssql/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-microsoft-psrp/changelog.rst b/docs/apache-airflow-providers-microsoft-psrp/changelog.rst new file mode 100644 index 0000000000000..07d8e032d52ab --- /dev/null +++ b/docs/apache-airflow-providers-microsoft-psrp/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-microsoft-psrp`` +--------------------------------------------------- + +.. include:: ../../airflow/providers/microsoft/psrp/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-microsoft-psrp/index.rst b/docs/apache-airflow-providers-microsoft-psrp/index.rst index 3dc668d6f5801..30361ef749adf 100644 --- a/docs/apache-airflow-providers-microsoft-psrp/index.rst +++ b/docs/apache-airflow-providers-microsoft-psrp/index.rst @@ -19,22 +19,32 @@ ``apache-airflow-providers-microsoft-psrp`` =========================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/microsoft/psrp/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -45,6 +55,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -85,5 +96,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``pypsrp`` ``>=0.8.0`` ================== ================== - -.. include:: ../../airflow/providers/microsoft/psrp/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-microsoft-psrp/security.rst b/docs/apache-airflow-providers-microsoft-psrp/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-microsoft-psrp/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-microsoft-winrm/changelog.rst b/docs/apache-airflow-providers-microsoft-winrm/changelog.rst new file mode 100644 index 0000000000000..201bbe2df89b1 --- /dev/null +++ b/docs/apache-airflow-providers-microsoft-winrm/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-microsoft-winrm`` +---------------------------------------------------- + +.. include:: ../../airflow/providers/microsoft/winrm/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-microsoft-winrm/index.rst b/docs/apache-airflow-providers-microsoft-winrm/index.rst index fc888a1aee2be..29e6eae33b370 100644 --- a/docs/apache-airflow-providers-microsoft-winrm/index.rst +++ b/docs/apache-airflow-providers-microsoft-winrm/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-microsoft-winrm`` ============================================ -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -36,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/microsoft/winrm/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -90,5 +102,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``pywinrm`` ``>=0.4`` ================== ================== - -.. include:: ../../airflow/providers/microsoft/winrm/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-microsoft-winrm/security.rst b/docs/apache-airflow-providers-microsoft-winrm/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-microsoft-winrm/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-mongo/changelog.rst b/docs/apache-airflow-providers-mongo/changelog.rst new file mode 100644 index 0000000000000..97e1e6c55d5b4 --- /dev/null +++ b/docs/apache-airflow-providers-mongo/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-mongo`` +------------------------------------------ + +.. include:: ../../airflow/providers/mongo/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-mongo/index.rst b/docs/apache-airflow-providers-mongo/index.rst index 1e1c3ab12158b..5e0ef781f8620 100644 --- a/docs/apache-airflow-providers-mongo/index.rst +++ b/docs/apache-airflow-providers-mongo/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-mongo`` ================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -30,6 +38,7 @@ Content Python API <_api/airflow/providers/mongo/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -40,6 +49,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -79,5 +89,3 @@ PIP package Version required ``dnspython`` ``>=1.13.0`` ``pymongo`` ``>=3.6.0`` ================== ================== - -.. include:: ../../airflow/providers/mongo/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-mongo/security.rst b/docs/apache-airflow-providers-mongo/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-mongo/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-mysql/changelog.rst b/docs/apache-airflow-providers-mysql/changelog.rst new file mode 100644 index 0000000000000..7221fd9fc662c --- /dev/null +++ b/docs/apache-airflow-providers-mysql/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-mysql`` +------------------------------------------ + +.. include:: ../../airflow/providers/mysql/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-mysql/index.rst b/docs/apache-airflow-providers-mysql/index.rst index 3f39b5b775c1b..9a29fde530ed6 100644 --- a/docs/apache-airflow-providers-mysql/index.rst +++ b/docs/apache-airflow-providers-mysql/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-mysql`` ================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/mysql/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -124,5 +136,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-mysql 5.1.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-mysql 5.1.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/mysql/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-mysql/security.rst b/docs/apache-airflow-providers-mysql/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-mysql/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-neo4j/changelog.rst b/docs/apache-airflow-providers-neo4j/changelog.rst new file mode 100644 index 0000000000000..dd14f25ba6280 --- /dev/null +++ b/docs/apache-airflow-providers-neo4j/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-neo4j`` +------------------------------------------ + +.. include:: ../../airflow/providers/neo4j/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-neo4j/index.rst b/docs/apache-airflow-providers-neo4j/index.rst index 9a2924a72b4a8..65e0b69a6c961 100644 --- a/docs/apache-airflow-providers-neo4j/index.rst +++ b/docs/apache-airflow-providers-neo4j/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-neo4j`` ================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/neo4j/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -91,5 +103,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``neo4j`` ``>=4.2.1`` ================== ================== - -.. include:: ../../airflow/providers/neo4j/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-neo4j/security.rst b/docs/apache-airflow-providers-neo4j/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-neo4j/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-odbc/changelog.rst b/docs/apache-airflow-providers-odbc/changelog.rst new file mode 100644 index 0000000000000..58166fe379abd --- /dev/null +++ b/docs/apache-airflow-providers-odbc/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-odbc`` +----------------------------------------- + +.. include:: ../../airflow/providers/odbc/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-odbc/index.rst b/docs/apache-airflow-providers-odbc/index.rst index 1c751294fd942..d6dbffd11b0e4 100644 --- a/docs/apache-airflow-providers-odbc/index.rst +++ b/docs/apache-airflow-providers-odbc/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-odbc`` ================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Connection types .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -41,6 +50,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -108,5 +118,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-odbc 4.0.0 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-odbc 4.0.0 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/odbc/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-odbc/security.rst b/docs/apache-airflow-providers-odbc/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-odbc/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-openfaas/changelog.rst b/docs/apache-airflow-providers-openfaas/changelog.rst new file mode 100644 index 0000000000000..9a2ff34f4895b --- /dev/null +++ b/docs/apache-airflow-providers-openfaas/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-openfaas`` +--------------------------------------------- + +.. include:: ../../airflow/providers/openfaas/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-openfaas/index.rst b/docs/apache-airflow-providers-openfaas/index.rst index 393f9fecadb91..319e37a3aa616 100644 --- a/docs/apache-airflow-providers-openfaas/index.rst +++ b/docs/apache-airflow-providers-openfaas/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-openfaas`` ===================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/openfaas/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -39,6 +48,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -76,5 +86,3 @@ PIP package Version required ================== ================== ``apache-airflow`` ``>=2.4.0`` ================== ================== - -.. include:: ../../airflow/providers/openfaas/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-openfaas/security.rst b/docs/apache-airflow-providers-openfaas/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-openfaas/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-openlineage/changelog.rst b/docs/apache-airflow-providers-openlineage/changelog.rst new file mode 100644 index 0000000000000..8d5ab5278a60e --- /dev/null +++ b/docs/apache-airflow-providers-openlineage/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-openlineage`` +------------------------------------------------ + +.. include:: ../../airflow/providers/openlineage/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-openlineage/index.rst b/docs/apache-airflow-providers-openlineage/index.rst index 4793015162ad2..7f9f22224e0d3 100644 --- a/docs/apache-airflow-providers-openlineage/index.rst +++ b/docs/apache-airflow-providers-openlineage/index.rst @@ -19,40 +19,53 @@ ``apache-airflow-providers-openlineage`` ======================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: User guide Guides .. toctree:: + :hidden: :maxdepth: 1 :caption: Developer guide Guides .. toctree:: + :hidden: :maxdepth: 1 :caption: Structure of provider Guides .. toctree:: + :hidden: :maxdepth: 1 :caption: Macros Macros .. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/openlineage/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -63,6 +76,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits diff --git a/docs/apache-airflow-providers-openlineage/security.rst b/docs/apache-airflow-providers-openlineage/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-openlineage/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-opsgenie/changelog.rst b/docs/apache-airflow-providers-opsgenie/changelog.rst new file mode 100644 index 0000000000000..58a0083310516 --- /dev/null +++ b/docs/apache-airflow-providers-opsgenie/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-opsgenie`` +--------------------------------------------- + +.. include:: ../../airflow/providers/opsgenie/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-opsgenie/index.rst b/docs/apache-airflow-providers-opsgenie/index.rst index f5249c6071060..ddf50d625786e 100644 --- a/docs/apache-airflow-providers-opsgenie/index.rst +++ b/docs/apache-airflow-providers-opsgenie/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-opsgenie`` ===================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -36,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/opsgenie/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -90,5 +102,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``opsgenie-sdk`` ``>=2.1.5`` ================== ================== - -.. include:: ../../airflow/providers/opsgenie/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-opsgenie/security.rst b/docs/apache-airflow-providers-opsgenie/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-opsgenie/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-oracle/changelog.rst b/docs/apache-airflow-providers-oracle/changelog.rst new file mode 100644 index 0000000000000..ac5231a1d13bf --- /dev/null +++ b/docs/apache-airflow-providers-oracle/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-oracle`` +------------------------------------------- + +.. include:: ../../airflow/providers/oracle/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-oracle/index.rst b/docs/apache-airflow-providers-oracle/index.rst index 0ff4877b288da..6073068da8275 100644 --- a/docs/apache-airflow-providers-oracle/index.rst +++ b/docs/apache-airflow-providers-oracle/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-oracle`` =================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,12 +38,14 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/oracle/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -47,6 +57,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -114,5 +125,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-oracle 3.7.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-oracle 3.7.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/oracle/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-oracle/security.rst b/docs/apache-airflow-providers-oracle/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-oracle/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-pagerduty/changelog.rst b/docs/apache-airflow-providers-pagerduty/changelog.rst new file mode 100644 index 0000000000000..c463d381ad521 --- /dev/null +++ b/docs/apache-airflow-providers-pagerduty/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-pagerduty`` +---------------------------------------------- + +.. include:: ../../airflow/providers/pagerduty/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-pagerduty/index.rst b/docs/apache-airflow-providers-pagerduty/index.rst index 5d3223069e781..7d76580e64ebe 100644 --- a/docs/apache-airflow-providers-pagerduty/index.rst +++ b/docs/apache-airflow-providers-pagerduty/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-pagerduty`` ====================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/pagerduty/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -36,6 +45,7 @@ Content Installing from sources .. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -45,6 +55,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -83,5 +94,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``pdpyras`` ``>=4.1.2`` ================== ================== - -.. include:: ../../airflow/providers/pagerduty/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-pagerduty/security.rst b/docs/apache-airflow-providers-pagerduty/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-pagerduty/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-papermill/changelog.rst b/docs/apache-airflow-providers-papermill/changelog.rst new file mode 100644 index 0000000000000..4340d544f2237 --- /dev/null +++ b/docs/apache-airflow-providers-papermill/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-papermill`` +---------------------------------------------- + +.. include:: ../../airflow/providers/papermill/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-papermill/index.rst b/docs/apache-airflow-providers-papermill/index.rst index 6e4d137672c1f..70bb25f7194fd 100644 --- a/docs/apache-airflow-providers-papermill/index.rst +++ b/docs/apache-airflow-providers-papermill/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-papermill`` ====================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -36,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/papermill/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -91,5 +103,3 @@ PIP package Version required ``papermill[all]`` ``>=1.2.1`` ``scrapbook[all]`` ================== ================== - -.. include:: ../../airflow/providers/papermill/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-papermill/security.rst b/docs/apache-airflow-providers-papermill/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-papermill/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-plexus/changelog.rst b/docs/apache-airflow-providers-plexus/changelog.rst new file mode 100644 index 0000000000000..95c7f42b8d427 --- /dev/null +++ b/docs/apache-airflow-providers-plexus/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-plexus`` +------------------------------------------- + +.. include:: ../../airflow/providers/plexus/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-plexus/index.rst b/docs/apache-airflow-providers-plexus/index.rst index 55439dfd49333..e1103ec2f19f2 100644 --- a/docs/apache-airflow-providers-plexus/index.rst +++ b/docs/apache-airflow-providers-plexus/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-plexus`` =================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -30,11 +38,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/plexus/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -46,6 +56,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -84,5 +95,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``arrow`` ``>=0.16.0`` ================== ================== - -.. include:: ../../airflow/providers/plexus/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-plexus/security.rst b/docs/apache-airflow-providers-plexus/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-plexus/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-postgres/changelog.rst b/docs/apache-airflow-providers-postgres/changelog.rst new file mode 100644 index 0000000000000..6bbf232908700 --- /dev/null +++ b/docs/apache-airflow-providers-postgres/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-postgres`` +--------------------------------------------- + +.. include:: ../../airflow/providers/postgres/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-postgres/index.rst b/docs/apache-airflow-providers-postgres/index.rst index 224a84183457b..da163c0156d52 100644 --- a/docs/apache-airflow-providers-postgres/index.rst +++ b/docs/apache-airflow-providers-postgres/index.rst @@ -18,10 +18,18 @@ ``apache-airflow-providers-postgres`` ===================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/postgres/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -121,5 +133,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-postgres 5.5.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-postgres 5.5.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/postgres/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-postgres/security.rst b/docs/apache-airflow-providers-postgres/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-postgres/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-presto/changelog.rst b/docs/apache-airflow-providers-presto/changelog.rst new file mode 100644 index 0000000000000..d1226474e2d5e --- /dev/null +++ b/docs/apache-airflow-providers-presto/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-presto`` +------------------------------------------- + +.. include:: ../../airflow/providers/presto/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-presto/index.rst b/docs/apache-airflow-providers-presto/index.rst index 8c639fa717ec3..84fbd65b2e35b 100644 --- a/docs/apache-airflow-providers-presto/index.rst +++ b/docs/apache-airflow-providers-presto/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-presto`` =================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides PrestoTransferOperator types .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -36,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/presto/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -121,5 +133,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-presto 5.1.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-presto 5.1.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/presto/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-presto/security.rst b/docs/apache-airflow-providers-presto/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-presto/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-qubole/changelog.rst b/docs/apache-airflow-providers-qubole/changelog.rst new file mode 100644 index 0000000000000..3566395943fe1 --- /dev/null +++ b/docs/apache-airflow-providers-qubole/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-qubole`` +------------------------------------------- + +.. include:: ../../airflow/providers/qubole/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-qubole/index.rst b/docs/apache-airflow-providers-qubole/index.rst index 60066a75787d8..25cb3f613d930 100644 --- a/docs/apache-airflow-providers-qubole/index.rst +++ b/docs/apache-airflow-providers-qubole/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-qubole`` =================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -36,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/qubole/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -119,5 +131,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-qubole 3.4.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-qubole 3.4.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/qubole/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-qubole/security.rst b/docs/apache-airflow-providers-qubole/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-qubole/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-redis/changelog.rst b/docs/apache-airflow-providers-redis/changelog.rst new file mode 100644 index 0000000000000..8643b06214060 --- /dev/null +++ b/docs/apache-airflow-providers-redis/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-redis`` +------------------------------------------ + +.. include:: ../../airflow/providers/redis/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-redis/index.rst b/docs/apache-airflow-providers-redis/index.rst index 7cf2dec5720ac..02bc13257f5df 100644 --- a/docs/apache-airflow-providers-redis/index.rst +++ b/docs/apache-airflow-providers-redis/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-redis`` ================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/redis/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -38,6 +47,7 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/redis/index> @@ -46,6 +56,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -84,5 +95,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``redis`` ``>=3.2.0`` ================== ================== - -.. include:: ../../airflow/providers/redis/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-redis/security.rst b/docs/apache-airflow-providers-redis/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-redis/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-salesforce/changelog.rst b/docs/apache-airflow-providers-salesforce/changelog.rst new file mode 100644 index 0000000000000..a57d8371dfd86 --- /dev/null +++ b/docs/apache-airflow-providers-salesforce/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-salesforce`` +----------------------------------------------- + +.. include:: ../../airflow/providers/salesforce/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-salesforce/index.rst b/docs/apache-airflow-providers-salesforce/index.rst index b99597d4e325a..10407f022fdbe 100644 --- a/docs/apache-airflow-providers-salesforce/index.rst +++ b/docs/apache-airflow-providers-salesforce/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-salesforce`` ======================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/salesforce/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -92,5 +104,3 @@ PIP package Version required ``simple-salesforce`` ``>=1.0.0`` ``pandas`` ``>=0.17.1`` ===================== ================== - -.. include:: ../../airflow/providers/salesforce/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-salesforce/security.rst b/docs/apache-airflow-providers-salesforce/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-salesforce/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-samba/changelog.rst b/docs/apache-airflow-providers-samba/changelog.rst new file mode 100644 index 0000000000000..c3a59099cfde6 --- /dev/null +++ b/docs/apache-airflow-providers-samba/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-samba`` +------------------------------------------ + +.. include:: ../../airflow/providers/samba/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-samba/index.rst b/docs/apache-airflow-providers-samba/index.rst index c7e49357933bd..2c97063bba1a3 100644 --- a/docs/apache-airflow-providers-samba/index.rst +++ b/docs/apache-airflow-providers-samba/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-samba`` ================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/samba/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -39,6 +48,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -77,5 +87,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``smbprotocol`` ``>=1.5.0`` ================== ================== - -.. include:: ../../airflow/providers/samba/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-samba/security.rst b/docs/apache-airflow-providers-samba/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-samba/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-segment/changelog.rst b/docs/apache-airflow-providers-segment/changelog.rst new file mode 100644 index 0000000000000..43e6324969ad2 --- /dev/null +++ b/docs/apache-airflow-providers-segment/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-segment`` +-------------------------------------------- + +.. include:: ../../airflow/providers/segment/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-segment/index.rst b/docs/apache-airflow-providers-segment/index.rst index 07186012ef11a..94eb0d19f98cc 100644 --- a/docs/apache-airflow-providers-segment/index.rst +++ b/docs/apache-airflow-providers-segment/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-segment`` ==================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/segment/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -39,6 +48,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -77,5 +87,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``analytics-python`` ``>=1.2.9`` ==================== ================== - -.. include:: ../../airflow/providers/segment/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-segment/security.rst b/docs/apache-airflow-providers-segment/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-segment/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-sendgrid/changelog.rst b/docs/apache-airflow-providers-sendgrid/changelog.rst new file mode 100644 index 0000000000000..1963562bba92c --- /dev/null +++ b/docs/apache-airflow-providers-sendgrid/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-sendgrid`` +--------------------------------------------- + +.. include:: ../../airflow/providers/sendgrid/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-sendgrid/index.rst b/docs/apache-airflow-providers-sendgrid/index.rst index 5e7b07295588c..1621256fc5ac0 100644 --- a/docs/apache-airflow-providers-sendgrid/index.rst +++ b/docs/apache-airflow-providers-sendgrid/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-sendgrid`` ===================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/sendgrid/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -39,6 +48,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -77,5 +87,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``sendgrid`` ``>=6.0.0`` ================== ================== - -.. include:: ../../airflow/providers/sendgrid/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-sendgrid/security.rst b/docs/apache-airflow-providers-sendgrid/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-sendgrid/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-sftp/changelog.rst b/docs/apache-airflow-providers-sftp/changelog.rst new file mode 100644 index 0000000000000..3cab8a64516d3 --- /dev/null +++ b/docs/apache-airflow-providers-sftp/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-sftp`` +----------------------------------------- + +.. include:: ../../airflow/providers/sftp/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-sftp/index.rst b/docs/apache-airflow-providers-sftp/index.rst index b0bb0ead6065f..83031f470f73a 100644 --- a/docs/apache-airflow-providers-sftp/index.rst +++ b/docs/apache-airflow-providers-sftp/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-sftp`` ================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -30,6 +38,7 @@ Content Python API <_api/airflow/providers/sftp/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -40,6 +49,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -106,5 +116,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-sftp 4.3.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-sftp 4.3.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/sftp/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-sftp/security.rst b/docs/apache-airflow-providers-sftp/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-sftp/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-singularity/changelog.rst b/docs/apache-airflow-providers-singularity/changelog.rst new file mode 100644 index 0000000000000..803e1201ab69d --- /dev/null +++ b/docs/apache-airflow-providers-singularity/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-singularity`` +------------------------------------------------ + +.. include:: ../../airflow/providers/singularity/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-singularity/index.rst b/docs/apache-airflow-providers-singularity/index.rst index 80c6256c39ddb..4f0b57acafd9e 100644 --- a/docs/apache-airflow-providers-singularity/index.rst +++ b/docs/apache-airflow-providers-singularity/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-singularity`` ======================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -30,11 +38,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/singularity/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -46,6 +56,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -84,5 +95,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``spython`` ``>=0.0.56`` ================== ================== - -.. include:: ../../airflow/providers/singularity/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-singularity/security.rst b/docs/apache-airflow-providers-singularity/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-singularity/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-slack/changelog.rst b/docs/apache-airflow-providers-slack/changelog.rst new file mode 100644 index 0000000000000..cb130d2233cbb --- /dev/null +++ b/docs/apache-airflow-providers-slack/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-slack`` +------------------------------------------ + +.. include:: ../../airflow/providers/slack/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-slack/index.rst b/docs/apache-airflow-providers-slack/index.rst index 5054facdb1fe1..f0c6923ee426b 100644 --- a/docs/apache-airflow-providers-slack/index.rst +++ b/docs/apache-airflow-providers-slack/index.rst @@ -19,15 +19,25 @@ ``apache-airflow-providers-slack`` ================================== -Content -------- + +.. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/slack/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -36,6 +46,7 @@ Content Slack Notifications .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -43,6 +54,7 @@ Content Example DAGs .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +65,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -120,5 +133,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-slack 7.3.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-slack 7.3.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/slack/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-slack/security.rst b/docs/apache-airflow-providers-slack/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-slack/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-smtp/changelog.rst b/docs/apache-airflow-providers-smtp/changelog.rst new file mode 100644 index 0000000000000..e67bd0dcd6520 --- /dev/null +++ b/docs/apache-airflow-providers-smtp/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-smtp`` +----------------------------------------- + +.. include:: ../../airflow/providers/smtp/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-smtp/index.rst b/docs/apache-airflow-providers-smtp/index.rst index d6d27b9658612..0cc35fa4e1f92 100644 --- a/docs/apache-airflow-providers-smtp/index.rst +++ b/docs/apache-airflow-providers-smtp/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-smtp`` ================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -31,6 +39,7 @@ Content Python API <_api/airflow/providers/smtp/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -41,6 +50,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -78,5 +88,3 @@ PIP package Version required ================== ================== ``apache-airflow`` ``>=2.4.0`` ================== ================== - -.. include:: ../../airflow/providers/smtp/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-smtp/security.rst b/docs/apache-airflow-providers-smtp/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-smtp/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-snowflake/changelog.rst b/docs/apache-airflow-providers-snowflake/changelog.rst new file mode 100644 index 0000000000000..c3a0cdf18ef9d --- /dev/null +++ b/docs/apache-airflow-providers-snowflake/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-snowflake`` +---------------------------------------------- + +.. include:: ../../airflow/providers/snowflake/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-snowflake/index.rst b/docs/apache-airflow-providers-snowflake/index.rst index 1a5025dc6646a..7da44262da784 100644 --- a/docs/apache-airflow-providers-snowflake/index.rst +++ b/docs/apache-airflow-providers-snowflake/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-snowflake`` ====================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/snowflake/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -122,5 +134,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-snowflake 4.2.0 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-snowflake 4.2.0 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/snowflake/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-snowflake/security.rst b/docs/apache-airflow-providers-snowflake/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-snowflake/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-sqlite/changelog.rst b/docs/apache-airflow-providers-sqlite/changelog.rst new file mode 100644 index 0000000000000..99d35831de58a --- /dev/null +++ b/docs/apache-airflow-providers-sqlite/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-sqlite`` +------------------------------------------- + +.. include:: ../../airflow/providers/sqlite/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-sqlite/index.rst b/docs/apache-airflow-providers-sqlite/index.rst index c1f54d4ee6186..3d72624fd1968 100644 --- a/docs/apache-airflow-providers-sqlite/index.rst +++ b/docs/apache-airflow-providers-sqlite/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-sqlite`` =================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/sqlite/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -119,5 +131,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-sqlite 3.4.2 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-sqlite 3.4.2 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/sqlite/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-sqlite/security.rst b/docs/apache-airflow-providers-sqlite/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-sqlite/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-ssh/changelog.rst b/docs/apache-airflow-providers-ssh/changelog.rst new file mode 100644 index 0000000000000..d6ba0ea87983e --- /dev/null +++ b/docs/apache-airflow-providers-ssh/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-ssh`` +---------------------------------------- + +.. include:: ../../airflow/providers/ssh/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-ssh/index.rst b/docs/apache-airflow-providers-ssh/index.rst index 81e7afd1ed2f4..2c9fdd974d148 100644 --- a/docs/apache-airflow-providers-ssh/index.rst +++ b/docs/apache-airflow-providers-ssh/index.rst @@ -19,22 +19,32 @@ ``apache-airflow-providers-ssh`` ================================ -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Connection types .. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/ssh/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -45,6 +55,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -84,5 +95,3 @@ PIP package Version required ``paramiko`` ``>=2.6.0`` ``sshtunnel`` ``>=0.3.2`` ================== ================== - -.. include:: ../../airflow/providers/ssh/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-ssh/security.rst b/docs/apache-airflow-providers-ssh/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-ssh/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-tableau/changelog.rst b/docs/apache-airflow-providers-tableau/changelog.rst new file mode 100644 index 0000000000000..0e60b899d7016 --- /dev/null +++ b/docs/apache-airflow-providers-tableau/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-tableau`` +-------------------------------------------- + +.. include:: ../../airflow/providers/tableau/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-tableau/index.rst b/docs/apache-airflow-providers-tableau/index.rst index e8ed4076b0433..93677dcada225 100644 --- a/docs/apache-airflow-providers-tableau/index.rst +++ b/docs/apache-airflow-providers-tableau/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-tableau`` ======================================= -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -32,11 +40,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/tableau/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -48,6 +58,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -86,5 +97,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``tableauserverclient`` ======================= ================== - -.. include:: ../../airflow/providers/tableau/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-tableau/security.rst b/docs/apache-airflow-providers-tableau/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-tableau/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-tabular/changelog.rst b/docs/apache-airflow-providers-tabular/changelog.rst new file mode 100644 index 0000000000000..6257ac42c7f6d --- /dev/null +++ b/docs/apache-airflow-providers-tabular/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-tabular`` +-------------------------------------------- + +.. include:: ../../airflow/providers/tabular/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-tabular/index.rst b/docs/apache-airflow-providers-tabular/index.rst index 169237ba3ddb7..fd86848ea0901 100644 --- a/docs/apache-airflow-providers-tabular/index.rst +++ b/docs/apache-airflow-providers-tabular/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-tabular`` ==================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,11 +38,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/tabular/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -48,6 +58,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -85,5 +96,3 @@ PIP package Version required ================== ================== ``apache-airflow`` ``>=2.4.0`` ================== ================== - -.. include:: ../../airflow/providers/tabular/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-tabular/security.rst b/docs/apache-airflow-providers-tabular/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-tabular/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-telegram/changelog.rst b/docs/apache-airflow-providers-telegram/changelog.rst new file mode 100644 index 0000000000000..d4686e21b62db --- /dev/null +++ b/docs/apache-airflow-providers-telegram/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-telegram`` +--------------------------------------------- + +.. include:: ../../airflow/providers/telegram/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-telegram/index.rst b/docs/apache-airflow-providers-telegram/index.rst index d1e6948f84f82..75e7855c9f9f7 100644 --- a/docs/apache-airflow-providers-telegram/index.rst +++ b/docs/apache-airflow-providers-telegram/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-telegram`` ===================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -36,11 +45,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/telegram/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -52,6 +63,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -90,5 +102,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``python-telegram-bot`` ``>=20.0.0`` ======================= ================== - -.. include:: ../../airflow/providers/telegram/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-telegram/security.rst b/docs/apache-airflow-providers-telegram/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-telegram/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-trino/changelog.rst b/docs/apache-airflow-providers-trino/changelog.rst new file mode 100644 index 0000000000000..97f28e55cd186 --- /dev/null +++ b/docs/apache-airflow-providers-trino/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-trino`` +------------------------------------------ + +.. include:: ../../airflow/providers/trino/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-trino/index.rst b/docs/apache-airflow-providers-trino/index.rst index 7c5aca741c736..ebd3b2e0cd81b 100644 --- a/docs/apache-airflow-providers-trino/index.rst +++ b/docs/apache-airflow-providers-trino/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-trino`` ================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -31,6 +39,7 @@ Content Connection types .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -38,11 +47,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/trino/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -54,6 +65,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -123,5 +135,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-trino 5.1.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-trino 5.1.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/trino/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-trino/security.rst b/docs/apache-airflow-providers-trino/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-trino/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-vertica/changelog.rst b/docs/apache-airflow-providers-vertica/changelog.rst new file mode 100644 index 0000000000000..89424409bca9a --- /dev/null +++ b/docs/apache-airflow-providers-vertica/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-vertica`` +-------------------------------------------- + +.. include:: ../../airflow/providers/vertica/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-vertica/index.rst b/docs/apache-airflow-providers-vertica/index.rst index 127bd5f30ca07..db09f1924c4d7 100644 --- a/docs/apache-airflow-providers-vertica/index.rst +++ b/docs/apache-airflow-providers-vertica/index.rst @@ -19,16 +19,25 @@ ``apache-airflow-providers-vertica`` ==================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References Python API <_api/airflow/providers/vertica/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -39,6 +48,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -106,5 +116,3 @@ You can download officially released packages and verify their checksums and sig * `The apache-airflow-providers-vertica 3.4.1 sdist package `_ (`asc `__, `sha512 `__) * `The apache-airflow-providers-vertica 3.4.1 wheel package `_ (`asc `__, `sha512 `__) - -.. include:: ../../airflow/providers/vertica/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-vertica/security.rst b/docs/apache-airflow-providers-vertica/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-vertica/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/apache-airflow-providers-yandex/index.rst b/docs/apache-airflow-providers-yandex/index.rst index cae3b59eca333..8971a8537c159 100644 --- a/docs/apache-airflow-providers-yandex/index.rst +++ b/docs/apache-airflow-providers-yandex/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-yandex`` =================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: Guides @@ -30,6 +38,7 @@ Content Operators .. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -37,11 +46,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/yandex/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -53,6 +64,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits diff --git a/docs/apache-airflow-providers-zendesk/changelog.rst b/docs/apache-airflow-providers-zendesk/changelog.rst new file mode 100644 index 0000000000000..fe70585d1efed --- /dev/null +++ b/docs/apache-airflow-providers-zendesk/changelog.rst @@ -0,0 +1,22 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Package ``apache-airflow-providers-zendesk`` +-------------------------------------------- + +.. include:: ../../airflow/providers/zendesk/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-zendesk/index.rst b/docs/apache-airflow-providers-zendesk/index.rst index a8dfa53f3fed1..858319479f769 100644 --- a/docs/apache-airflow-providers-zendesk/index.rst +++ b/docs/apache-airflow-providers-zendesk/index.rst @@ -19,10 +19,18 @@ ``apache-airflow-providers-zendesk`` ==================================== -Content -------- .. toctree:: + :hidden: + :maxdepth: 1 + :caption: Basics + + Home + Changelog + Security + +.. toctree:: + :hidden: :maxdepth: 1 :caption: References @@ -30,11 +38,13 @@ Content .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/zendesk/index> .. toctree:: + :hidden: :maxdepth: 1 :caption: Resources @@ -46,6 +56,7 @@ Content .. toctree:: + :hidden: :maxdepth: 1 :caption: Commits @@ -84,5 +95,3 @@ PIP package Version required ``apache-airflow`` ``>=2.4.0`` ``zenpy`` ``>=2.0.24`` ================== ================== - -.. include:: ../../airflow/providers/zendesk/CHANGELOG.rst diff --git a/docs/apache-airflow-providers-zendesk/security.rst b/docs/apache-airflow-providers-zendesk/security.rst new file mode 100644 index 0000000000000..66c6f79a4ecfc --- /dev/null +++ b/docs/apache-airflow-providers-zendesk/security.rst @@ -0,0 +1,38 @@ + + .. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + .. http://www.apache.org/licenses/LICENSE-2.0 + + .. Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +Releasing security patches +-------------------------- + +Airflow providers are released independently from Airflow itself and the information about vulnerabilities +is published separately. You can upgrade providers independently from Airflow itself, following the +instructions found in :doc:`apache-airflow:installation/installing-from-pypi`. + +When we release Provider version, the development is always done from the ``main`` branch where we prepare +the next version. The provider uses strict `SemVer `_ versioning policy. Depending on +the scope of the change, Provider will get ''MAJOR'' version upgrade when there are +breaking changes, ``MINOR`` version upgrade when there are new features or ``PATCHLEVEL`` version upgrade +when there are only bug fixes (including security bugfixes) - and this is the only version that receives +security fixes by default, so you should upgrade to latest version of the provider if you want to receive +all released security fixes. + +The only exception to that rule is when we have a critical security fix and good reason to provide an +out-of-band release for the provider, in which case stakeholders in the provider might decide to cherry-pick +and prepare a branch for an older version of the provider following the +`mixed governance model `_ +and requires interested parties to cherry-pick and test the fixes. diff --git a/docs/conf.py b/docs/conf.py index f45956c9c0c88..5029f4c0dcc3b 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -356,13 +356,8 @@ def _get_rst_filepath_from_path(filepath: pathlib.Path): # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. html_show_copyright = False -# Theme configuration -if PACKAGE_NAME.startswith("apache-airflow-providers-"): - # Only hide hidden items for providers. For Chart and Airflow we are using the approach where - # TOC is hidden but sidebar still shows the content (but we are not doing it for providers). - html_theme_options: dict[str, Any] = {"hide_website_buttons": True, "sidebar_includehidden": False} -else: - html_theme_options = {"hide_website_buttons": True, "sidebar_includehidden": True} +html_theme_options: dict[str, Any] = {"hide_website_buttons": True, "sidebar_includehidden": True} + if FOR_PRODUCTION: html_theme_options["navbar_links"] = [ {"href": "/community/", "text": "Community"}, diff --git a/images/breeze/output-commands-hash.txt b/images/breeze/output-commands-hash.txt index a11e9d604e398..61e50641f2b6e 100644 --- a/images/breeze/output-commands-hash.txt +++ b/images/breeze/output-commands-hash.txt @@ -41,13 +41,13 @@ release-management:generate-issue-content-providers:07c55519fff305338a0b6e753201 release-management:generate-providers-metadata:faeb7ae3673b13420eda582b25fe9180 release-management:install-provider-packages:5838b06b78e3c5c6e8380024867a1a8d release-management:prepare-airflow-package:3ac14ea6d2b09614959c0ec4fd564789 -release-management:prepare-provider-documentation:2064d56ac48b74ff10c497492288cf94 +release-management:prepare-provider-documentation:c46cca914ef777f1e71158bfd30fd0ba release-management:prepare-provider-packages:8016a3222acacab5f5b342d9e1c0085c release-management:release-prod-images:9bf4731e91c435e9df17199c395a23fb release-management:start-rc-process:6aafbaceabd7b67b9a1af4c2f59abc4c release-management:start-release:acb384d86e02ff5fde1bf971897be17c release-management:verify-provider-packages:566c60fb1bfdc5ed7c4be590736891b2 -release-management:ce3623aaf58d4d4a2303db898d1f70a2 +release-management:11bb87706beda348eec0182fb9138eb4 sbom:generate-provider-requirements:c8ed5df2f97916553b45583f88c0ef6b sbom:update-sbom-information:17f914a25f1eee7ef6845fc4bc70fafa sbom:d9c57d78e23a29ec9cd0139e230e1811 diff --git a/images/breeze/output_release-management_prepare-provider-documentation.svg b/images/breeze/output_release-management_prepare-provider-documentation.svg index dc16a5ff8a3fa..795cb4fc81692 100644 --- a/images/breeze/output_release-management_prepare-provider-documentation.svg +++ b/images/breeze/output_release-management_prepare-provider-documentation.svg @@ -1,4 +1,4 @@ - + - + @@ -156,9 +156,15 @@ + + + + + + - Command: release-management prepare-provider-documentation + Command: release-management prepare-provider-documentation @@ -169,7 +175,7 @@ -Usage: breeze release-management prepare-provider-documentation [OPTIONS] [airbyte | alibaba | amazon | apache.beam | +Usage: breeze release-management prepare-provider-documentation [OPTIONS] [airbyte | alibaba | amazon | apache.beam |                                                                 apache.cassandra | apache.drill | apache.druid |                                                                 apache.flink | apache.hdfs | apache.hive |                                                                 apache.impala | apache.kafka | apache.kylin | @@ -189,23 +195,25 @@                                                                 ssh | tableau | tabular | telegram | trino | vertica |                                                                 zendesk]... -Prepare CHANGELOG, README and COMMITS information for providers. +Prepare CHANGELOG, README and COMMITS information for providers. -╭─ Provider documentation preparation flags ───────────────────────────────────────────────────────────────────────────╮ -│--debugDrop user in shell instead of running the command. Useful for debugging.│ -│--github-repository-gGitHub repository used to pull, push run images.(TEXT)[default: apache/airflow]│ -│--base-branchBase branch to use as diff for documentation generation (used for releasing from old │ -│branch)                                                                              │ -│(TEXT)                                                                               │ -│--only-min-version-updateOnly update minimum version in __init__.py files and regenerate corresponding        │ -│documentation                                                                        │ -╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ -╭─ Common options ─────────────────────────────────────────────────────────────────────────────────────────────────────╮ -│--verbose-vPrint verbose information about performed steps.│ -│--dry-run-DIf dry-run is set, commands are only printed, not executed.│ -│--answer-aForce answer to questions.(y | n | q | yes | no | quit)│ -│--help-hShow this message and exit.│ -╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ +╭─ Provider documentation preparation flags ───────────────────────────────────────────────────────────────────────────╮ +│--debugDrop user in shell instead of running the command. Useful for debugging.│ +│--github-repository-gGitHub repository used to pull, push run images.(TEXT)[default: apache/airflow]│ +│--base-branchBase branch to use as diff for documentation generation (used for releasing from old │ +│branch)                                                                              │ +│(TEXT)                                                                               │ +│--only-min-version-updateOnly update minimum version in __init__.py files and regenerate corresponding        │ +│documentation                                                                        │ +│--regenerate-missing-docsOnly regenerate missing documentation, do not bump version. Useful if templates were │ +│added and you need to regenerate documentation.                                      │ +╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ +╭─ Common options ─────────────────────────────────────────────────────────────────────────────────────────────────────╮ +│--verbose-vPrint verbose information about performed steps.│ +│--dry-run-DIf dry-run is set, commands are only printed, not executed.│ +│--answer-aForce answer to questions.(y | n | q | yes | no | quit)│ +│--help-hShow this message and exit.│ +╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ diff --git a/scripts/ci/docker-compose/_docker.env b/scripts/ci/docker-compose/_docker.env index ec53b2a433d7e..72ecc84f342fa 100644 --- a/scripts/ci/docker-compose/_docker.env +++ b/scripts/ci/docker-compose/_docker.env @@ -59,6 +59,7 @@ PACKAGE_FORMAT POSTGRES_VERSION PYTHONDONTWRITEBYTECODE PYTHON_MAJOR_MINOR_VERSION +REGENERATE_MISSING_DOCS REMOVE_ARM_PACKAGES RUN_TESTS RUN_SYSTEM_TESTS diff --git a/scripts/ci/docker-compose/base.yml b/scripts/ci/docker-compose/base.yml index 9967d7608b7ad..f4add05877dbe 100644 --- a/scripts/ci/docker-compose/base.yml +++ b/scripts/ci/docker-compose/base.yml @@ -72,6 +72,7 @@ services: - POSTGRES_VERSION=${POSTGRES_VERSION} - PYTHONDONTWRITEBYTECODE=${PYTHONDONTWRITEBYTECODE} - PYTHON_MAJOR_MINOR_VERSION=${PYTHON_MAJOR_MINOR_VERSION} + - REGENERATE_MISSING_DOCS=${REGENERATE_MISSING_DOCS} - REMOVE_ARM_PACKAGES=${REMOVE_ARM_PACKAGES} - RUN_TESTS=${RUN_TESTS} - RUN_SYSTEM_TESTS=${RUN_SYSTEM_TESTS} diff --git a/scripts/ci/pre_commit/pre_commit_check_system_tests_hidden_in_index.py b/scripts/ci/pre_commit/pre_commit_check_system_tests_hidden_in_index.py index 5765b5a7930f9..8dfb168a52782 100755 --- a/scripts/ci/pre_commit/pre_commit_check_system_tests_hidden_in_index.py +++ b/scripts/ci/pre_commit/pre_commit_check_system_tests_hidden_in_index.py @@ -51,6 +51,7 @@ def check_system_test_entry_hidden(provider_index: Path): expected_text = f""" .. toctree:: :hidden: + :maxdepth: 1 :caption: System tests System Tests <_api/tests/system/providers/{provider_path}/index>