CondaDependencies Klasse

Referenz

Verwalten von Anwendungsabhängigkeiten in einer Azure Machine Learning-Umgebung.

Hinweis

Wenn keine Parameter angegeben werden, wird „azureml-defaults“ als einzige PIP-Abhängigkeit hinzugefügt.

Ist der Parameter conda_dependencies_file_path nicht angegeben, enthält das CondaDependencies-Objekt nur die Azure Machine Learning-Pakete (azureml-defaults). Die Abhängigkeit azureml-defaults wird nicht an eine bestimmte Version angeheftet und ist auf die neueste in PyPi verfügbare Version ausgerichtet.

Initialisieren Sie ein neues Objekt, um Abhängigkeiten zu verwalten.

Vererbung: builtins.object

CondaDependencies

Konstruktor

CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)

Parameter

conda_dependencies_file_path: str

Standardwert: None

Ein lokaler Pfad zu einer Conda-Konfigurationsdatei. Die Verwendung dieses Parameters ermöglicht das Laden und Bearbeiten einer vorhandenen Conda-Umgebungsdatei.

_underlying_structure

Standardwert: None

Hinweise

Sie können eine vorhandene Conda-Umgebungsdatei laden oder die Anwendungsabhängigkeiten im Arbeitsspeicher konfigurieren und verwalten. Während der Experimentübermittlung wird ein Vorbereitungsschritt ausgeführt, mit dem eine Conda-Umgebung erstellt und zwischengespeichert wird, in der das Experiment ausgeführt wird.

Wenn die Abhängigkeit sowohl über Conda als auch über pip (von PyPi) verfügbar ist, sollten Sie die Conda-Version verwenden, da Conda-Pakete in der Regel mit vorgefertigten Binärdateien geliefert werden, welche die Zuverlässigkeit der Installation erhöhen. Weitere Informationen finden Sie unter Grundlegendes zu Conda und pip.

Ausführliche Informationen zu Basisimageabhängigkeiten finden Sie im Repository https://github.com/Azure/AzureML-Containers.

Im folgenden Beispiel wird gezeigt, wie Sie mithilfe von add_conda_package ein Paket hinzufügen.


   from azureml.core.authentication import MsiAuthentication

   msi_auth = MsiAuthentication()

   ws = Workspace(subscription_id="my-subscription-id",
                  resource_group="my-ml-rg",
                  workspace_name="my-ml-workspace",
                  auth=msi_auth)

   print("Found workspace {} at location {}".format(ws.name, ws.location))

Das vollständige Beispiel finden Sie unter https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/manage-azureml-service/authentication-in-azureml/authentication-in-azureml.ipynb.

Es ist auch möglich, im Environment-Objekt ein pip-Paket hinzuzufügen und die Abhängigkeiten festzulegen.


   conda_dep.add_pip_package("pillow==6.2.1")
   myenv.python.conda_dependencies=conda_dep

Das vollständige Beispiel finden Sie unter https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/using-environments/using-environments.ipynb.

Methoden

add_channel	Einen Conda-Kanal hinzufügen. Eine Liste der Kanäle finden Sie unter https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/.
add_cntk_package	Hinzufügen eines CNTK-Pakets (Microsoft Cognitive Toolkit).
add_conda_package	Hinzufügen eines Conda-Pakets.
add_pip_package	Hinzufügen eines pip-Pakets. Hinweis Wenn Sie eine Abhängigkeit eines Pakets hinzufügen, auf das bereits verwiesen wurde, wird der vorherige Verweis entfernt und am Ende der Liste der Abhängigkeiten ein neuer Verweis hinzugefügt. Dadurch kann die Reihenfolge der Abhängigkeiten geändert werden.
add_tensorflow_conda_package	Hinzufügen eines Tensorflow-Conda-Pakets.
add_tensorflow_pip_package	Hinzufügen eines Tensorflow-pip-Pakets.
as_dict	Zurückgeben von Conda-Abhängigkeiten.
create	Initialisieren eines neuen CondaDependencies-Objekt. Gibt eine Instanz eines CondaDependencies-Objekts mit benutzerdefinierten Abhängigkeiten zurück. Hinweis Wenn „pip_packages“ nicht angegeben ist, wird „azureml-defaults“ als Standardabhängigkeiten hinzugefügt. Vom Benutzer angegebene Abhängigkeiten vom Typ „pip_packages“ überschreiben die Standardwerte. Wenn „pin_sdk_version“ auf „true“ festgelegt ist, werden pip-Abhängigkeiten der Pakete, die als Teil des Azure Machine Learning Python SDK verteilt werden, an die in der aktuellen Umgebung installierte SDK-Version angeheftet.
get_default_number_of_packages	Gibt die Standardanzahl von Paketen zurück.
get_python_version	Dient zum Zurückgeben der Python-Version.
merge_requirements	Zusammenführen von Paketanforderungen.
remove_channel	Entfernen eines Conda-Kanals.
remove_conda_package	Entfernen eines Conda-Pakets.
remove_pip_option	Entfernen einer pip-Option.
remove_pip_package	Entfernen eines pip-Pakets.
save	Speichern des Conda-Abhängigkeitsobjekts in einer Datei.
save_to_file	VERALTET. Verwenden Sie save. Speichern des Conda-Abhängigkeitsobjekts in einer Datei.
sdk_origin_url	Zurückgeben der URL des SDK-Ursprungsindexes.
serialize_to_string	Serialisieren des Conda-Abhängigkeitsobjekts in eine Zeichenfolge.
set_pip_index_url	Festlegen der pip-Index-URL.
set_pip_option	Hinzufügen einer pip-Option.
set_pip_requirements	Überschreiben des gesamten pip-Abschnitts der Conda-Abhängigkeiten.
set_python_version	Festlegen der Python-Version.

