images_build

镜像构建支持的 Mixin。

class BuildMixin

基类: object

为 ImagesManager 提供构建方法的类。

build(**kwargs) → Tuple[Image, Iterator[bytes]]

返回构建的镜像。

关键字参数：

• path (str) –

• Dockerfile. (fileobj – 用作的 文件对象) –

• tag (str) –

• quiet (bool) –

• nocache (bool) –

• rm (bool) –

• timeout (int) –

• custom_context (bool) – 使用 fileobj 时可选 (忽略) –

• encoding (str) – 流的编码。设置为 gzip 以压缩 (忽略) –

• pull (bool) –

• forcerm (bool) –

• dockerfile (str) –

• buildargs (Mapping[str,str) –

• container_limits (Dict[str, Union[int,str]]) –

  应用于构建过程中创建的每个容器的限制字典。

  有效键

  • memory (int): 设置构建的内存限制

  • memswap (int): 总内存 (内存 + 交换空间)，-1 禁用交换空间

  • cpushares (int): CPU 份额（相对权重）

  • cpusetcpus (str): 允许执行的 CPU，例如，“0-3”，“0,1”

  • cpuperiod (int): CPU CFS（完全公平调度程序）周期（仅限 Podman）

  • cpuquota (int): CPU CFS（完全公平调度程序）配额（仅限 Podman）

• shmsize (int) – 如果省略，系统使用 64MB

• labels (Mapping[str,str]) –

• cache_from (List[str]) –

• target (str) –

• network_mode (str) –

• squash (bool) –

• extra_hosts (Dict[str,str]) – 容器，作为主机名到 IP 地址的映射。

• platform (str) –

• isolation (str) – 构建期间使用的隔离技术。 (忽略) –

• use_config_proxy (bool) – (忽略) –

• http_proxy (bool) - 将 http 代理环境变量注入容器 (仅限 Podman) –

• layers (bool) –

• output (str) –

• outputformat (str) –

返回值：

第一个项目是构建的 podman.domain.images.Image

第二个项目是构建日志

引发异常：

• BuildError – 构建过程中发生错误时

• APIError – 服务返回错误时

• TypeError – 未指定路径或 fileobj 时