DockerSection 类

定义根据环境规范对生成的 Docker 映像进行自定义时使用的设置。

DockerSection 类在 Environment 类中用于自定义和控制最终生成的包含指定环境的 Docker 映像。

类 DockerSection 构造函数。

继承

azureml._base_sdk_common.abstract_run_config_element._AbstractRunConfigElement

DockerSection

构造函数

DockerSection(**kwargs)

注解

以下示例演示如何将 docker 步骤作为字符串加载。

   from azureml.core import Environment
   myenv = Environment(name="myenv")
   # Specify docker steps as a string.
   dockerfile = r'''
   FROM mcr.microsoft.com/azureml/openmpi4.1.0-ubuntu20.04
   RUN echo "Hello from custom container!"
   '''

   # Alternatively, load from a file.
   #with open("dockerfiles/Dockerfile", "r") as f:
   #    dockerfile=f.read()

   myenv.docker.base_dockerfile = dockerfile

有关在环境中使用 Docker 的信息，请参阅启用 Docker 一文。

变量

名称	说明
enabled	bool 指示是否在 Docker 容器中执行此运行。 默认值为 False。 弃用：使用 azureml.core.runconfig.DockerConfiguration 类。
base_image	str 用于基于 Docker 的运行的基本图像。 与“base_dockerfile”和“build_context”变量互斥。 示例值：“ubuntu:latest”。
base_dockerfile	str 用于基于 Docker 的运行的基本 Dockerfile。 与“base_image”和“build_context”变量互斥。 示例：第 1 行“FROM ubuntu:latest”，后跟第 2 行“RUN echo 'Hello world！'”。 默认值为 None。
build_context	DockerBuildContext 用于创建环境的 Docker 生成上下文。 与“base_image”和“base_dockerfile”变量互斥。 默认值为 None。
base_image_registry	ContainerRegistry 包含基础映像的映像注册表。
platform	DockerImagePlatform docker 映像的操作系统和 CPU 体系结构映像。
enabled	指示是否在 Docker 容器中执行此运行。 默认值为 False。 弃用：使用 azureml.core.runconfig.DockerConfiguration 类。
shared_volumes	bool 指示是否使用共享卷。 如果需要解决 Windows 上的共享卷 bug，将设置为 false。 默认值为 True。 弃用：使用 azureml.core.runconfig.DockerConfiguration 类。
gpu_support	bool 已弃用。 Azure 机器学习会自动检测并使用 NVIDIA Docker 扩展（如果可用）。
arguments	list 要传递给 Docker run 命令的额外参数。 默认值为 None。 弃用：使用 azureml.core.runconfig.DockerConfiguration 类。

属性

arguments

已弃用。 使用 azureml.core.runconfig.DockerConfiguration 类。

base_dockerfile

获取或设置用于基于 Docker 的运行的基本 dockerfile。

base_image

获取或设置用于基于 Docker 的运行的基本图像。

build_context

获取或设置用于基于 Docker 的运行的 Docker 生成上下文。

enabled

已弃用。 使用 azureml.core.runconfig.DockerConfiguration 类。

gpu_support

已弃用。 Azure 会自动检测并使用 NVIDIA Docker 扩展（如果可用）。

shared_volumes

已弃用。 使用 azureml.core.runconfig.DockerConfiguration 类。

shm_size

已弃用。 使用 azureml.core.runconfig.DockerConfiguration 类。