图像
显示有关 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
- 将使用容器映像的暂挂作业任务数。 此数字包括PENDING和PSUSPEND状态,但不包含作业FWD_PEND或任何其他状态。
- HOST_NAME
- LSF 主机的名称。
- NJOBS
- 正在使用容器映像的正在运行的作业任务数。 此数字包括RUNNING,USUSPEND和SSUSPEND状态。
- NCTNRS
- 正在主机上使用容器映像的正在运行的容器实例数。 此数目包括由其他应用程序启动的容器实例。
定制输出 (-o)
除了为缺省输出显示的字段外, -o 选项还可以显示下列指定的字段:
- REPO
- 容器映像存储库的名称。
- 标记
- 容器映像标记的名称。
- 最后使用
- 上次由 LSF 作业使用容器映像的时间。 如果正在运行的作业正在使用容器映像,那么值为当前时间,否则,这是作业结束的时间。 连字符 (-) 指示从未使用过容器映像。
- 总工作量
- 在所有主机上使用容器映像的正在运行的作业任务总数。 此数字是具有相同容器映像的所有 LSF 主机上所有 NJOBS 值的总和。
- 时间 (PULLED_TIME)
- 上次拉取容器映像的时间。
- 图像ID
- 容器映像标识,采用表格式。 这将显示容器映像标识的前 12 位,这与 docker images 命令的输出格式相同。 以 JSON 格式显示时,将显示完整图像标识。