DockerSection Classe

  • Référence

Définit des paramètres permettant de personnaliser l’image Docker construite pour les spécifications de l’environnement.

La classe DockerSection est utilisée dans la classe Environment pour personnaliser et contrôler l’image Docker finale qui contient l’environnement spécifié.

Constructeur DockerSection de classe.

Héritage
azureml._base_sdk_common.abstract_run_config_element._AbstractRunConfigElement
DockerSection

Constructeur

DockerSection(**kwargs)

Remarques

L’exemple suivant montre comment charger les étapes Docker en tant que chaîne.


   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

Pour plus d’informations sur l’utilisation de Docker dans les environnements, consultez l’article Activer Docker.

Variables

Nom Description
enabled
bool

Indique s’il faut exécuter cette exécution dans un conteneur Docker. La valeur par défaut est FALSE. DÉPRÉCIÉ : utilise la classe azureml.core.runconfig.DockerConfiguration.
base_image
str

Image de base utilisée pour les exécutions basées sur Docker. S’excluent mutuellement avec les variables « base_dockerfile » et « build_context ». Exemple de valeur : « ubuntu:latest ».
base_dockerfile
str

Dockerfile de base utilisé pour les exécutions basées sur Docker. S’excluent mutuellement avec les variables « base_image » et « build_context ». Exemple : ligne 1 « FROM ubuntu:latest », suivi de la ligne 2, « RUN echo 'Hello world!' ». La valeur par défaut est Aucun.
build_context
DockerBuildContext

Contexte de build Docker à utiliser pour créer l’environnement. S’excluent mutuellement avec les variables « base_image » et « base_dockerfile ». La valeur par défaut est Aucun.
base_image_registry
ContainerRegistry

Registre d’images contenant l’image de base.
platform
DockerImagePlatform

Architecture du système d’exploitation et de l’UC de l’image Docker.
enabled

Indique s’il faut exécuter cette exécution dans un conteneur Docker. La valeur par défaut est FALSE. DÉPRÉCIÉ : utilise la classe azureml.core.runconfig.DockerConfiguration.
shared_volumes
bool

Indique s’il faut utiliser des volumes partagés. Affectez la valeur false si nécessaire pour contourner les bogues de volume partagé sur Windows. La valeur par défaut est True. DÉPRÉCIÉ : utilise la classe azureml.core.runconfig.DockerConfiguration.
gpu_support
bool

DÉPRÉCIÉ. Désormais, Azure Machine Learning détecte automatiquement et utilise l’extension Docker NVIDIA quand elle est disponible.
arguments
list

Arguments supplémentaires à transmettre à la commande run de Docker. La valeur par défaut est Aucun. DÉPRÉCIÉ : utilise la classe azureml.core.runconfig.DockerConfiguration.

Attributs

arguments

DÉPRÉCIÉ. Utilise la classe azureml.core.runconfig.DockerConfiguration.

base_dockerfile

Obtient ou définit le dockerfile de base utilisé pour les exécutions basées sur Docker.

base_image

Obtient ou définit l’image de base utilisée pour les exécutions basées sur Docker.

build_context

Obtenez ou définissez le contexte de build Docker utilisé pour les exécutions basées sur Docker.

enabled

DÉPRÉCIÉ. Utilise la classe azureml.core.runconfig.DockerConfiguration.

gpu_support

DÉPRÉCIÉ. Azure détecte et utilise automatiquement l’extension Docker NVIDIA lorsqu’elle est disponible.

shared_volumes

DÉPRÉCIÉ. Utilise la classe azureml.core.runconfig.DockerConfiguration.

shm_size

DÉPRÉCIÉ. Utilise la classe azureml.core.runconfig.DockerConfiguration.