From Fedora Project Wiki
(adding release notes tracker)
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{admon/important | Comments and Explanations | The page source contains comments providing guidance to fill out each section. They are invisible when viewing this page. To read it, choose the "view source" link.<br/> '''Copy the source to a ''new page'' before making changes!  DO NOT EDIT THIS TEMPLATE FOR YOUR CHANGE PROPOSAL.'''}}
{{admon/tip | Guidance | For details on how to fill out this form, see the [https://docs.fedoraproject.org/en-US/program_management/changes_guide/ documentation].}}
{{admon/tip | Report issues | To report an issue with this template, file an issue in the [https://pagure.io/fedora-pgm/pgm_docs pgm_docs repo].}}
<!-- The actual name of your proposed change page should look something like: Changes/Your_Change_Proposal_Name.  This keeps all change proposals in the same namespace -->
= Podman 5 <!-- The name of your change proposal --> =
= Podman 5 <!-- The name of your change proposal --> =
{{Change_Proposal_Banner}}


== Summary ==
== Summary ==
We plan to ship Podman 5 in Fedora 40. Podman 5 will introduce some breaking changes over Podman 4.
Ship Podman 5 in Fedora 40.
<!-- A sentence or two summarizing what this change is and what it will do. This information is used for the overall changeset summary page for each release. Note that motivation for the change should be in the Benefit to Fedora section below, and this part should answer the question "What?" rather than "Why?". -->
<!-- A sentence or two summarizing what this change is and what it will do. This information is used for the overall changeset summary page for each release. Note that motivation for the change should be in the Benefit to Fedora section below, and this part should answer the question "What?" rather than "Why?". -->


Line 28: Line 18:


== Current status ==
== Current status ==
[[Category:ChangePageIncomplete]]
[[Category:ChangeAcceptedF40]]
<!-- When your change proposal page is completed and ready for review and announcement -->
<!-- When your change proposal page is completed and ready for review and announcement -->
<!-- remove Category:ChangePageIncomplete and change it to Category:ChangeReadyForWrangler -->
<!-- remove Category:ChangePageIncomplete and change it to Category:ChangeReadyForWrangler -->
Line 46: Line 36:
ON_QA -> change is fully code complete
ON_QA -> change is fully code complete
-->
-->
* [<will be assigned by the Wrangler> devel thread]
* [https://lists.fedoraproject.org/archives/list/devel-announce@lists.fedoraproject.org/thread/ES4M2ZTGASS2P3G2EM57LNXIP2FFWIHD/ Announced]
* FESCo issue: <will be assigned by the Wrangler>
*[https://discussion.fedoraproject.org/t/f40-change-proposal-podman-5-self-contained/98914 Discussion thread]
* Tracker bug: <will be assigned by the Wrangler>
* FESCo issue: [https://pagure.io/fesco/issue/3126 #3126]
* Release notes tracker: <will be assigned by the Wrangler>
* Tracker bug: [https://bugzilla.redhat.com/show_bug.cgi?id=2258071 #2258071]
* Release notes tracker: [https://pagure.io/fedora-docs/release-notes/issue/1096 #1096]


== Detailed Description ==
== Detailed Description ==
Line 58: Line 49:


== Benefit to Fedora ==
== Benefit to Fedora ==
Podman 5 will:
* No longer support cgroups v1
* Deprecate CNI plugins
* Deprecate Boltdb
* Have passt as the default rootless network service instead of slirp4netns
* Support stable `--format` Go template structs
* Isolate podman bindings leading to improved usability
* Allow better handling of containers.conf
<!-- What is the benefit to the distribution?  Will the software we generate be improved? How will the process of creating Fedora releases be improved?
<!-- What is the benefit to the distribution?  Will the software we generate be improved? How will the process of creating Fedora releases be improved?
    
    
Line 107: Line 107:


== Upgrade/compatibility impact ==
== Upgrade/compatibility impact ==
Podman 5 will come with breaking changes affecting upgradability:
* CGroups v1 environments will be required to switch to CGroups v2
* CNI plugin environemnts will need to switch to netavark
* Changes in `--format` Go template structs
<!-- What happens to systems that have had a previous versions of Fedora installed and are updated to the version containing this change? Will anything require manual configuration or data migration? Will any existing functionality be no longer supported? -->
<!-- What happens to systems that have had a previous versions of Fedora installed and are updated to the version containing this change? Will anything require manual configuration or data migration? Will any existing functionality be no longer supported? -->


<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->


== How To Test ==
Probably best handled in a Podman Test Day aligned with Fedora 40 Test Days.


== How To Test ==
* Install Fedora 40
* Install Podman 5
* Run test cases / suite (TBD)
<!-- This does not need to be a full-fledged document. Describe the dimensions of tests that this change implementation is expected to pass when it is done.  If it needs to be tested with different hardware or software configurations, indicate them.  The more specific you can be, the better the community testing can be.  
<!-- This does not need to be a full-fledged document. Describe the dimensions of tests that this change implementation is expected to pass when it is done.  If it needs to be tested with different hardware or software configurations, indicate them.  The more specific you can be, the better the community testing can be.  


Line 129: Line 140:
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->


== User Experience ==
Podman 5 will provide better usability of Podman bindings, easier to maintain containers.conf and other configuration files along with database performance improvements and CLI enhancements.


== User Experience ==
<!-- If this change proposal is noticeable by users, how will their experiences change as a result?
<!-- If this change proposal is noticeable by users, how will their experiences change as a result?


Line 143: Line 156:


== Dependencies ==
== Dependencies ==
Projects / Packages likely to be affected:
* Cockpit
* CoreOS
* Toolbox
* Silverblue / Kinoite
* Podman Desktop
<!-- What other packages (RPMs) depend on this package?  Are there changes outside the developers' control on which completion of this change depends?  In other words, completion of another change owned by someone else and might cause you to not be able to finish on time or that you would need to coordinate?  Other upstream projects like the kernel (if this is not a kernel change)? -->
<!-- What other packages (RPMs) depend on this package?  Are there changes outside the developers' control on which completion of this change depends?  In other words, completion of another change owned by someone else and might cause you to not be able to finish on time or that you would need to coordinate?  Other upstream projects like the kernel (if this is not a kernel change)? -->


<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->


== Contingency Plan ==
== Contingency Plan ==

Latest revision as of 20:37, 28 February 2024

Podman 5

Summary

Ship Podman 5 in Fedora 40.

Owner


Current status

Detailed Description

Feedback

Benefit to Fedora

Podman 5 will:

  • No longer support cgroups v1
  • Deprecate CNI plugins
  • Deprecate Boltdb
  • Have passt as the default rootless network service instead of slirp4netns
  • Support stable --format Go template structs
  • Isolate podman bindings leading to improved usability
  • Allow better handling of containers.conf


Scope

  • Proposal owners:
  • Other developers:
  • Policies and guidelines: N/A (not needed for this Change)
  • Trademark approval: N/A (not needed for this Change)
  • Alignment with Community Initiatives:

Upgrade/compatibility impact

Podman 5 will come with breaking changes affecting upgradability:

  • CGroups v1 environments will be required to switch to CGroups v2
  • CNI plugin environemnts will need to switch to netavark
  • Changes in --format Go template structs



How To Test

Probably best handled in a Podman Test Day aligned with Fedora 40 Test Days.

  • Install Fedora 40
  • Install Podman 5
  • Run test cases / suite (TBD)


User Experience

Podman 5 will provide better usability of Podman bindings, easier to maintain containers.conf and other configuration files along with database performance improvements and CLI enhancements.


Dependencies

Projects / Packages likely to be affected:

  • Cockpit
  • CoreOS
  • Toolbox
  • Silverblue / Kinoite
  • Podman Desktop


Contingency Plan

  • Contingency mechanism: (What to do? Who will do it?) N/A (not a System Wide Change)
  • Contingency deadline: N/A (not a System Wide Change)
  • Blocks release? N/A (not a System Wide Change), Yes/No


Documentation

N/A (not a System Wide Change)

Release Notes