Environment Klasse

Konfiguriert eine reproduzierbare Python-Umgebung für Experimente zum maschinellen Lernen.

Eine Umgebung definiert Python-Pakete, Umgebungsvariablen und Docker-Einstellungen, die in ML-Experimenten verwendet werden, einschließlich der Datenvorbereitung, des Trainings und der Bereitstellung in einem Webdienst. Eine Umgebung wird in einem Azure Machine Learning-Workspace verwaltet und versioniert. Sie können eine vorhandene Umgebung aktualisieren und eine Version zur Wiederverwendung abrufen. Umgebungen gelten ausschließlich für den Arbeitsbereich, in dem sie erstellt werden, und können nicht in verschiedenen Arbeitsbereichen verwendet werden.

Weitere Informationen zu Umgebungen finden Sie unter Erstellen und Verwalten wiederverwendbarer Umgebungen.

Klassenumgebungskonstruktor.

Vererbung
azureml._base_sdk_common.abstract_run_config_element._AbstractRunConfigElement
Environment

Konstruktor

Environment(name, **kwargs)

Parameter

name
string
Erforderlich

Der Name der Umgebung.

Hinweis

Beginnen Sie Ihren Umgebungsnamen nicht mit „Microsoft“ oder „AzureML“. Die Präfixe „Microsoft“ und „AzureML“ sind für zusammengestellte Umgebungen reserviert. Weitere Informationen zu zusammengestellten Umgebungen finden Sie unter Erstellen und Verwalten wiederverwendbarer Umgebungen.

Hinweise

Azure Machine Learning stellt zusammengestellte Umgebungen bereit. Dabei handelt es sich um vordefinierte Umgebungen, die gute Ausgangspunkte für die Entwicklung eigener Umgebungen darstellen. Zusammengestellte Umgebungen basieren auf zwischengespeicherten Docker-Image und senken damit den Aufwand für die Vorbereitung der Ausführung. Weitere Informationen zu zusammengestellten Umgebungen finden Sie unter Erstellen und Verwalten wiederverwendbarer Umgebungen.

Es gibt verschiedene Möglichkeiten, wie Umgebungen in Azure Machine Learning erstellt werden können, z. B.:

Im folgenden Beispiel wird die Instanziierung einer neuen Umgebung veranschaulicht.


   from azureml.core import Environment
   myenv = Environment(name="myenv")

Sie können eine Umgebung verwalten, indem Sie sie registrieren. Auf diese Weise können Sie die Versionen der Umgebung nachverfolgen und in zukünftigen Ausführungen wiederverwenden.


   myenv.register(workspace=ws)

Weitere Beispiele zum Arbeiten mit Umgebungen finden Sie im Jupyter Notebook zum Verwenden von Umgebungen.

Variablen

Environment.databricks

In diesem Abschnitt werden Abhängigkeiten der Bibliothek azureml.core.databricks.DatabricksSection konfiguriert.

docker
DockerSection

In diesem Abschnitt werden Einstellungen im Zusammenhang mit dem endgültigen Docker-Image konfiguriert, das den Spezifikationen der Umgebung entspricht. Außerdem wird hier angegeben, ob zum Erstellen der Umgebung Docker-Container verwendet werden sollen.

inferencing_stack_version
string

Dieser Abschnitt gibt die dem Image hinzugefügte Version des Rückschlussstapels an. Um das Hinzufügen eines Rückschlussstapels zu vermeiden, legen Sie diesen Wert nicht fest. Gültiger Wert: „latest“ (Aktuellste).

python
PythonSection

In diesem Abschnitt wird angegeben, welche Python-Umgebung und welcher Interpreter am Computeziel verwendet werden sollen.

spark
SparkSection

Der Abschnitt konfiguriert die Spark-Einstellungen. Er wird nur verwendet, wenn das Framework auf PySpark festgelegt ist.

r
RSection

In diesem Abschnitt wird angegeben, welche R-Umgebung am Computeziel verwendet werden soll.

version
string

Die Version der Umgebung.

asset_id
string

Asset-ID Wird aufgefüllt, wenn eine Umgebung registriert wird.

Methoden

add_private_pip_wheel

Lädt die private pip wheel-Datei auf den Datenträger in Azure Blob Storage hoch, der an den Arbeitsbereich angefügt ist.

Löst eine Ausnahme aus, wenn bereits ein privates pip wheel-Archiv mit dem gleichen Namen im Speicherblob des Arbeitsbereichs vorhanden ist.

build

Erstellt ein Docker-Image für diese Umgebung in der Cloud.

build_local

