docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Add docs for new expanded Image Details page (#16524) 

* Add docs for new expanded Image Details page

* Review comments on desktop/use-desktop/images.md

Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>

Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
This commit is contained in:
Mike Parker 2023-01-16 13:44:18 +00:00 committed by GitHub
parent de28d551ff
commit 16b8ede850
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 24 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
desktop/use-desktop/images.md
View File

@ -41,14 +41,36 @@ When prompted you can either:
## Inspect an image
Inspecting an image displays detailed information about the image such as the:
To inspect an image, simply select the image row. Inspecting an image displays detailed information about the image such as the:
- Image history
- Image ID
- Date the image was created
- Size of the image
- Layers making up the image
- Base images used
- Vulnerabilities found
- Packages inside the image
To inspect an image, hover over an image, select the **More options** button and then select **View details** from the dropdown menu.
### Image Hierarchy
The image you inspect may have one or more base images listed under **Image hierarchy**. This means the author of the image used another image as a starting point when building the image. Often these base images are either operating system images such as Debian, Ubuntu, and Alpine, or programming language images such as PHP, Python, and Java.
A base image may have its own parent base image so there is a chain of base images represented in **Image hierarchy**. Selecting each image in the chain lets you see which layers originate from each base image. Selecting the **ALL** row reselects all the layers and base images for the entire image.
One or more of the base images may have updates available, which may include updated security patches that remove vulnerabilities from your image. Any base images with available updates are noted to the right of **Image hierarchy**.
### Layers
A Docker image consists of layers. Image layers are listed from top to bottom, with the earliest layer at the top and the most recent layer at the bottom. Often, the layers at the top of the list originate from a base image, and the layers towards the bottom are layers added by the image author, often by adding commands to a Dockerfile. To see which layers originate from a base image, simply select a base image under **Image hierarchy** and the relevant layers are highlighted.
Selecting individual or multiple layers filters the packages and vulnerabilities on the right-hand side to see what has been added by the selected layers.
### Vulnerabilities
Images may be exposed to vulnerabilities and exploits. These are detected and listed on the right-hand side, grouped by package, and sorted in order of severity. Further information on whether the vulnerability has an available fix, for example, can be examined by expanding the sections. For even more details, you can visit dso.docker.com by selecting the link.
If you have any feedback about this feature you can use the **Give feedback** link to contact the development team.
## Pull the latest image from Docker Hub