Partager via

DockerSection Classe

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 Environment classe pour personnaliser et contrôler l’image Docker finale résultante qui contient l’environnement spécifié.

Constructeur DockerSection de classe.

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 à l’intérieur d’un conteneur Docker. La valeur par défaut est False. DÉCONSEILLÉ : Utilisez la classe azureml.core.runconfig.DockerConfiguration.
base_image
str

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

Fichier Dockerfile de base utilisé pour les exécutions basées sur Docker. Mutuellement exclusif avec les variables « base_image » et « build_context ». Exemple : ligne 1 « FROM ubuntu :latest » suivie de la ligne 2 « RUN echo 'Hello world !' ». La valeur par défaut est None.
build_context
DockerBuildContext

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

Registre d’images qui contient l’image de base.
platform
DockerImagePlatform

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

Indique s’il faut exécuter cette exécution à l’intérieur d’un conteneur Docker. La valeur par défaut est False. DÉCONSEILLÉ : Utilisez la classe azureml.core.runconfig.DockerConfiguration.
shared_volumes
bool

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

OBSOLESCENT. Azure Machine Learning détecte et utilise désormais automatiquement l’extension Docker NVIDIA lorsqu’elle est disponible.
arguments
list

Arguments supplémentaires à passer à la commande Docker run. La valeur par défaut est None. DÉCONSEILLÉ : Utilisez la classe azureml.core.runconfig.DockerConfiguration.

Attributs

arguments

OBSOLESCENT. Utilisez la classe azureml.core.runconfig.DockerConfiguration.

base_dockerfile

Obtenez ou définissez le fichier dockerfile de base utilisé pour les exécutions basées sur Docker.

base_image

Obtenir ou définir 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 docker.

enabled

OBSOLESCENT. Utilisez la classe azureml.core.runconfig.DockerConfiguration.

gpu_support

OBSOLESCENT. Azure détecte et utilise automatiquement l’extension NVIDIA Docker lorsqu’elle est disponible.

shared_volumes

OBSOLESCENT. Utilisez la classe azureml.core.runconfig.DockerConfiguration.

shm_size

OBSOLESCENT. Utilisez la classe azureml.core.runconfig.DockerConfiguration.