add_channel

Einen Conda-Kanal hinzufügen.

Eine Liste der Kanäle finden Sie unter https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/.

add_channel(channel)

Parameter

channel: str

Erforderlich

Der hinzuzufügende Conda-Kanal.

Rückgabetyp

None

add_cntk_package

Hinzufügen eines CNTK-Pakets (Microsoft Cognitive Toolkit).

add_cntk_package(core_type='cpu')

Parameter

core_type: str

Standardwert: cpu

„cpu“ oder „gpu“.

add_conda_package

Hinzufügen eines Conda-Pakets.

add_conda_package(conda_package)

Parameter

conda_package: str

Erforderlich

Das hinzuzufügende Conda-Paket.

add_pip_package

Hinzufügen eines pip-Pakets.

Hinweis

Wenn Sie eine Abhängigkeit eines Pakets hinzufügen, auf das bereits verwiesen wurde, wird der vorherige Verweis entfernt und am Ende der Liste der Abhängigkeiten ein neuer Verweis hinzugefügt. Dadurch kann die Reihenfolge der Abhängigkeiten geändert werden.

add_pip_package(pip_package)

Parameter

pip_package: str

Erforderlich

Das hinzuzufügende pip-Paket.

add_tensorflow_conda_package

Hinzufügen eines Tensorflow-Conda-Pakets.

add_tensorflow_conda_package(core_type='cpu', version=None)

Parameter

core_type: str

Standardwert: cpu

„cpu“ oder „gpu“.

version: str

Standardwert: None

Die Paketversion

add_tensorflow_pip_package

Hinzufügen eines Tensorflow-pip-Pakets.

add_tensorflow_pip_package(core_type='cpu', version=None)

Parameter

core_type: str

Standardwert: cpu

„cpu“ oder „gpu“.

version: str

Standardwert: None

Die Paketversion

as_dict

Zurückgeben von Conda-Abhängigkeiten.

as_dict() -> Any

create

Initialisieren eines neuen CondaDependencies-Objekt.

Gibt eine Instanz eines CondaDependencies-Objekts mit benutzerdefinierten Abhängigkeiten zurück.

Hinweis

Wenn „pip_packages“ nicht angegeben ist, wird „azureml-defaults“ als Standardabhängigkeiten hinzugefügt. Vom Benutzer angegebene Abhängigkeiten vom Typ „pip_packages“ überschreiben die Standardwerte.

Wenn „pin_sdk_version“ auf „true“ festgelegt ist, werden pip-Abhängigkeiten der Pakete, die als Teil des Azure Machine Learning Python SDK verteilt werden, an die in der aktuellen Umgebung installierte SDK-Version angeheftet.

static create(pip_indexurl=None, pip_packages=None, conda_packages=None, python_version='3.8.13', pin_sdk_version=True)

Parameter

pip_indexurl: str

Standardwert: None

Die pip-Index-URL. Wenn keine Angabe erfolgt, wird die URL des SDK-Ursprungsindexes verwendet.

pip_packages: list[str]

Standardwert: None

Eine Liste von pip-Paketen.

conda_packages: list[str]

Standardwert: None

Eine Liste von Conda-Paketen.

python_version: str

Standardwert: 3.8.13

Die Python-Version.

pin_sdk_version: bool

Standardwert: True

Gibt an, ob SDK-Pakete an die Clientversion angeheftet werden sollen.

Gibt zurück

Ein Conda-Abhängigkeitsobjekt.

Rückgabetyp

CondaDependencies

get_default_number_of_packages

Gibt die Standardanzahl von Paketen zurück.

get_default_number_of_packages()

Gibt zurück

Die Standardanzahl von Conda- und pip-Paketen.

Rückgabetyp

int

get_python_version

Dient zum Zurückgeben der Python-Version.

get_python_version()

Gibt zurück

Die Python-Version.

Rückgabetyp

str

merge_requirements

Zusammenführen von Paketanforderungen.

