Remove unrelated files from PR

This commit is contained in:
Maria Bermudez 2018-08-31 22:51:44 -07:00
parent d24486fedb
commit e14861d3db
2 changed files with 0 additions and 89 deletions

View File

@ -1,89 +0,0 @@
---
title: Online Garbage collection
description: Save disk space by configuring the garbage collection settings in
Docker Trusted Registry
keywords: registry, online garbage collection, gc, space, disk space
---
> BETA DISCLAIMER
>
> This is beta content. It is not yet complete and should be considered a work in progress. This content is subject to change without notice.
You can configure Docker Trusted Registry to automatically delete unused image
layers, thus saving you disk space. This process is also known as garbage collection.
## How DTR deletes unused layers
First you configure DTR to run a garbage collection job on a fixed schedule. At
the scheduled time DTR:
2. Identifies and marks unused image layers.
3. Deletes the marked image layers.
As of v2.6.0, online garbage collection is no longer in experimental mode. This means that the registry no longer has to be in read-only mode (or offline) during garbage collection.
## Schedule garbage collection
In your browser, navigate to `https://<dtr-url>` and log in to the DTR web UI with your credentials. Select **System** on the left navigation pane then click
the **Garbage collection** tab to enable garbage collection.
![](../../images/garbage-collection-0.png){: .with-border}
Select for how long the garbage collection job should run:
* Until done: Run the job until all unused image layers are deleted.
* For x minutes: Only run the garbage collection job for a maximum of x minutes
at a time.
* Never: Never delete unused image layers.
Once you select for how long to run the garbage collection job, you can
configure its schedule (in UTC time) using the cron format.
![](../../images/garbage-collection-2.png){: .with-border}
Once everything is configured you can chose to **Save & start** to immediately
run the garbage collection job, or just **Save** to run the job on the next
scheduled interval.
## Stop the garbage collection job
Once the garbage collection job starts running, a banner is displayed on the
web UI explaining that users can't push images. If you're an administrator, you can click the banner to stop the garbage
collection job.
![](../../images/garbage-collection-3.png){: .with-border}
## Under the hood
Each image stored in DTR is made up of multiple files:
* A list of image layers that represent the image filesystem.
* A configuration file that contains the architecture of the image and other
metadata.
* A manifest file containing the list of all layers and configuration file for
an image.
All these files are stored in a content-addressable way in which the name of
the file is the result of hashing the file's content. This means that if two
image tags have exactly the same content, DTR only stores the image content
once, even if the tag name is different.
As an example, if `wordpress:4.8` and `wordpress:latest` have the same content,
they will only be stored once. If you delete one of these tags, the other won't
be deleted.
This means that when users delete an image tag, DTR can't delete the underlying
files of that image tag since it's possible that there are other tags that
also use the same files.
To delete unused image layers, DTR:
1. Becomes read-only to make sure that no one is able to push an image, thus
changing the underlying files in the filesystem.
2. Check all the manifest files and keep a record of the files that are
referenced.
3. If a file is never referenced, that means that no image tag uses it, so it
can be safely deleted.
## Where to go next
- [Deploy DTR caches](deploy-caches/index.md)

Binary file not shown.

Before

Width:  |  Height:  |  Size: 41 KiB