Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add note about image regeneration in June 2022 #24524

Merged
merged 4 commits into from
Jun 23, 2022
Merged

Add note about image regeneration in June 2022 #24524

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
1f87e2e
Add note about image regeneration in June 2022
potiuk Jun 17, 2022
6300b07
Update docs/docker-stack/changelog.rst
potiuk Jun 22, 2022
7429f25
Update docs/docker-stack/changelog.rst
potiuk Jun 22, 2022
a804e59
Update docs/docker-stack/changelog.rst
jedcunningham Jun 22, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 21 additions & 14 deletions docs/docker-stack/changelog.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,14 +34,27 @@ 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 <https://github.com/apache/airflow/issues/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
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

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 |
| | | from 1.0.1 to 0.15.5 version | not compatible with | |
| | 2.3.0-2.3.2 | | Authlib >= 1.0.0 | |
jedcunningham marked this conversation as resolved.
Show resolved Hide resolved
+--------------+---------------------+-----------------------------------------+------------------------+----------------------------------------------+
| 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
~~~~~~~~~~~
Expand All @@ -67,12 +80,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 <https://github.com/apache/airflow/issues/20911>`_

* 2.2.4
* Add support for both ``.piprc`` and ``pip.conf`` customizations
* Add ArtifactHub labels for better discovery of the images
Expand Down
1 change: 1 addition & 0 deletions docs/spelling_wordlist.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@ Async
AsyncResult
Atlassian
Auth
Authlib
AutoMlClient
Autoscale
Avro
Expand Down