Docker库

库版本：   1.0

库范围：      Docker

介绍

提供用于处理 docker 的关键字的库。

DockerLibrary 是 Robot Framework 的库，它提供了一组用于处理 docker 的关键字。这个库支持所有 Docker CLI(docker) 命令和选项来使用 docker。此外，它还提供处理多个容器以及称为“docker in docker”的现象。最后一个额外的特性是 DotDictionary 类，它可以更轻松地处理基本 Docker CLI 命令的输出。

目录

• 码头工人 CLI(码头工人)
• 多个 Docker 容器
• 码头工人中的码头工人
• DotDictionary 和解析命令

码头工人 CLI(码头工人)

基本的docker（基本命令）采用以下形式：

docker | <base command> | [OPTIONS]

例子：

docker  run  --name  test  -dt  ubuntu

多个 Docker 容器

一次处理多个容器的关键字。

创建多个容器

使用一个命令创建多个容器的关键字。

返回： List[str]，其中字符串是创建的容器 ID

create multiple containers | <number of containers> | <name of image>

例子：

create multiple containers  3  ubuntu

所有容器的 Docker 命令

一次为多个容器执行基本 Docker CLI 命令的关键字。

回报：

• 如果参数 <parse to dotd> 为真：Dict[str, DotDictionary]，其中键是容器 ID，值是命令执行转换为 DotDictionary 的输出
• 如果参数 <parse to dotd> 为 false：Dict[str, str]，其中键是容器 ID，值是命令执行的字符串输出

docker command for all | <containers ids> | <parse to dotd> | <base command> | [OPTIONS]

例子：

${containers_id} =  docker  ps  -a  -q
docker command for all  ${containers_id.stdout}  False  rm  -f

码头工人中的码头工人

在 docker 中处理 docker 的关键字。

码头工人

使用默认的 Unix 套接字在 docker 中运行主机 docker /var/run/docker.sock，然后创建给定图像的多个容器

docker host 中有 docker 的三个选项：

• Ubuntu
• 高山
• 森托斯

返回： Dict[str, List[str]]，其中 key 是主机容器 id，value 是创建的容器 id 列表

docker in docker | alpine/ubuntu/centos | <custom image> | <number of containers to create>

例子：

docker in docker  alpine  ubuntu  5

解析命令

有助于解析 docker 输出的关键字。

解析 docker 响应

如果参数 <parse to dotd> 设置为 True，它将尝试解析提供给 DotDictionary 的输出，如果失败则返回字符串。如果参数 <parse to dotd> 设置为 False。它将从给定的字符串中删除所有空白字符并返回该字符串。

返回： DotDictionary 或 List[DotDictionary] 或字符串

DotDictionary 是一个用于更轻松地处理 docker 命令输出的类。

使用 DotDictionary 的示例：

${containers_id} =  docker  ps  -a  -q
${dictionary} =  docker command for all  ${containers_id.stdout}  True  inspect
${values} =  Get Dictionary Values  ${dictionary}
Log  ${values[0].Config.Entrypoint}

返回： DotDictionary 或 List[DotDictionary] 或字符串

parse docker response | <response> | <parse to dotd>

例子：

${parsed_to_dotd_output} =  parse docker response  ${result.stdout}  True

获取容器 ID

获取容器 ID 的关键字。

返回： List[str]，其中字符串是容器 ID

get containers ids

例子：

${containers_ids} =  get containers ids