Modules -> Containers: Clarify support and lifecycle (BSC#1230284)

SUSE · Sep 12, 2024 · 94a56ea · 94a56ea
1 parent bd69d0b
commit 94a56ea
Showing 1 changed file with 31 additions and 1 deletion.
diff --git a/xml/art_modules.xml b/xml/art_modules.xml
@@ -386,6 +386,35 @@
         This module contains packages relating to containers, including the container engine and
         core container-related tools such as on-premise registry.
       </para>
+      <important>
+        <title><package>docker-stable</package></title>
+        <para>
+          &suse; ships a package named <package>docker-stable</package>, based on selected versions
+          of the the Moby project, which is the upstream for <phrase
+          role="productname">&docker;</phrase>. When this version is no longer supported by the Moby
+          project, &suse; will provide reactive support for an additional 3 years, which may require
+          a LTSS subscription depending on the lifecycle of the underlying product.
+        </para>
+      </important>
+      <warning>
+        <title>Migration from <package>docker</package> to <package>docker-stable</package></title>
+        <para>
+          In alignment with Moby project practices, &suse; neither tests nor supports downgrading
+          <package>docker</package> to older versions. This policy is particularly relevant when
+          considering a migration from the latest <package>docker</package> package to the
+          <package>docker-stable</package> package, which in most cases would be an older version.
+          Such a downgrade can result in unexpected side effects, compatibility issues and even
+          disruptions to container production environments, and is not recommended for production
+          systems.
+        </para>
+      </warning>
+      <important>
+        <title>&docker; Swarm is not supported</title>
+        <para>
+          &suse; does not provide any support related to use of <phrase role="productname">&docker;
+            Swarm</phrase> orchestration. Related packages are shipped for customer convenience only.
+        </para>
+      </important>
       <itemizedlist>
         <listitem>
           <para>
@@ -399,7 +428,8 @@
         </listitem>
         <listitem>
           <para>
-            <emphasis role="bold">Lifecycle:</emphasis> 10 years
+            <emphasis role="bold">Lifecycle:</emphasis> By package; follows the upstream community
+            of the respective package.
           </para>
         </listitem>
         <listitem>