Freigeben über

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

Name Beschreibung
conda_dependencies_file_path
str

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

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

Name Beschreibung
channel
Erforderlich
str

Der hinzuzufügende Conda-Kanal.

Gibt zurück

Typ Beschreibung
None

add_cntk_package

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

add_cntk_package(core_type='cpu')

Parameter

Name Beschreibung
core_type
str

„cpu“ oder „gpu“.

Standardwert: cpu

add_conda_package

Hinzufügen eines Conda-Pakets.

add_conda_package(conda_package)

Parameter

Name Beschreibung
conda_package
Erforderlich
str

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

Name Beschreibung
pip_package
Erforderlich
str

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

Name Beschreibung
core_type
str

„cpu“ oder „gpu“.

Standardwert: cpu
version
str

Die Paketversion

Standardwert: None

add_tensorflow_pip_package

Hinzufügen eines Tensorflow-pip-Pakets.

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

Parameter

Name Beschreibung
core_type
str

„cpu“ oder „gpu“.

Standardwert: cpu
version
str

Die Paketversion

Standardwert: None

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.9.12', pin_sdk_version=True)

Parameter

Name Beschreibung
pip_indexurl
str

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

Standardwert: None
pip_packages
list[str]

Eine Liste von pip-Paketen.

Standardwert: None
conda_packages
list[str]

Eine Liste von Conda-Paketen.

Standardwert: None
python_version
str

Die Python-Version.

Standardwert: 3.9.12
pin_sdk_version
bool

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

Standardwert: True

Gibt zurück

Typ Beschreibung
CondaDependencies

Ein Conda-Abhängigkeitsobjekt.

get_default_number_of_packages

Gibt die Standardanzahl von Paketen zurück.

get_default_number_of_packages()

Gibt zurück

Typ Beschreibung
int

Die Standardanzahl von Conda- und pip-Paketen.

get_python_version

Dient zum Zurückgeben der Python-Version.

get_python_version()

Gibt zurück

Typ Beschreibung
str

Die Python-Version.

merge_requirements

Zusammenführen von Paketanforderungen.

static merge_requirements(requirements)

Parameter

Name Beschreibung
requirements
Erforderlich
list[str]

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

Gibt zurück

Typ Beschreibung
list[str]

Eine Liste der zusammengeführten Paketanforderungen.

remove_channel

Entfernen eines Conda-Kanals.

remove_channel(channel)

Parameter

Name Beschreibung
channel
Erforderlich
str

Der zu entfernende Conada-Kanal.

remove_conda_package

Entfernen eines Conda-Pakets.

remove_conda_package(conda_package)

Parameter

Name Beschreibung
conda_package
Erforderlich
str

Das zu entfernende Conada-Paket.

remove_pip_option

Entfernen einer pip-Option.

remove_pip_option(pip_option)

Parameter

Name Beschreibung
pip_option
Erforderlich
str

Die zu entfernende pip-Option.

remove_pip_package

Entfernen eines pip-Pakets.

remove_pip_package(pip_package)

Parameter

Name Beschreibung
pip_package
Erforderlich
str

Das zu entfernende pip-Paket.

save

Speichern des Conda-Abhängigkeitsobjekts in einer Datei.

save(path=None)

Parameter

Name Beschreibung
path
str

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

Standardwert: None

Gibt zurück

Typ Beschreibung
str

Der normalisierte Conda-Pfad.

Ausnahmen

Typ Beschreibung
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

Name Beschreibung
base_directory
Erforderlich
str

Das Basisverzeichnis zum Speichern der Datei.
conda_file_path
str

Der Dateiname.

Standardwert: None

Gibt zurück

Typ Beschreibung
str

Der normalisierte Conda-Pfad.

sdk_origin_url

Zurückgeben der URL des SDK-Ursprungsindexes.

static sdk_origin_url()

Gibt zurück

Typ Beschreibung
str

Gibt die URL des SDK-Ursprungsindexes zurück.

serialize_to_string

Serialisieren des Conda-Abhängigkeitsobjekts in eine Zeichenfolge.

serialize_to_string()

Gibt zurück

Typ Beschreibung
str

Das in eine Zeichenfolge serialisierte Conda-Abhängigkeitsobjekt.

set_pip_index_url

Festlegen der pip-Index-URL.

set_pip_index_url(index_url)

Parameter

Name Beschreibung
index_url
Erforderlich
str

Die zu verwendende pip-Index-URL.

set_pip_option

Hinzufügen einer pip-Option.

set_pip_option(pip_option)

Parameter

Name Beschreibung
pip_option
Erforderlich
str

Die hinzuzufügende pip-Option.

set_pip_requirements

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

set_pip_requirements(pip_requirements)

Parameter

Name Beschreibung
pip_requirements
Erforderlich
list[str]

Die Liste der pip-Pakete und -Optionen.

set_python_version

Festlegen der Python-Version.

set_python_version(version)

Parameter

Name Beschreibung
version
Erforderlich
str

Die hinzuzufügende Python-Version.

Gibt zurück

Typ Beschreibung
None

Attribute

conda_channels

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

Gibt zurück

Typ Beschreibung
iter

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.

conda_packages

Dient zum Zurückgeben von Conda-Paketen.

Gibt zurück

Typ Beschreibung
iter

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.

pip_options

Dient zum Zurückgeben der pip-Optionen.

Gibt zurück

Typ Beschreibung
iter

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.

pip_packages

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

Gibt zurück

Typ Beschreibung
iter

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.

DEFAULT_NUMBER_OF_CONDA_PACKAGES 

DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0

DEFAULT_NUMBER_OF_PIP_PACKAGES 

DEFAULT_NUMBER_OF_PIP_PACKAGES = 0