From 1f87e2ed1fb268c977cf43c900d6abb386e34a32 Mon Sep 17 00:00:00 2001 From: Jarek Potiuk Date: Fri, 17 Jun 2022 14:52:43 +0200 Subject: [PATCH] Add note about image regeneration in June 2022 Added note about reganerating images in June 2022. The noteis about image changes after refreshing are now better organized (around date of the change) - this should be more useful by the users who will look why their images have been refreshed. Related to: #24516 --- docs/docker-stack/changelog.rst | 37 ++++++++++++++++++++------------- docs/spelling_wordlist.txt | 1 + 2 files changed, 24 insertions(+), 14 deletions(-) diff --git a/docs/docker-stack/changelog.rst b/docs/docker-stack/changelog.rst index c8cd754366787..45524f3060fef 100644 --- a/docs/docker-stack/changelog.rst +++ b/docs/docker-stack/changelog.rst @@ -34,14 +34,29 @@ the Airflow team. any Airflow version from the ``Airflow 2`` line. There is no guarantee that it works, but if it does, then you can use latest features from that image to build the previous Airflow versions. -:warning: Some of the images below (as noted in the Changelog) have been regenerated using newer - ``Dockerfiles``. This happens when there is a breaking change that invalidates already released images - and the images need regeneration. This has happened already when MySQL changed the keys they - used to release their packages: `#20911 `_ - and 2.1 images were all regenerated using the 2.2 ``Dockerfile``. This is a rare event and - we do it only when we have no choice because of external factors. In such case, the newer version of - the image **might** contain breaking changes when it comes to running or building the image (but - we try to avoid those). +Changes after publishing the images +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Important note! + +Occasionally our images need to be regenerated using newer ``Dockerfiles`` or constraints. +This happens when an issue is found or a breaking change is released by our dependencies +that invalidates the already released image, and regenerating the image makes it usable again. +While we cannot assure 100% backwards compatibility when it happens, we at least document it +here so that users affected can find the reason for the changes. + ++--------------+---------------------+-----------------------------------------+------------------------+----------------------------------------------+ +| Date | Affected images | Potentially breaking change | Reason | Link to Pull Request | ++==============+=====================+=========================================+========================+==============================================+ +| 17 June 2022 | 2.2.5 | * The ``Authlib`` library downgraded | Flask App Builder | https://github.com/apache/airflow/pull/24516 | +| | 2.3.0-2.3.2 | from 1.0.1 to 0.15.5 version | not compatible with | | +| | | | Authlib >= 1.0.0 | | ++--------------+---------------------+-----------------------------------------+------------------------+----------------------------------------------+ +| 18 Jan 2022 | All 2.2.\*, 2.1.\* | * The AIRFLOW_GID 500 was removed | MySQL changed keys | https://github.com/apache/airflow/pull/20912 | +| | | * MySQL ``apt`` repository key changed. | to sign their packages | | +| | | | on 17 Jan 2022 | | ++--------------+---------------------+-----------------------------------------+------------------------+----------------------------------------------+ + Airflow 2.3 ~~~~~~~~~~~ @@ -67,12 +82,6 @@ Airflow 2.3 Airflow 2.2 ~~~~~~~~~~~ -* MySQL changed the keys to sign their packages on 17 Feb 2022. This caused all released images - to fail when being extended. As result, on 18 Feb 2021 we re-released all - the ``2.2`` and ``2.1`` images with latest versions of ``Dockerfile`` - containing the new signing keys. The - detailed `issue here `_ - * 2.2.4 * Add support for both ``.piprc`` and ``pip.conf`` customizations * Add ArtifactHub labels for better discovery of the images diff --git a/docs/spelling_wordlist.txt b/docs/spelling_wordlist.txt index 5bee2e2783099..d91c742ab189d 100644 --- a/docs/spelling_wordlist.txt +++ b/docs/spelling_wordlist.txt @@ -26,6 +26,7 @@ Async AsyncResult Atlassian Auth +Authlib AutoMlClient Autoscale Avro