diff --git a/content/manuals/docker-hub/release-notes.md b/content/manuals/docker-hub/release-notes.md index 18efecb5d3..8c0893f226 100644 --- a/content/manuals/docker-hub/release-notes.md +++ b/content/manuals/docker-hub/release-notes.md @@ -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 diff --git a/content/manuals/docker-hub/repos/manage/hub-images/_index.md b/content/manuals/docker-hub/repos/manage/hub-images/_index.md index 726eb78892..7d522bdc00 100644 --- a/content/manuals/docker-hub/repos/manage/hub-images/_index.md +++ b/content/manuals/docker-hub/repos/manage/hub-images/_index.md @@ -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, diff --git a/content/manuals/docker-hub/repos/manage/hub-images/images/image-index.svg b/content/manuals/docker-hub/repos/manage/hub-images/images/image-index.svg new file mode 100644 index 0000000000..321721c245 --- /dev/null +++ b/content/manuals/docker-hub/repos/manage/hub-images/images/image-index.svg @@ -0,0 +1,2 @@ +Image indexImage indexImageImageImageImageImageImageImageImageImage \ No newline at end of file diff --git a/content/manuals/docker-hub/repos/manage/hub-images/manage.md b/content/manuals/docker-hub/repos/manage/hub-images/manage.md new file mode 100644 index 0000000000..5cb89a9222 --- /dev/null +++ b/content/manuals/docker-hub/repos/manage/hub-images/manage.md @@ -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**. \ No newline at end of file diff --git a/content/manuals/docker-hub/usage/manage.md b/content/manuals/docker-hub/usage/manage.md index 395a58a65f..9e81b01ad1 100644 --- a/content/manuals/docker-hub/usage/manage.md +++ b/content/manuals/docker-hub/usage/manage.md @@ -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). diff --git a/data/summary.yaml b/data/summary.yaml index bd6a6ee195..30a33a8dc5 100644 --- a/data/summary.yaml +++ b/data/summary.yaml @@ -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