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.
|
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
|
||||||
|
|
|
||||||
|
|
@ -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 |
|
|
@ -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:
|
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).
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue