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

execution_script
str
Erforderlich

Pfad zur lokalen Datei mit dem Code zur Ausführung des Images.

runtime
str
Erforderlich

Die für das Image zu verwendende Runtime. Aktuelle unterstützte Runtimes sind „spark-py“ und „python“.

conda_file
str
Standardwert: None

Pfad zur lokalen Datei, die eine für das Image zu verwendende Conda-Umgebungsdefinition enthält.

docker_file
str
Standardwert: None

Pfad zu der lokalen Datei mit zusätzlichen Docker-Schritten, die bei der Einrichtung des Images ausgeführt werden sollen.

schema_file
str
Standardwert: None

Pfad zu der lokalen Datei, die ein Webdienstschema enthält, das bei der Imagebereitstellung verwendet werden soll.

dependencies
list[str]
Standardwert: None

Liste der Pfade zu zusätzlichen Dateien/Ordnern, die vom Image ausgeführt werden müssen.

enable_gpu
bool
Standardwert: None

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“.

tags
dict[(str, str)]
Standardwert: None

Wörterbuch mit Schlüsselwerttags für dieses Image.

properties
dict[(str, str)]
Standardwert: None

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
str
Standardwert: None

Eine Beschreibung, die diesem Image zugeordnet werden soll.

base_image
str
Standardwert: None

Ein benutzerdefiniertes Image, das als Basisimage verwendet werden soll. Wenn kein Basisimage angegeben wird, dann wird das Basisimage basierend auf dem angegebenen Laufzeitparameter verwendet.

base_image_registry
ContainerRegistry
Standardwert: None

Die Imageregistrierung, die das Basisimage enthält.

allow_absolute_path
bool
Standardwert: False

Gibt an, ob absoluter Pfad zulässig ist.

cuda_version
str
Standardwert: None

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.

execution_script
str
Erforderlich

Pfad zur lokalen Datei, die den code enthält, der für das Image ausgeführt werden soll

runtime
str
Erforderlich

Die Runtime, die für das Image verwendet werden soll. Derzeit unterstützte Laufzeiten sind "spark-py" und "python"

conda_file
str
Erforderlich

Pfad zur lokalen Datei, die eine Conda-Umgebungsdefinition enthält, die für das Image verwendet werden soll

docker_file
str
Erforderlich

Pfad zur lokalen Datei mit zusätzlichen Docker-Schritten, die beim Einrichten des Images ausgeführt werden sollen

schema_file
str
Erforderlich

Pfad zu einer lokalen Datei, die ein Webdienstschema enthält, das bei der Bereitstellung des Images verwendet werden soll

dependencies
list[str]
Erforderlich

Liste der Pfade zu zusätzlichen Dateien/Ordnern, die das Image ausführen muss

enable_gpu
bool
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
dict[str, str]
Erforderlich

Wörterbuch der Schlüsselwerttags, um dieses Bild zu erhalten

properties
dict[str, str]
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
str
Erforderlich

Eine Beschreibung für dieses Bild

base_image
str
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
ContainerRegistry
Erforderlich

Imageregistrierung, die das Basisimage enthält.

allow_absolute_path
bool
Erforderlich

Flag zum Zulassen des absoluten Pfads

cuda_version
str
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

workspace
Workspace
Erforderlich

Das Arbeitsbereichsobjekt, in dem das Image erstellt werden soll.

name
str
Erforderlich

Der Name des Bildes.

model_ids
list[str]
Erforderlich

Eine Liste der Modell-IDs, die in das Image gepackt werden sollen.

Gibt zurück

Nutzlast für die Erstellung von Containerimages

Rückgabetyp

Ausnahmen

create_local_debug_payload

Erstellen Sie die Nutzdaten für die Erstellung für das Containerimage.

create_local_debug_payload(workspace, model_ids)

Parameter

workspace
Workspace
Erforderlich

Das Arbeitsbereichsobjekt, in dem das Image erstellt werden soll.

model_ids
list[str]
Erforderlich

Eine Liste der Modell-IDs, die in das Image gepackt werden sollen.

Gibt zurück

Nutzlast für die Erstellung von Containerimages

Rückgabetyp

Ausnahmen

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