DockerSection 类

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

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

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

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

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 类。