| (4 intermediate revisions by 2 users not shown) | |||
| Line 26: | Line 26: | ||
== Summary == | == Summary == | ||
<!-- 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. --> | <!-- 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. --> | ||
Change the default Docker Storage to | Change the default Docker Storage to use OverlayFS via the overlay2 driver, for better performance. | ||
== Owner == | == Owner == | ||
| Line 58: | Line 58: | ||
CLOSED as NEXTRELEASE -> change is completed and verified and will be delivered in next release under development | CLOSED as NEXTRELEASE -> change is completed and verified and will be delivered in next release under development | ||
--> | --> | ||
* Tracker bug: | * Tracker bug: [https://bugzilla.redhat.com/show_bug.cgi?id=1419514 #1419514] | ||
== Detailed Description == | == Detailed Description == | ||
| Line 66: | Line 66: | ||
Upstream docker is moving to overlay2 by default for its storage. We | Upstream docker is moving to overlay2 by default for its storage. We | ||
plan on following suit. | plan on following suit. (This is an updated driver for the OverlayFS | ||
filesystem, not a second overlay filesystem.) There are some performance advantages of | |||
overlay2 over devicemapper in memory sharing, which we would like to | overlay2 over devicemapper in memory sharing, which we would like to | ||
take advantage of. We now have SELinux support for Overlay file | take advantage of. We now have SELinux support for Overlay file | ||
systems, so the security should be just as good. | systems, so the security should be just as good. | ||
Note: Overlay is not a Posix Compliant file system, so there could be | Note: Overlay is not a Posix Compliant file system, so there could be | ||
| Line 182: | Line 183: | ||
--> | --> | ||
[[Category: | [[Category:ChangeAcceptedF26]] | ||
<!-- 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 --> | ||
Latest revision as of 11:49, 6 February 2017
Self Container Change: This change will only affect users of the docker package.
Docker Overlay 2
Summary
Change the default Docker Storage to use OverlayFS via the overlay2 driver, for better performance.
Owner
- Name: Lokesh Mandvekar
- Name: Dan Walsh
- Email: lsm5@fedoraproject.org, dwalsh@redhat.com
- Release notes owner:
- Product: Workstation, Atomic Host, Server
Current status
Detailed Description
Upstream docker is moving to overlay2 by default for its storage. We plan on following suit. (This is an updated driver for the OverlayFS filesystem, not a second overlay filesystem.) There 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 there 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: Implementation of this Change
- Other developers: N/A (not a System Wide Change)
- Release engineering: N/A (not a System Wide Change)
- List of deliverables: 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:ChangeReadyForWrangler