显示镜像的配置信息

摘要

这个命令用于显示指定镜像的详细信息。这些信息包括镜像的ID、标签、摘要、父镜像、创建时间、配置、架构、操作系统类型、大小等。通过指定不同的选项和格式，可以定制输出的内容和格式。 podman image inspect [选项] 镜像 [镜像 ...]

描述

这个命令用于显示通过名称或ID标识的镜像的底层信息。默认情况下，这些信息会以JSON数组的形式呈现。如果指定了格式，则会为每个结果执行给定的模板。

选项

--format, -f=format

模板中可以包含镜像的字段名，以便提取和显示特定的信息。例如，可以使用{{ .Id }}来只显示镜像的ID。使用指定的Go模板格式化输出。返回的JSON的键可以用作--format标志的值（见下面的例子）。

有效的Go模板占位符如下：

ID: 镜像的ID。
RepoTags: 镜像的仓库标签列表。
RepoDigests: 镜像的仓库摘要列表。
Parent: 镜像的父镜像ID。
Comment: 镜像的注释。
Created: 镜像的创建时间。
Container: 创建镜像时使用的容器ID。
ContainerConfig: 创建镜像时使用的容器配置信息。
DockerVersion: 创建镜像时使用的Docker版本。
Author: 镜像的作者信息。
Config: 镜像的配置信息，包括环境变量、工作目录、入口点等。
Architecture: 镜像支持的架构。
Os: 镜像的操作系统类型。
Size: 镜像的大小。
RootFS: 镜像的根文件系统信息。
History: 镜像的构建历史记录。

这些占位符可以在--format标志中使用，以定制输出格式。

占位符	描述
.Annotations ...	镜像中包含的注解信息
.Architecture	镜像中软件的架构
.Author	镜像的作者
.Comment	镜像的注释
.Config ...	包含配置信息的结构体
.Created ...	镜像的创建时间（字符串，ISO3601格式）
.Digest	镜像的摘要（sha256: + 64字符哈希）
.GraphDriver ...	图形驱动信息的结构体
.HealthCheck ...	健康检查信息的结构体
.History	存储在镜像中的历史信息
.ID	镜像的ID（完整的64字符哈希）
.Labels ...	镜像中包含的标签信息
.ManifestType	镜像的清单类型
.NamesHistory	存储在镜像中的名称历史信息
.Os	镜像中软件的操作系统类型
.Parent	指定镜像的父镜像
.RepoDigests	镜像的仓库摘要
.RepoTags	镜像的仓库标签
.RootFS ...	根文件系统信息的结构体
.Size	镜像的大小（以字节为单位）
.User	执行镜像时的默认用户
.Version	镜像的版本
.VirtualSize	镜像的虚拟大小（以字节为单位）

这些占位符可以在podman image inspect命令的--format选项中使用，以定制输出格式。例如，要只显示镜像的ID和大小，可以使用以下命令：

podman image inspect --format '{{.ID}} {{.Size}}' <镜像名或ID>

这将输出指定镜像的ID和大小。可以根据需要组合使用这些占位符，以获取所需的信息。

示例

示例1：以默认JSON格式显示镜像信息

podman image inspect redis:latest

输出可能类似于：

[
  {
    "Id": "sha256:123456789abcdef0123456789abcdef0123456789abcdef0",
    "RepoTags": [
      "redis:latest"
    ],
    "RepoDigests": [
      "redis@sha256:abcdef0123456789abcdef0123456789abcdef0123456789"
    ],
    "Parent": "",
    "Comment": "",
    "Created": "2023-04-01T00:00:00Z",
    "Container": "",
    "ContainerConfig": {
      "Image": "redis:base"
    },
    "DockerVersion": "podman-version",
    "Author": "",
    "Config": {
      "Env": [
        "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
        "REDIS_VERSION=latest",
        "REDIS_DOWNLOAD_URL=http://example.com/redis/redis-latest.tar.gz",
        "REDIS_DOWNLOAD_SHA=abcdef0123456789abcdef0123456789abcdef01"
      ],
      "WorkingDir": "/data",
      "Entrypoint": [
        "docker-entrypoint.sh"
      ],
      "Cmd": [
        "redis-server"
      ],
      ...
    },
    "Architecture": "amd64",
    "Os": "linux",
    "Size": 123456789,
    "RootFS": {
      "Type": "layers",
      "Layers": [
        "sha256:abcdef0123456789abcdef0123456789abcdef0123456789",
        "sha256:123456789abcdef0123456789abcdef0123456789abcdef0"
      ]
    },
    "History": [
      {
        "Created": "2023-04-01T00:00:00Z",
        "CreatedBy": "/bin/sh -c #(nop)  ADD file:abcdef0123456789abcdef0123456789abcdef0123456789 in /"
      },
      ...
    ]
  }
]

