registry: deprecate Advanced Image Management

Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
This commit is contained in:
David Karlsson 2023-08-23 17:42:50 +02:00
parent 30feb94b3f
commit 73af630664
2 changed files with 18 additions and 6 deletions

View File

@ -83,7 +83,10 @@ tags:
The Advanced Image Management API endpoints allow you to manage Docker The Advanced Image Management API endpoints allow you to manage Docker
images across all repositories. images across all repositories.
For more information, see [Advanced Image Management dashboard](https://docs.docker.com/docker-hub/image-management/). **<span style="color: red;">Deprecated</span>**: Advanced Image
Management is deprecated, and scheduled for removal on November 15th, 2023.
For more information, see [Deprecation of Advanced Image Management](https://github.com/docker/roadmap/issues/534)
- name: audit-logs - name: audit-logs
x-displayName: Audit Logs x-displayName: Audit Logs
description: | description: |
@ -307,6 +310,7 @@ paths:
$ref: "#/components/responses/NotFound" $ref: "#/components/responses/NotFound"
/v2/namespaces/{namespace}/repositories/{repository}/images-summary: /v2/namespaces/{namespace}/repositories/{repository}/images-summary:
get: get:
deprecated: true
tags: tags:
- images - images
summary: Get summary of repository's images summary: Get summary of repository's images
@ -353,6 +357,7 @@ paths:
$ref: "#/components/schemas/ErrorResponse" $ref: "#/components/schemas/ErrorResponse"
/v2/namespaces/{namespace}/repositories/{repository}/images: /v2/namespaces/{namespace}/repositories/{repository}/images:
get: get:
deprecated: true
tags: tags:
- images - images
summary: Get details of repository's images summary: Get details of repository's images
@ -446,6 +451,7 @@ paths:
$ref: "#/components/schemas/ErrorResponse" $ref: "#/components/schemas/ErrorResponse"
/v2/namespaces/{namespace}/repositories/{repository}/images/{digest}/tags: /v2/namespaces/{namespace}/repositories/{repository}/images/{digest}/tags:
get: get:
deprecated: true
tags: tags:
- images - images
summary: Get image's tags summary: Get image's tags
@ -503,6 +509,7 @@ paths:
$ref: "#/components/schemas/ErrorResponse" $ref: "#/components/schemas/ErrorResponse"
/v2/namespaces/{namespace}/delete-images: /v2/namespaces/{namespace}/delete-images:
post: post:
deprecated: true
tags: tags:
- images - images
summary: Delete images summary: Delete images

View File

@ -4,14 +4,19 @@ keywords: dashboard, images, image management, inactive
title: Advanced Image Management dashboard title: Advanced Image Management dashboard
--- ---
> **Note** > **Deprecated**
> >
> Image management requires a > The Advanced Image Management dashboard and API are deprecated, and scheduled
> [Docker Pro, Team, or Business subscription](../subscription/index.md). > for removal on November 15th, 2023. You can continue to use the **Tags** in
> Docker Hub to manage tags for your repository.
>
> For more information, see [Deprecation of Advanced Image Management](https://github.com/docker/roadmap/issues/534)
{ .warning }
Advanced Image Management allows you to manage Docker images across all repositories and streamline storage in Docker Hub. Advanced Image Management allows you to manage Docker images across all repositories and streamline storage in Docker Hub.
It provides: It provides:
- A snapshot of your existing images - A snapshot of your existing images
- Allows you to view, sort, and filter images by tags, activity status, and date - Allows you to view, sort, and filter images by tags, activity status, and date
- Contains options to clean up your workspace by deleting images that are no longer required - Contains options to clean up your workspace by deleting images that are no longer required
@ -25,7 +30,7 @@ It provides:
## Understand image activity status and tags ## Understand image activity status and tags
An image retains its 'active' status if it's pulled or pushed in the last month. If there isnt any activity on the image in the last month, it's considered 'inactive'. An image retains its 'active' status if it's pulled or pushed in the last month. If there isnt any activity on the image in the last month, it's considered 'inactive'.
The dashboard also displays the old versions of images you have pushed. When you push an image to Docker Hub, you push a manifest, which is a list of all the layers of your image and the layers themselves. When you update an existing tag, only the new layers are pushed along with the new manifest which references the new layers. This new manifest gets the tag you specify when you push the image, such as `myNamespace/mytag:latest`. This doesn't remove the old manifests or the unique layers referenced by them from Hub. You can still use and reference these using the digest of the manifest if you know the SHA. The dashboard also displays the old versions of images you have pushed. When you push an image to Docker Hub, you push a manifest, which is a list of all the layers of your image and the layers themselves. When you update an existing tag, only the new layers are pushed along with the new manifest which references the new layers. This new manifest gets the tag you specify when you push the image, such as `myNamespace/mytag:latest`. This doesn't remove the old manifests or the unique layers referenced by them from Hub. You can still use and reference these using the digest of the manifest if you know the SHA.
@ -37,4 +42,4 @@ For example, let's assume that Image A is tagged as latest. You push anoth
## Advanced Image Management API ## Advanced Image Management API
The Advanced Image Management API endpoints allow you to manage Docker images across all repositories. For more information, see [Advanced Image management API](./api/latest.md). The Advanced Image Management API endpoints allow you to manage Docker images across all repositories. For more information, see [Advanced Image management API](./api/latest.md).