图像

显示有关 Docker 容器映像的信息

概要

bimages [-m host_name ... | -m host_group ...] [-o "field_name ..." [-json]] [image-reponame[:image-tagname]]
bimages [-m 主机名... | -m 主机组...] [-o "字段名..." ] [-noheader] [ 图像存储库名称 [:图像标签名称 ]]
bimages [-h | -V]

描述

缺省情况下,返回有关所有 LSF调用的 Docker 容器映像的以下信息: 容器映像名称,映像文件大小,将使用该容器映像的暂挂作业任务数, LSF 主机名,正在运行的作业任务数以及正在使用该容器映像的容器实例数。

对于容器作业,暂挂和正在运行的作业任务不会计入UNKNOWN状态。

在此命令中,作业数组被视为多作业元素。

要点: 要使 LIM 能够收集 Docker 映像信息,必须在 lsf.shared 文件中将 docker 指定为布尔资源。

选项

-json
以 JSON 格式显示定制输出。

指定时, bimages -o 将以 JSON 格式显示定制输出。

此选项仅适用于定制输出的 bimages -o 命令的输出。 在不使用 -o 选项的情况下运行 bimages 时,此操作无效。

-m host_name...| -m host_group ...
显示有关 LSF 在指定主机上调用的容器的信息。 如果指定了主机组,那么 bimages 将显示由 LSF 在主机组中的每个主机上调用的容器。

如果未指定 -m ,那么 bimages 将显示 LSF 在集群中的每个主机上调用的容器。

-无标题
从输出中除去列标题。

指定时, bimages 将显示字段的值,而不显示字段的名称。 当不需要列标题时,这对于脚本解析很有用。

此选项不能与 -json 选项一起使用。

-o " 字段名..."
设置定制输出格式。 指定要显示的 bimages 字段和顺序。

以下是用于指定要显示的 bimages 字段的字段名称以及所显示字段的计量单位:

表 1. bimages 的输出字段
字段名称 单位
REPO  
标记  
图像名称  
大小 MB
DEMAND  
HOST_NAME  
NJOBS  
NCTNRS  
最后使用 时间戳记
总工作量  
时间 (PULLED_TIME) 时间戳记
图像ID  

字段名称以空格分隔且区分大小写。

例如,

bimages -o "IMAGE_NAME SIZE HOST_NAME"

图片存储库名称 [: 图片标签名称 ]
显示有关指定容器映像的信息。 如果没有指定的映像标记,那么 bimages image-reponame 将显示最新的容器映像。

如果未指定此参数,那么 bimages 将显示所有容器映像。

-h
将命令用法打印到 stderr 并退出。
-V
LSF 发行版打印到 stderr 并退出。

缺省输出

显示以下字段:

图像名称
容器映像的名称。 这是容器映像存储库和标记名称的组合。
大小
容器映像文件的大小。
DEMAND
将使用容器映像的暂挂作业任务数。 此数字包括PENDINGPSUSPEND状态,但不包含作业FWD_PEND或任何其他状态。
HOST_NAME
LSF 主机的名称。
NJOBS
正在使用容器映像的正在运行的作业任务数。 此数字包括RUNNING,USUSPENDSSUSPEND状态。
NCTNRS
正在主机上使用容器映像的正在运行的容器实例数。 此数目包括由其他应用程序启动的容器实例。

定制输出 (-o)

除了为缺省输出显示的字段外, -o 选项还可以显示下列指定的字段:
REPO
容器映像存储库的名称。
标记
容器映像标记的名称。
最后使用
上次由 LSF 作业使用容器映像的时间。 如果正在运行的作业正在使用容器映像,那么值为当前时间,否则,这是作业结束的时间。 连字符 (-) 指示从未使用过容器映像。
总工作量
在所有主机上使用容器映像的正在运行的作业任务总数。 此数字是具有相同容器映像的所有 LSF 主机上所有 NJOBS 值的总和。
时间 (PULLED_TIME)
上次拉取容器映像的时间。
图像ID
容器映像标识,采用表格式。 这将显示容器映像标识的前 12 位,这与 docker images 命令的输出格式相同。 以 JSON 格式显示时,将显示完整图像标识。

另请参阅