From Fedora Project Wiki
(Owner)
Line 37: Line 37:
 
<!-- Include you email address that you can be reached should people want to contact you about helping with your change, status is requested, or technical issues need to be resolved. If the change proposal is owned by a SIG, please also add a primary contact person. -->
 
<!-- Include you email address that you can be reached should people want to contact you about helping with your change, status is requested, or technical issues need to be resolved. If the change proposal is owned by a SIG, please also add a primary contact person. -->
 
* Email: lsm5@fedoraproject.org, dwalsh@redhat.com
 
* Email: lsm5@fedoraproject.org, dwalsh@redhat.com
<your email address so we can contact you, invite you to meetings, etc.>
 
 
* Release notes owner: <!--- To be assigned by docs team [[User:FASAccountName| Release notes owner name]] <email address> -->
 
* Release notes owner: <!--- To be assigned by docs team [[User:FASAccountName| Release notes owner name]] <email address> -->
 
<!--- UNCOMMENT only for Changes with assigned Shepherd (by FESCo)
 
<!--- UNCOMMENT only for Changes with assigned Shepherd (by FESCo)
Line 47: Line 46:
 
-->
 
-->
 
* Product: Workstation, Atomic Host, Server
 
* Product: Workstation, Atomic Host, Server
 +
 
== Current status ==
 
== Current status ==
 
* Targeted release: [[Releases/F26 | Fedora 26 ]]  
 
* Targeted release: [[Releases/F26 | Fedora 26 ]]  

Revision as of 19:53, 6 January 2017

Self Container Change: This change will only affect users of the docker package.


Change Proposal Name

Summary

Change the default Docker Storage to be overlay2

Owner

  • Name: Lokesh Mandvekar
  • Name: Dan Walsh
  • Email: lsm5@fedoraproject.org, dwalsh@redhat.com
  • Release notes owner:
  • Product: Workstation, Atomic Host, Server

Current status

  • Targeted release: Fedora 26
  • Last updated: 2017-01-06
  • Tracker bug: <will be assigned by the Wrangler>

Detailed Description

Upstream docker is moving to overlay2 by default for its storage. We plan on following suit. Their are some performance advantages of overlay2 over devicemapper in memory sharing, which we would like to take advantage of. We now have SELinux support for Overlay file systems, so the security should be just as good.

Note: Overlay is not a Posix Compliant file system, so their could be problems with your containers running on overlay, so we want to make sure it is fairly easy to switch back to devicemapper.

Devicemapper out of the box, on Fedora Workstation, currently defaults to loopback devices for storage, which has a performance penalty, but this was the only way we were able to get docker to work right away. Switching to overlay2 will cause the storage to be shared with / and will eliminate this performance overhead. This is the way we will ship Fedora Workstation.

On Fedora atomic host and Fedora server we have been storing devicemapper storage on a separate partition. We plan on doing the same thing with overlay2. This means separate device will be mounted on /var/lib/docker. This will make it easier for someone to switch back to devicemapper, if overlay2 has problems.

Upgraded systems will not be effected.

If you want to switch from one storage to another take a look at the atomic storage commands.

We will write up release notes to cover this change. Along with a blog explaining the commands to switch back and forth.


Benefit to Fedora

Better performance of docker containers. Show that Fedora is leading the way in container development.


Scope

  • Proposal owners: Dan Walsh
  • Other developers: N/A (not a System Wide Change)
  • Release engineering: N/A (not a System Wide Change)
  • Policies and guidelines: N/A (not a System Wide Change)
  • Trademark approval: N/A (not needed for this Change)

Upgrade/compatibility impact

N/A (not a System Wide Change)

How To Test

Install a fresh docker, make sure the default storage is on overlay,if installing on atomic host or Fedora Server, make sure the overlay file system is setup on a different partion, and it mounted after a reboot.

Make sure you can switch from overlay2 back to devicemapper using atomic storage commands. N/A (not a System Wide Change)

User Experience

N/A (not a System Wide Change) Users should not notice the change other then if they use the docker or atomic CLI to examine the storage.

Dependencies

N/A (not a System Wide Change)

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
  • Blocks product? product

Documentation

N/A (not a System Wide Change)

Release Notes

Category:ChangeReadyForFesco