CondaDependencies Klasse
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.objectCondaDependencies
Konstruktor
CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)
Parameter
- 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.
- _underlying_structure
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
Rückgabetyp
add_cntk_package
Hinzufügen eines CNTK-Pakets (Microsoft Cognitive Toolkit).
add_cntk_package(core_type='cpu')
Parameter
add_conda_package
Hinzufügen eines Conda-Pakets.
add_conda_package(conda_package)
Parameter
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
add_tensorflow_conda_package
Hinzufügen eines Tensorflow-Conda-Pakets.
add_tensorflow_conda_package(core_type='cpu', version=None)
Parameter
add_tensorflow_pip_package
Hinzufügen eines Tensorflow-pip-Pakets.
add_tensorflow_pip_package(core_type='cpu', version=None)
Parameter
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
Die pip-Index-URL. Wenn keine Angabe erfolgt, wird die URL des SDK-Ursprungsindexes verwendet.
- pin_sdk_version
- bool
Gibt an, ob SDK-Pakete an die Clientversion angeheftet werden sollen.
Gibt zurück
Ein Conda-Abhängigkeitsobjekt.
Rückgabetyp
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
get_python_version
Dient zum Zurückgeben der Python-Version.
get_python_version()
Gibt zurück
Die Python-Version.
Rückgabetyp
merge_requirements
Zusammenführen von Paketanforderungen.
static merge_requirements(requirements)
Parameter
Eine Liste der Paketanforderungen, die zusammengeführt werden sollen.
Gibt zurück
Eine Liste der zusammengeführten Paketanforderungen.
Rückgabetyp
remove_channel
Entfernen eines Conda-Kanals.
remove_channel(channel)
Parameter
remove_conda_package
Entfernen eines Conda-Pakets.
remove_conda_package(conda_package)
Parameter
remove_pip_option
Entfernen einer pip-Option.
remove_pip_option(pip_option)
Parameter
remove_pip_package
Entfernen eines pip-Pakets.
remove_pip_package(pip_package)
Parameter
save
Speichern des Conda-Abhängigkeitsobjekts in einer Datei.
save(path=None)
Parameter
- path
- str
Der vollqualifizierte Pfad der Datei, in der die Speicherung erfolgen soll.
Gibt zurück
Der normalisierte Conda-Pfad.
Rückgabetyp
Ausnahmen
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
Gibt zurück
Der normalisierte Conda-Pfad.
Rückgabetyp
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
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
set_pip_index_url
Festlegen der pip-Index-URL.
set_pip_index_url(index_url)
Parameter
set_pip_option
Hinzufügen einer pip-Option.
set_pip_option(pip_option)
Parameter
set_pip_requirements
Überschreiben des gesamten pip-Abschnitts der Conda-Abhängigkeiten.
set_pip_requirements(pip_requirements)
Parameter
set_python_version
Festlegen der Python-Version.
set_python_version(version)
Parameter
Rückgabetyp
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
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
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
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
DEFAULT_NUMBER_OF_CONDA_PACKAGES
DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0
DEFAULT_NUMBER_OF_PIP_PACKAGES
DEFAULT_NUMBER_OF_PIP_PACKAGES = 0
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für