ContainerImageConfig Klasse
Definiert Imagekonfigurationseinstellungen speziell für Containerbereitstellungen – erfordert Ausführungsskript und Runtime.
In typischen Anwendungsfällen verwenden Sie die Methode image_configuration
der Klasse ContainerImage, um ein ContainerImageConfig-Objekt zu erstellen.
Initialisieren Sie das Config-Objekt.
- Vererbung
-
ContainerImageConfig
Konstruktor
ContainerImageConfig(execution_script, runtime, conda_file=None, docker_file=None, schema_file=None, dependencies=None, enable_gpu=None, tags=None, properties=None, description=None, base_image=None, base_image_registry=None, allow_absolute_path=False, cuda_version=None)
Parameter
Name | Beschreibung |
---|---|
execution_script
Erforderlich
|
Pfad zur lokalen Datei mit dem Code zur Ausführung des Images. |
runtime
Erforderlich
|
Die für das Image zu verwendende Runtime. Aktuelle unterstützte Runtimes sind „spark-py“ und „python“. |
conda_file
|
Pfad zur lokalen Datei, die eine für das Image zu verwendende Conda-Umgebungsdefinition enthält. Standardwert: None
|
docker_file
|
Pfad zu der lokalen Datei mit zusätzlichen Docker-Schritten, die bei der Einrichtung des Images ausgeführt werden sollen. Standardwert: None
|
schema_file
|
Pfad zu der lokalen Datei, die ein Webdienstschema enthält, das bei der Imagebereitstellung verwendet werden soll. Standardwert: None
|
dependencies
|
Liste der Pfade zu zusätzlichen Dateien/Ordnern, die vom Image ausgeführt werden müssen. Standardwert: None
|
enable_gpu
|
Gibt an, ob die GPU-Unterstützung im Image aktiviert werden soll. Das GPU-Image muss in Microsoft Azure-Diensten wie Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines und Azure Kubernetes Service verwendet werden. Der Standardwert lautet „False“. Standardwert: None
|
tags
|
Wörterbuch mit Schlüsselwerttags für dieses Image. Standardwert: None
|
properties
|
Wörterbuch mit Schlüsselwerteigenschaften für dieses Image. Diese Eigenschaften können nach der Bereitstellung nicht mehr geändert werden. Es können jedoch neue Schlüssel-Wert-Paare hinzugefügt werden. Standardwert: None
|
description
|
Eine Beschreibung, die diesem Image zugeordnet werden soll. Standardwert: None
|
base_image
|
Ein benutzerdefiniertes Image, das als Basisimage verwendet werden soll. Wenn kein Basisimage angegeben wird, dann wird das Basisimage basierend auf dem angegebenen Laufzeitparameter verwendet. Standardwert: None
|
base_image_registry
|
Die Imageregistrierung, die das Basisimage enthält. Standardwert: None
|
allow_absolute_path
|
Gibt an, ob absoluter Pfad zulässig ist. Standardwert: False
|
cuda_version
|
Die CUDA-Version, die für Images installiert wird, die GPU-Unterstützung benötigen. Das GPU-Image muss in Microsoft Azure-Diensten wie Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines und Azure Kubernetes Service verwendet werden. Unterstützt werden die Versionen 9.0, 9.1 und 10.0. Wenn „enable_gpu“ festgelegt ist, wird standardmäßig „9.1“ verwendet. Standardwert: None
|
execution_script
Erforderlich
|
Pfad zur lokalen Datei, die den code enthält, der für das Image ausgeführt werden soll |
runtime
Erforderlich
|
Die Runtime, die für das Image verwendet werden soll. Derzeit unterstützte Laufzeiten sind "spark-py" und "python" |
conda_file
Erforderlich
|
Pfad zur lokalen Datei, die eine Conda-Umgebungsdefinition enthält, die für das Image verwendet werden soll |
docker_file
Erforderlich
|
Pfad zur lokalen Datei mit zusätzlichen Docker-Schritten, die beim Einrichten des Images ausgeführt werden sollen |
schema_file
Erforderlich
|
Pfad zu einer lokalen Datei, die ein Webdienstschema enthält, das bei der Bereitstellung des Images verwendet werden soll |
dependencies
Erforderlich
|
Liste der Pfade zu zusätzlichen Dateien/Ordnern, die das Image ausführen muss |
enable_gpu
Erforderlich
|
Gibt an, ob die GPU-Unterstützung im Image aktiviert werden soll. Das GPU-Image muss in Microsoft Azure-Diensten wie Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines und Azure Kubernetes Service verwendet werden. Der Standardwert ist „false“. |
tags
Erforderlich
|
Wörterbuch der Schlüsselwerttags, um dieses Bild zu erhalten |
properties
Erforderlich
|
Wörterbuch mit Schlüsselwerteigenschaften für dieses Image. Diese Eigenschaften können nach der Bereitstellung nicht mehr geändert werden. Es können jedoch neue Schlüssel-Wert-Paare hinzugefügt werden |
description
Erforderlich
|
Eine Beschreibung für dieses Bild |
base_image
Erforderlich
|
Ein benutzerdefiniertes Image, das als Basisimage verwendet werden soll. Wenn kein Basisimage angegeben wird, wird das Basisimage basierend auf dem angegebenen Runtimeparameter verwendet. |
base_image_registry
Erforderlich
|
Imageregistrierung, die das Basisimage enthält. |
allow_absolute_path
Erforderlich
|
Flag zum Zulassen des absoluten Pfads |
cuda_version
Erforderlich
|
CUDA-Version, die für Images installiert wird, die GPU-Unterstützung benötigen. Das GPU-Image muss in Microsoft Azure-Diensten wie Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines und Azure Kubernetes Service verwendet werden. Unterstützt werden die Versionen 9.0, 9.1 und 10.0. Wenn „enable_gpu“ festgelegt ist, wird standardmäßig „9.1“ verwendet. |
Methoden
build_create_payload |
Erstellen Sie die Nutzdaten für die Erstellung für das Containerimage. |
create_local_debug_payload |
Erstellen Sie die Nutzdaten für die Erstellung für das Containerimage. |
validate_configuration |
Überprüft, ob die angegebenen Konfigurationswerte gültig sind. Löst eine :class:azureml.exceptions.WebserviceException aus, wenn die Validierung fehlschlägt. |
build_create_payload
Erstellen Sie die Nutzdaten für die Erstellung für das Containerimage.
build_create_payload(workspace, name, model_ids)
Parameter
Name | Beschreibung |
---|---|
workspace
Erforderlich
|
Das Arbeitsbereichsobjekt, in dem das Image erstellt werden soll. |
name
Erforderlich
|
Der Name des Bildes. |
model_ids
Erforderlich
|
Eine Liste der Modell-IDs, die in das Image gepackt werden sollen. |
Gibt zurück
Typ | Beschreibung |
---|---|
Nutzlast für die Erstellung von Containerimages |
Ausnahmen
Typ | Beschreibung |
---|---|
create_local_debug_payload
Erstellen Sie die Nutzdaten für die Erstellung für das Containerimage.
create_local_debug_payload(workspace, model_ids)
Parameter
Name | Beschreibung |
---|---|
workspace
Erforderlich
|
Das Arbeitsbereichsobjekt, in dem das Image erstellt werden soll. |
model_ids
Erforderlich
|
Eine Liste der Modell-IDs, die in das Image gepackt werden sollen. |
Gibt zurück
Typ | Beschreibung |
---|---|
Nutzlast für die Erstellung von Containerimages |
Ausnahmen
Typ | Beschreibung |
---|---|
validate_configuration
Überprüft, ob die angegebenen Konfigurationswerte gültig sind.
Löst eine :class:azureml.exceptions.WebserviceException aus, wenn die Validierung fehlschlägt.
validate_configuration()
Ausnahmen
Typ | Beschreibung |
---|---|