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

指示是否在 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

用于创建环境的 Docker 生成上下文。 与“base_image”和“base_dockerfile”变量互斥。 默认值为 None。

base_image_registry

包含基础映像的映像注册表。

platform

docker 映像的操作系统和 CPU 体系结构映像。

enabled

指示是否在 Docker 容器中执行此运行。 默认值为 False。 弃用:使用 azureml.core.runconfig.DockerConfiguration 类。

shared_volumes

指示是否使用共享卷。 如果需要解决 Windows 上的共享卷 bug,将设置为 false。 默认值为 True。 弃用:使用 azureml.core.runconfig.DockerConfiguration 类。

gpu_support

已弃用。 Azure 机器学习会自动检测并使用 NVIDIA Docker 扩展(如果可用)。

arguments

要传递给 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 类。