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:
Craig Osterhout 2025-02-19 10:57:09 -08:00 committed by GitHub
parent f488c8a10d
commit 9bfe7ad474
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
6 changed files with 67 additions and 2 deletions

View File

@ -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

View File

@ -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

View File

@ -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.
![a pretty wide image](./images/image-index.svg)
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**.

View File

@ -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).

View File

@ -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