mirror of https://github.com/docker/docs.git
hub: add image management (#22052)
<!--Delete sections as needed --> ## Description Added topic for new image management feature. Updated usage management topic to reference new topic. Updated release notes. - https://deploy-preview-22052--docsdocker.netlify.app/docker-hub/repos/manage/hub-images/ - https://deploy-preview-22052--docsdocker.netlify.app/docker-hub/repos/manage/hub-images/manage/ - https://deploy-preview-22052--docsdocker.netlify.app/docker-hub/usage/manage/ - https://deploy-preview-22052--docsdocker.netlify.app/docker-hub/release-notes/ ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Signed-off-by: Craig <craig.osterhout@docker.com> Co-authored-by: Sarah Sanders <sarah.sanders@docker.com>
This commit is contained in:
parent
f488c8a10d
commit
9bfe7ad474
|
|
@ -15,6 +15,12 @@ known issues for each Docker Hub release.
|
|||
|
||||
Take a look at the [Docker Public Roadmap](https://github.com/orgs/docker/projects/51/views/1?filterQuery=) to see what's coming next.
|
||||
|
||||
## 2025-02-18
|
||||
|
||||
### New
|
||||
|
||||
- You can delete images and image indexes using [Image Management](./repos/manage/hub-images/manage.md).
|
||||
|
||||
## 2024-12-12
|
||||
|
||||
### New
|
||||
|
|
|
|||
|
|
@ -12,9 +12,12 @@ version-controlled, and easy to share. This section covers key image management
|
|||
tasks, including tagging, pushing images, transferring images between
|
||||
repositories, and supported software artifacts.
|
||||
|
||||
|
||||
- [Tags](./tags.md): Tags help you version and organize different iterations of
|
||||
your images within a single repository. This topic explains tagging and
|
||||
provides guidance on how to create, view, and delete tags in Docker Hub.
|
||||
- [Image Management](./manage.md): Manage your images and image indexes to
|
||||
optimize your repository storage.
|
||||
- [Software artifacts](./oci-artifacts.md): Docker Hub supports OCI (Open
|
||||
Container Initiative) artifacts, allowing you to store, manage, and distribute
|
||||
a range of content beyond standard Docker images, including Helm charts,
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 21 KiB |
|
|
@ -0,0 +1,52 @@
|
|||
---
|
||||
description: Discover how to delete image tags.
|
||||
keywords: Docker Hub, Hub, tags, delete
|
||||
title: Image Management
|
||||
linktitle: Image Management
|
||||
weight: 12
|
||||
---
|
||||
|
||||
{{< summary-bar feature_name="Image management" >}}
|
||||
|
||||
Images and image indexes are the foundation of container images within a
|
||||
repository. The following diagram shows the relationship between images and
|
||||
image indexes.
|
||||
|
||||

|
||||
|
||||
This structure enables multi-architecture support through a single reference. It
|
||||
is important to note that images are not always referenced by an image index.
|
||||
The following objects are shown in the diagram.
|
||||
|
||||
- Image index: An image that points to multiple architecture-specific images
|
||||
(like AMD and ARM), letting a single reference work across different
|
||||
platforms.
|
||||
- Image: Individual container images that contain the actual configuration and
|
||||
layers for a specific architecture and operating system.
|
||||
|
||||
## Manage repository images and image indexes
|
||||
|
||||
1. Sign in to [Docker Hub](https://hub.docker.com).
|
||||
2. Select **Repositories**.
|
||||
3. In the list, select a repository.
|
||||
4. Select **Image Management**.
|
||||
5. Search, filter, or sort the items.
|
||||
- Search: In the search box above the list, specify your search.
|
||||
- Filter: In the **Filter by** drop-down, select **Tagged**, **Image index**,
|
||||
or **Image**.
|
||||
- Sort: Select the column title for **Size**, **Last pushed**, or **Last
|
||||
pulled**.
|
||||
|
||||
> [!NOTE]
|
||||
>
|
||||
> Images that haven't been pulled in over 6 months are marked as **Stale** in
|
||||
> the **Status** column.
|
||||
|
||||
6. Optional. Delete one or more items.
|
||||
1. Select the checkboxes next to the items in the list. Selecting any
|
||||
top-level index also removes any underlying images that aren't referenced
|
||||
elsewhere.
|
||||
2. Select **Preview and delete**.
|
||||
3. In the window that appears, verify the items that will be deleted and the
|
||||
amount of storage you will reclaim.
|
||||
4. Select **Delete forever**.
|
||||
|
|
@ -33,8 +33,8 @@ both individuals and organizations:
|
|||
|
||||
4. Optimize your storage by:
|
||||
|
||||
- Regularly auditing and removing repositories with untagged, unused, or outdated images.
|
||||
- Looking for private repositories in Hub storage that exceed your plan's limits.
|
||||
- Regularly auditing and [removing entire repositories](../repos/delete.md) with untagged, unused, or outdated images.
|
||||
- Using [Image Management](../repos/manage/hub-images/manage.md) to remove stale and outdated images within a repository.
|
||||
|
||||
5. Increase your limits by upgrading or purchasing additional consumption. For
|
||||
details, see [Scale your subscription](/manuals/subscription/scale.md).
|
||||
|
|
|
|||
|
|
@ -150,6 +150,8 @@ GitHub Actions cache:
|
|||
Hardened Docker Desktop:
|
||||
subscription: [Business]
|
||||
for: Administrators
|
||||
Image management:
|
||||
availability: Beta
|
||||
Import builds:
|
||||
availability: Beta
|
||||
requires: Docker Desktop [4.31](/manuals/desktop/release-notes.md#4310) and later
|
||||
|
|
|
|||
Loading…
Reference in New Issue