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
|
用于基于 Docker 的运行的基本映像。 与“base_dockerfile”和“build_context”变量互斥。 示例值:“ubuntu:latest”。 |
base_dockerfile
|
用于基于 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 类。