Erstellt lokal die Docker- oder conda-Umgebung.

clone

Klont das environment-Objekt.

Gibt eine neue Instanz des environment-Objekts mit einem neuen Namen zurück.

from_conda_specification

Erstellt ein environment-Objekt aus einer YAML-Datei mit der Umgebungsspezifikation.

Informationen zum Abrufen einer YAML-Datei mit einer Umgebungsspezifikation finden Sie unter Verwalten von Umgebungen im conda-Benutzerhandbuch.

from_docker_build_context

Erstellen Sie ein Umgebungsobjekt aus einem Docker-Buildkontext.

from_docker_image

Erstellen Sie ein Umgebungsobjekt aus einem Docker-Basisimage mit optionalen Python-Abhängigkeiten.

Die Python-Ebene wird der Umgebung hinzugefügt, wenn conda_specification oder pip_requirements angegeben ist. conda_specification und pip_requirements schließen sich gegenseitig aus.

from_dockerfile

Erstellen Sie ein Umgebungsobjekt aus einer Dockerfile-Datei mit optionalen Python-Abhängigkeiten.

Die Python-Ebene wird der Umgebung hinzugefügt, wenn conda_specification oder pip_requirements angegeben ist. conda_specification und pip_requirements schließen sich gegenseitig aus.

from_existing_conda_environment

Erstellt ein environment-Objekt aus einer lokal vorhandenen conda-Umgebung.

Führen Sie conda env list aus, um eine Liste der vorhandenen conda-Umgebungen abzurufen. Weitere Informationen finden Sie unter Verwalten von Umgebungen im conda-Benutzerhandbuch.

from_pip_requirements

Erstellt ein environment-Objekt aus einer pip-Anforderungsdatei.

Eine nicht angepinnte pip-Abhängigkeit wird hinzugefügt, wenn pip_version nicht angegeben ist.

get

Gibt das environment-Objekt zurück.

Wenn Bezeichnung angegeben ist, wird das Objekt zurückgegeben, das zuvor mit dem Wert bezeichnet wurde. Es kann nur einer der Versions- oder Bezeichnungsparameter angegeben werden. Wenn beide nicht angezeigt werden, wird die neueste Version des Umgebungsobjekts zurückgegeben.

get_image_details

Gibt die Imagedetails zurück.

label

Bezeichnen Sie das Umgebungsobjekt in Ihrem Arbeitsbereich mit den angegebenen Werten.

list

Gibt ein Wörterbuch zurück, das die Umgebungen im Arbeitsbereich enthält.

load_from_directory

Lädt eine Umgebungsdefinition aus den Dateien in einem Verzeichnis.

register

Registriert das environment-Objekt in Ihrem Arbeitsbereich.

save_to_directory

Speichert eine Umgebungsdefinition in einem Verzeichnis in einem einfach zu bearbeitenden Format.

add_private_pip_wheel

Lädt die private pip wheel-Datei auf den Datenträger in Azure Blob Storage hoch, der an den Arbeitsbereich angefügt ist.

Löst eine Ausnahme aus, wenn bereits ein privates pip wheel-Archiv mit dem gleichen Namen im Speicherblob des Arbeitsbereichs vorhanden ist.

static add_private_pip_wheel(workspace, file_path, exist_ok=False)

Parameter

workspace
Workspace
Erforderlich

Das Arbeitsbereichsobjekt, das zum Registrieren des privaten pip wheel-Archivs verwendet werden soll.

file_path
str
Erforderlich

Pfad zum lokalen pip wheel-Archiv auf dem Datenträger, einschließlich der Dateierweiterung.

exist_ok
bool
Standardwert: False

Gibt an, ob eine Ausnahme ausgelöst werden soll, wenn das wheel-Archiv bereits vorhanden ist.

Gibt zurück

Gibt den vollständigen URI an das hochgeladene pip wheel-Archiv in Azure Blob Storage zurück, das in conda-Abhängigkeiten verwendet werden soll.

Rückgabetyp

str

build

Erstellt ein Docker-Image für diese Umgebung in der Cloud.

build(workspace, image_build_compute=None)

Parameter

workspace
Workspace
Erforderlich

Der Arbeitsbereich und die zugehörigen Azure Container Registry-Instanz, in denen das Image gespeichert wird.

image_build_compute
str
Standardwert: None

Der Computename, an dem die Imageerstellung erfolgt

Gibt zurück

Gibt das details-Objekt für die Imageerstellung zurück.

Rückgabetyp

build_local

Erstellt lokal die Docker- oder conda-Umgebung.