示例2：以自定义格式显示镜像信息

podman image inspect fedora
[
    {
        "Id": "37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d",
        "Digest": "sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
        "RepoTags": [
            "registry.fedoraproject.org/fedora:latest"
        ],
        "RepoDigests": [
            "registry.fedoraproject.org/fedora@sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
            "registry.fedoraproject.org/fedora@sha256:b5290db40008aae9272ad3a6bd8070ef7ecd547c3bef014b894c327960acc582"
        ],
        "Parent": "",
        "Comment": "Created by Image Factory",
        "Created": "2021-08-09T05:48:47Z",
        "Config": {
            "Env": [
                "DISTTAG=f34container",
                "FGC=f34",
                "container=oci"
            ],
            "Cmd": [
                "/bin/bash"
            ],
            "Labels": {
                "license": "MIT",
                "name": "fedora",
                "vendor": "Fedora Project",
                "version": "34"
            }
        },
        "Version": "1.10.1",
        "Author": "",
        "Architecture": "amd64",
        "Os": "linux",
        "Size": 183852302,
        "VirtualSize": 183852302,
        "GraphDriver": {
            "Name": "overlay",
            "Data": {
                "UpperDir": "/home/dwalsh/.local/share/containers/storage/overlay/0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2/diff",
                "WorkDir": "/home/dwalsh/.local/share/containers/storage/overlay/0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2/work"
            }
        },
        "RootFS": {
            "Type": "layers",
            "Layers": [
                "sha256:0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2"
            ]
        },
        "Labels": {
            "license": "MIT",
            "name": "fedora",
            "vendor": "Fedora Project",
            "version": "34"
        },
        "Annotations": {},
        "ManifestType": "application/vnd.docker.distribution.manifest.v2+json",
        "User": "",
        "History": [
            {
                "created": "2021-08-09T05:48:47Z",
                "comment": "Created by Image Factory"
            }
        ],
        "NamesHistory": [
            "registry.fedoraproject.org/fedora:latest"
        ]
    }
]

示例1：显示镜像的ID

podman image inspect --format '{{ .Id }}' fedora

输出可能是：

sha256:37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d

这个命令只显示了名为fedora的镜像的ID。

示例2：显示镜像的完整信息（默认格式）

podman image inspect fedora

输出将是关于fedora镜像的完整JSON格式的信息，包括ID、标签、父镜像、创建时间、配置等。

示例3：显示镜像的创建时间和大小

podman image inspect --format '{{ .Created }} {{ .Size }}' fedora

输出可能是：

2023-04-01T00:00:00Z 123456789

这个命令显示了fedora镜像的创建时间和大小。

另请参阅

podman(1), podman-image(1), podman-images(1)

历史

2021年9月，由Dan Walsh整理编译。随着Podman的不断发展，该命令的功能和选项可能有所更新和扩展。建议查阅最新的Podman文档以获取最准确的信息。

摘要​

描述​

选项​

--format, -f=format​

示例​

示例1：以默认JSON格式显示镜像信息​

示例2：以自定义格式显示镜像信息​

示例1：显示镜像的ID​

示例2：显示镜像的完整信息（默认格式）​

示例3：显示镜像的创建时间和大小​

另请参阅​

历史​

摘要

描述

选项