static merge_requirements(requirements)

Parameter

requirements: list[str]

Erforderlich

Eine Liste der Paketanforderungen, die zusammengeführt werden sollen.

Gibt zurück

Eine Liste der zusammengeführten Paketanforderungen.

Rückgabetyp

list[str]

remove_channel

Entfernen eines Conda-Kanals.

remove_channel(channel)

Parameter

channel: str

Erforderlich

Der zu entfernende Conada-Kanal.

remove_conda_package

Entfernen eines Conda-Pakets.

remove_conda_package(conda_package)

Parameter

conda_package: str

Erforderlich

Das zu entfernende Conada-Paket.

remove_pip_option

Entfernen einer pip-Option.

remove_pip_option(pip_option)

Parameter

pip_option: str

Erforderlich

Die zu entfernende pip-Option.

remove_pip_package

Entfernen eines pip-Pakets.

remove_pip_package(pip_package)

Parameter

pip_package: str

Erforderlich

Das zu entfernende pip-Paket.

save

Speichern des Conda-Abhängigkeitsobjekts in einer Datei.

save(path=None)

Parameter

path: str

Standardwert: None

Der vollqualifizierte Pfad der Datei, in der die Speicherung erfolgen soll.

Gibt zurück

Der normalisierte Conda-Pfad.

Rückgabetyp

str

Ausnahmen

UserErrorException

Wird bei Problemen beim Speichern der Abhängigkeiten ausgelöst.

save_to_file

VERALTET. Verwenden Sie save.

Speichern des Conda-Abhängigkeitsobjekts in einer Datei.

save_to_file(base_directory, conda_file_path=None)

Parameter

base_directory: str

Erforderlich

Das Basisverzeichnis zum Speichern der Datei.

conda_file_path: str

Standardwert: None

Der Dateiname.

Gibt zurück

Der normalisierte Conda-Pfad.

Rückgabetyp

str

sdk_origin_url

Zurückgeben der URL des SDK-Ursprungsindexes.

static sdk_origin_url()

Gibt zurück

Gibt die URL des SDK-Ursprungsindexes zurück.

Rückgabetyp

str

serialize_to_string

Serialisieren des Conda-Abhängigkeitsobjekts in eine Zeichenfolge.

serialize_to_string()

Gibt zurück

Das in eine Zeichenfolge serialisierte Conda-Abhängigkeitsobjekt.

Rückgabetyp

str

set_pip_index_url

Festlegen der pip-Index-URL.

set_pip_index_url(index_url)

Parameter

index_url: str

Erforderlich

Die zu verwendende pip-Index-URL.

set_pip_option

Hinzufügen einer pip-Option.

set_pip_option(pip_option)

Parameter

pip_option: str

Erforderlich

Die hinzuzufügende pip-Option.

set_pip_requirements

Überschreiben des gesamten pip-Abschnitts der Conda-Abhängigkeiten.

set_pip_requirements(pip_requirements)

Parameter

pip_requirements: list[str]

Erforderlich

Die Liste der pip-Pakete und -Optionen.

set_python_version

Festlegen der Python-Version.

set_python_version(version)

Parameter

version: str

Erforderlich

Die hinzuzufügende Python-Version.

Rückgabetyp

None

Attribute

conda_channels

Dient zum Zurückgeben von Conda-Kanälen.

Gibt zurück

Gibt die Kanalabhängigkeiten zurück. Die zurückgegebenen Abhängigkeiten sind eine Kopie. Durch Änderungen an den zurückgegebenen Kanälen werden die Conda-Kanäle in diesem Objekt nicht aktualisiert.

Rückgabetyp

iter

conda_packages

Dient zum Zurückgeben von Conda-Paketen.

Gibt zurück

Gibt die Paketabhängigkeiten zurück. Gibt eine Kopie von Conda-Paketen zurück. Änderungen an der zurückgegebenen Liste werden nicht in den Conda-Paketen dieses Objekts widergespiegelt.

Rückgabetyp

iter

pip_options

Dient zum Zurückgeben der pip-Optionen.

Gibt zurück

Gibt die pip-Optionen zurück. Gibt eine Kopie der pip-Optionen zurück. Änderungen an der zurückgegebenen Liste werden nicht in den pip-Optionen dieses Objekts widergespiegelt.

Rückgabetyp

iter

pip_packages

Dient zum Zurückgeben der pip-Abhängigkeiten.

Gibt zurück

Gibt die pip-Abhängigkeiten zurück. Gibt eine Kopie der pip-Pakete zurück. Änderungen an der zurückgegebenen Liste werden nicht in den pip-Paketen dieses Objekts widergespiegelt.

Rückgabetyp

iter

DEFAULT_NUMBER_OF_CONDA_PACKAGES

DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0

DEFAULT_NUMBER_OF_PIP_PACKAGES

DEFAULT_NUMBER_OF_PIP_PACKAGES = 0