DockerSection Class
Defines settings to customize the Docker image built to the environment's specifications.
The DockerSection class is used in the Environment class to customize and control the final resulting Docker image that contains the specified environment.
- Inheritance
-
azureml._base_sdk_common.abstract_run_config_element._AbstractRunConfigElementDockerSection
Constructor
DockerSection(**kwargs)
Remarks
The following example shows how to load docker steps as a string.
from azureml.core import Environment
myenv = Environment(name="myenv")
# Creates the environment inside a Docker container.
myenv.docker.enabled = True
# Specify docker steps as a string.
dockerfile = r'''
FROM mcr.microsoft.com/azureml/intelmpi2018.3-ubuntu16.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
For more information about using Docker in environments, see the article Enable Docker.
Variables
- enabled
- bool
Indicates whether to perform this run inside a Docker container. Default is False.
- base_image
- str
The base image used for Docker-based runs. Mutually exclusive with the "base_dockerfile" variable. Example value: "ubuntu:latest".
- base_dockerfile
- str
The base Dockerfile used for Docker-based runs. Mutually exclusive with "base_image" variable. Example: line 1 "FROM ubuntu:latest" followed by line 2 "RUN echo 'Hello world!'". The default is None.
- shared_volumes
- bool
Indicates whether to use shared volumes. Set to False if necessary to work around shared volume bugs on Windows. The default is True.
- gpu_support
- bool
DEPRECATED. Azure Machine Learning now automatically detects and uses NVIDIA Docker extension when available.
- arguments
- list
Extra arguments to pass to the Docker run command. The default is None.
- base_image_registry
- ContainerRegistry
Image registry that contains the base image.
Attributes
base_dockerfile
Get or set base dockerfile used for Docker-based runs.
base_image
Get or set base image used for Docker-based runs.
gpu_support
DEPRECATED. Azure automatically detects and uses the NVIDIA Docker extension when it is available.