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. 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 ## 2024-12-12
### New ### 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 tasks, including tagging, pushing images, transferring images between
repositories, and supported software artifacts. repositories, and supported software artifacts.
- [Tags](./tags.md): Tags help you version and organize different iterations of - [Tags](./tags.md): Tags help you version and organize different iterations of
your images within a single repository. This topic explains tagging and your images within a single repository. This topic explains tagging and
provides guidance on how to create, view, and delete tags in Docker Hub. 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 - [Software artifacts](./oci-artifacts.md): Docker Hub supports OCI (Open
Container Initiative) artifacts, allowing you to store, manage, and distribute Container Initiative) artifacts, allowing you to store, manage, and distribute
a range of content beyond standard Docker images, including Helm charts, 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: 4. Optimize your storage by:
- Regularly auditing and removing repositories with untagged, unused, or outdated images. - Regularly auditing and [removing entire repositories](../repos/delete.md) with untagged, unused, or outdated images.
- Looking for private repositories in Hub storage that exceed your plan's limits. - 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 5. Increase your limits by upgrading or purchasing additional consumption. For
details, see [Scale your subscription](/manuals/subscription/scale.md). details, see [Scale your subscription](/manuals/subscription/scale.md).

View File

@ -150,6 +150,8 @@ GitHub Actions cache:
Hardened Docker Desktop: Hardened Docker Desktop:
subscription: [Business] subscription: [Business]
for: Administrators for: Administrators
Image management:
availability: Beta
Import builds: Import builds:
availability: Beta availability: Beta
requires: Docker Desktop [4.31](/manuals/desktop/release-notes.md#4310) and later requires: Docker Desktop [4.31](/manuals/desktop/release-notes.md#4310) and later