build_local(workspace, platform=None, **kwargs)

Parameter

workspace
Workspace
Erforderlich

Der Arbeitsbereich.

platform
str
Standardwert: None

Plattform. Entweder Linux, Windows oder OSX. Standardmäßig wird die aktuelle Plattform verwendet.

kwargs
dict
Erforderlich

Erweiterte Schlüsselwortargumente

Gibt zurück

Streamt die Docker- oder conda-Buildausgabe fortlaufend an die Konsole.

Rückgabetyp

str

Hinweise

In den folgenden Beispielen wird gezeigt, wie Sie eine lokale Umgebung erstellen. Stellen Sie sicher, dass der Arbeitsbereich als gültiges azureml.core.workspace.Workspace-Objekt instanziiert wird.

Erstellt eine lokale conda-Umgebung


   from azureml.core import Environment
   myenv = Environment(name="myenv")
   registered_env = myenv.register(workspace)
   registered_env.build_local(workspace)

Erstellt eine lokale Docker-Umgebung


   from azureml.core import Environment
   myenv = Environment(name="myenv")
   registered_env = myenv.register(workspace)
   registered_env.build_local(workspace, useDocker=True)

Erstellt lokal ein Docker-Image und pusht es optional in die Containerregistrierung, die dem Arbeitsbereich zugeordnet ist


   from azureml.core import Environment
   myenv = Environment(name="myenv")
   registered_env = myenv.register(workspace)
   registered_env.build_local(workspace, useDocker=True, pushImageToWorkspaceAcr=True)

clone

Klont das environment-Objekt.

Gibt eine neue Instanz des environment-Objekts mit einem neuen Namen zurück.

clone(new_name)

Parameter

new_name
str
Erforderlich

Neuer Umgebungsname

Gibt zurück

Neues environment-Objekt

Rückgabetyp

from_conda_specification

Erstellt ein environment-Objekt aus einer YAML-Datei mit der Umgebungsspezifikation.

Informationen zum Abrufen einer YAML-Datei mit einer Umgebungsspezifikation finden Sie unter Verwalten von Umgebungen im conda-Benutzerhandbuch.

static from_conda_specification(name, file_path)

Parameter

name
str
Erforderlich

Der Umgebungsname.

file_path
str
Erforderlich

Der YAML-Dateipfad der conda-Umgebungsspezifikation.

Gibt zurück

Das environment-Objekt.

Rückgabetyp

from_docker_build_context

Erstellen Sie ein Umgebungsobjekt aus einem Docker-Buildkontext.

static from_docker_build_context(name, docker_build_context)

Parameter

name
str
Erforderlich

Der Umgebungsname.

docker_build_context
DockerBuildContext
Erforderlich

Das DockerBuildContext-Objekt.

Gibt zurück

Das environment-Objekt.

Rückgabetyp

from_docker_image

Erstellen Sie ein Umgebungsobjekt aus einem Docker-Basisimage mit optionalen Python-Abhängigkeiten.

Die Python-Ebene wird der Umgebung hinzugefügt, wenn conda_specification oder pip_requirements angegeben ist. conda_specification und pip_requirements schließen sich gegenseitig aus.

static from_docker_image(name, image, container_registry=None, conda_specification=None, pip_requirements=None)

Parameter

name
str
Erforderlich

Der Umgebungsname.

image
str
Erforderlich

Vollqualifizierter Imagename.

conda_specification
str
Standardwert: None

Conda-Spezifikationsdatei.

container_registry
ContainerRegistry
Standardwert: None

Details zum privaten Container-Repository.

pip_requirements
str
Standardwert: None

Pip-Anforderungsdatei.

Gibt zurück

Das environment-Objekt.

Rückgabetyp

Hinweise

Wenn das Basisimage aus einem privaten Repository stammt, für das eine Autorisierung erforderlich ist, und die Autorisierung nicht auf der AzureML-Arbeitsbereichsebene festgelegt ist, ist container_registry erforderlich

from_dockerfile

Erstellen Sie ein Umgebungsobjekt aus einer Dockerfile-Datei mit optionalen Python-Abhängigkeiten.

Die Python-Ebene wird der Umgebung hinzugefügt, wenn conda_specification oder pip_requirements angegeben ist. conda_specification und pip_requirements schließen sich gegenseitig aus.

static from_dockerfile(name, dockerfile, conda_specification=None, pip_requirements=None)

Parameter

name
str
Erforderlich

Der Umgebungsname.

dockerfile
str
Erforderlich

Dockerfile-Inhalt oder -Pfad zur Datei.

conda_specification
str
Standardwert: None

Conda-Spezifikationsdatei.

pip_requirements
str
Standardwert: None

Pip-Anforderungsdatei.

Gibt zurück

Das environment-Objekt.

Rückgabetyp

from_existing_conda_environment

Erstellt ein environment-Objekt aus einer lokal vorhandenen conda-Umgebung.

Führen Sie conda env list aus, um eine Liste der vorhandenen conda-Umgebungen abzurufen. Weitere Informationen finden Sie unter Verwalten von Umgebungen im conda-Benutzerhandbuch.

static from_existing_conda_environment(name, conda_environment_name)

Parameter

name
str
Erforderlich

Der Umgebungsname.

conda_environment_name
str
Erforderlich

Der Name einer lokal vorhandenen conda-Umgebung.

Gibt zurück

Das environment-Objekt oder „None“, wenn beim Exportieren der conda-Spezifikationsdatei ein Fehler auftritt.

Rückgabetyp

from_pip_requirements

Erstellt ein environment-Objekt aus einer pip-Anforderungsdatei.

Eine nicht angepinnte pip-Abhängigkeit wird hinzugefügt, wenn pip_version nicht angegeben ist.

static from_pip_requirements(name, file_path, pip_version=None)

Parameter

name
str
Erforderlich

Der Umgebungsname.

file_path
str
Erforderlich

Der Pfad der pip-Anforderungsdatei.

pip_version
str
Standardwert: None

Pip-Version für conda-Umgebung.

Gibt zurück

Das environment-Objekt.

Rückgabetyp

get

Gibt das environment-Objekt zurück.

Wenn Bezeichnung angegeben ist, wird das Objekt zurückgegeben, das zuvor mit dem Wert bezeichnet wurde. Es kann nur einer der Versions- oder Bezeichnungsparameter angegeben werden. Wenn beide nicht angezeigt werden, wird die neueste Version des Umgebungsobjekts zurückgegeben.

static get(workspace, name, version=None, label=None)

Parameter

workspace
Workspace
Erforderlich

Der Arbeitsbereich, der die Umgebung enthält.

name
str
Erforderlich

Der Name der zurückzugebenden Umgebung.

version
str
Standardwert: None

Die Version der zurückzugebenden Umgebung.

label
str
Standardwert: None

Umgebungsbezeichnungswert.

Gibt zurück

Das environment-Objekt.

Rückgabetyp

get_image_details

Gibt die Imagedetails zurück.

get_image_details(workspace)

Parameter

workspace
Workspace
Erforderlich

Der Arbeitsbereich.

Gibt zurück

Gibt die Imagedetails als Wörterbuch zurück.

Rückgabetyp

label

Bezeichnen Sie das Umgebungsobjekt in Ihrem Arbeitsbereich mit den angegebenen Werten.

static label(workspace, name, version, labels)

Parameter

workspace
Workspace
Erforderlich

Der Arbeitsbereich

name
str
Erforderlich

Umgebungsname

version
str
Erforderlich

Umgebungsversion

labels
list[str]
Erforderlich

Werte für die Bezeichnung der Umgebung mit

list

Gibt ein Wörterbuch zurück, das die Umgebungen im Arbeitsbereich enthält.

static list(workspace)

Parameter

workspace
Workspace
Erforderlich

Der Arbeitsbereich, aus dem Umgebungen aufgelistet werden sollen.

Gibt zurück

Ein Wörterbuch mit environment-Objekten.

Rückgabetyp

<xref:builtin.dict>[str, Environment]

load_from_directory

Lädt eine Umgebungsdefinition aus den Dateien in einem Verzeichnis.

static load_from_directory(path)

Parameter

path
str
Erforderlich

Pfad zum Quellverzeichnis.

register

Registriert das environment-Objekt in Ihrem Arbeitsbereich.

register(workspace)

Parameter

workspace
Workspace
Erforderlich

Der Arbeitsbereich

name
str
Erforderlich

Gibt zurück

Gibt das environment-Objekt zurück

Rückgabetyp

save_to_directory

Speichert eine Umgebungsdefinition in einem Verzeichnis in einem einfach zu bearbeitenden Format.

save_to_directory(path, overwrite=False)

Parameter

path
str
Erforderlich

Pfad zum Zielverzeichnis.

overwrite
bool
Standardwert: False

Gibt an, ob ein vorhandenes Verzeichnis überschrieben werden soll. Der Standardwert ist FALSE.

Attribute

environment_variables

Verwenden Sie das Objekt azureml.core.RunConfiguration, um Laufzeitvariablen festzulegen.