CondaDependencies Classe

  • Riferimento

Gestisce le dipendenze dell'applicazione in un ambiente di Azure Machine Learning.

Nota

Se non vengono specificati parametri, azureml-defaults viene aggiunto come unica dipendenza pip.

Se il conda_dependencies_file_path parametro non viene specificato, l'oggetto CondaDependencies contiene solo i pacchetti di Azure Machine Learning (azureml-defaults). La dipendenza azureml-defaults non verrà aggiunta a una versione specifica e avrà come destinazione la versione più recente disponibile in PyPi.

Inizializzare un nuovo oggetto per gestire le dipendenze.

Ereditarietà
builtins.object
CondaDependencies

Costruttore

CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)

Parametri

Nome Descrizione
conda_dependencies_file_path
str

Percorso locale di un file di configurazione conda. L'uso di questo parametro consente di caricare e modificare un file di ambiente Conda esistente.

Valore predefinito: None
_underlying_structure
Valore predefinito: None

Commenti

È possibile caricare un file di ambiente conda esistente o scegliere di configurare e gestire le dipendenze dell'applicazione in memoria. Durante l'invio dell'esperimento, viene eseguito un passaggio di preparazione che crea e memorizza nella cache un ambiente conda all'interno del quale viene eseguito l'esperimento.

Se la dipendenza è disponibile sia tramite Conda che pip (da PyPi), usare la versione Conda, poiché i pacchetti Conda in genere sono dotati di file binari predefiniti che rendono l'installazione più affidabile. Per altre informazioni, vedere Informazioni su Conda e Pip.

Per informazioni dettagliate sulle dipendenze dell'immagine di base, vedere il repository https://github.com/Azure/AzureML-Containers .

Nell'esempio seguente viene illustrato come aggiungere un pacchetto usando .add_conda_package


   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))

L'esempio completo è disponibile da https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/manage-azureml-service/authentication-in-azureml/authentication-in-azureml.ipynb

È anche possibile aggiungere un pacchetto pip e le dipendenze impostate nell'oggetto Environment .


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

L'esempio completo è disponibile da https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/using-environments/using-environments.ipynb

Metodi

add_channel

Aggiungere un canale conda.

Un elenco di canali è disponibile all'indirizzo https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/
add_cntk_package

Aggiungere un pacchetto Microsoft Cognitive Toolkit (CNTK).
add_conda_package

Aggiungere un pacchetto conda.
add_pip_package

Aggiungere un pacchetto pip.

Nota

L'aggiunta di una dipendenza di un pacchetto già a cui si fa riferimento rimuoverà il riferimento precedente e aggiungerà un nuovo riferimento alla fine dell'elenco delle dipendenze. Questo può modificare l'ordine delle dipendenze.
add_tensorflow_conda_package

Aggiungere un pacchetto conda Tensorflow.
add_tensorflow_pip_package

Aggiungere un pacchetto tensorflow pip.
as_dict

Restituisce le dipendenze di conda.
create

Inizializzare un nuovo oggetto CondaDependencies.

Restituisce un'istanza di un oggetto CondaDependencies con dipendenze specificate dall'utente.

Nota

Se pip_packages non è specificato, verranno aggiunti azureml-defaults come dipendenze predefinite. L'utente specificato pip_packages dipendenze eseguirà l'override dei valori predefiniti.

Se pin_sdk_version è impostato su true, le dipendenze pip dei pacchetti distribuiti come parte di Azure Machine Learning Python SDK verranno aggiunte alla versione dell'SDK installata nell'ambiente corrente.
get_default_number_of_packages

Restituisce il numero predefinito di pacchetti.
get_python_version

Restituire la versione di Python.
merge_requirements

Requisiti del pacchetto di tipo merge.
remove_channel

Rimuovere un canale conda.
remove_conda_package

Rimuovere un pacchetto conda.
remove_pip_option

Rimuovere un'opzione pip.
remove_pip_package

Rimuovere un pacchetto pip.
save

Salvare l'oggetto dipendenze conda nel file.
save_to_file

DEPRECATO, usare save.

Salvare l'oggetto dipendenze conda nel file.
sdk_origin_url

Restituire l'URL dell'indice di origine SDK.
serialize_to_string

Serializzare l'oggetto dipendenze conda in una stringa.
set_pip_index_url

Impostare l'URL dell'indice pip.
set_pip_option

Aggiungere un'opzione pip.
set_pip_requirements

Sovrascrivere l'intera sezione pip delle dipendenze conda.
set_python_version

Impostare la versione di Python.

add_channel

Aggiungere un canale conda.

Un elenco di canali è disponibile all'indirizzo https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/

add_channel(channel)

Parametri

Nome Descrizione
channel
Necessario
str

Canale conda da aggiungere.

Restituisce

Tipo Descrizione
None

add_cntk_package

Aggiungere un pacchetto Microsoft Cognitive Toolkit (CNTK).

add_cntk_package(core_type='cpu')

Parametri

Nome Descrizione
core_type
str

'cpu' o 'gpu'.

Valore predefinito: cpu

add_conda_package

Aggiungere un pacchetto conda.

add_conda_package(conda_package)

Parametri

Nome Descrizione
conda_package
Necessario
str

Pacchetto conda da aggiungere.

add_pip_package

Aggiungere un pacchetto pip.

Nota

L'aggiunta di una dipendenza di un pacchetto già a cui si fa riferimento rimuoverà il riferimento precedente e aggiungerà un nuovo riferimento alla fine dell'elenco delle dipendenze. Questo può modificare l'ordine delle dipendenze.

add_pip_package(pip_package)

Parametri

Nome Descrizione
pip_package
Necessario
str

Pacchetto pip da aggiungere.

add_tensorflow_conda_package

Aggiungere un pacchetto conda Tensorflow.

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

Parametri

Nome Descrizione
core_type
str

'cpu' o 'gpu'.

Valore predefinito: cpu
version
str

Versione del pacchetto.

Valore predefinito: None

add_tensorflow_pip_package

Aggiungere un pacchetto tensorflow pip.

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

Parametri

Nome Descrizione
core_type
str

'cpu' o 'gpu'.

Valore predefinito: cpu
version
str

Versione del pacchetto.

Valore predefinito: None

as_dict

Restituisce le dipendenze di conda.

as_dict() -> Any

create

Inizializzare un nuovo oggetto CondaDependencies.

Restituisce un'istanza di un oggetto CondaDependencies con dipendenze specificate dall'utente.

Nota

Se pip_packages non è specificato, verranno aggiunti azureml-defaults come dipendenze predefinite. L'utente specificato pip_packages dipendenze eseguirà l'override dei valori predefiniti.

Se pin_sdk_version è impostato su true, le dipendenze pip dei pacchetti distribuiti come parte di Azure Machine Learning Python SDK verranno aggiunte alla versione dell'SDK installata nell'ambiente corrente.

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

Parametri

Nome Descrizione
pip_indexurl
str

URL dell'indice pip. Se non specificato, verrà usato l'URL dell'indice di origine SDK.

Valore predefinito: None
pip_packages
list[str]

Elenco di pacchetti pip.

Valore predefinito: None
conda_packages
list[str]

Elenco di pacchetti conda.

Valore predefinito: None
python_version
str

Versione di Python.

Valore predefinito: 3.9.12
pin_sdk_version
bool

Indica se aggiungere pacchetti SDK alla versione client.

Valore predefinito: True

Restituisce

Tipo Descrizione
CondaDependencies

Oggetto di dipendenza conda.

get_default_number_of_packages

Restituisce il numero predefinito di pacchetti.

get_default_number_of_packages()

Restituisce

Tipo Descrizione
int

Numero predefinito di pacchetti conda e pip.

get_python_version

Restituire la versione di Python.

get_python_version()

Restituisce

Tipo Descrizione
str

Versione di Python.

merge_requirements

Requisiti del pacchetto di tipo merge.

static merge_requirements(requirements)

Parametri

Nome Descrizione
requirements
Necessario
list[str]

Elenco dei requisiti dei pacchetti da unire.

Restituisce

Tipo Descrizione
list[str]

Elenco dei requisiti del pacchetto uniti.

remove_channel

Rimuovere un canale conda.

remove_channel(channel)

Parametri

Nome Descrizione
channel
Necessario
str

Canale conada da rimuovere.

remove_conda_package

Rimuovere un pacchetto conda.

remove_conda_package(conda_package)

Parametri

Nome Descrizione
conda_package
Necessario
str

Pacchetto conda da rimuovere.

remove_pip_option

Rimuovere un'opzione pip.

remove_pip_option(pip_option)

Parametri

Nome Descrizione
pip_option
Necessario
str

Opzione pip da rimuovere.

remove_pip_package

Rimuovere un pacchetto pip.

remove_pip_package(pip_package)

Parametri

Nome Descrizione
pip_package
Necessario
str

Pacchetto pip da rimuovere.

save

Salvare l'oggetto dipendenze conda nel file.

save(path=None)

Parametri

Nome Descrizione
path
str

Percorso completo del file da salvare.

Valore predefinito: None

Restituisce

Tipo Descrizione
str

Percorso conda normalizzato.

Eccezioni

Tipo Descrizione
UserErrorException

Generato per i problemi che salvano le dipendenze.

save_to_file

DEPRECATO, usare save.

Salvare l'oggetto dipendenze conda nel file.

save_to_file(base_directory, conda_file_path=None)

Parametri

Nome Descrizione
base_directory
Necessario
str

Directory di base per salvare il file.
conda_file_path
str

Nome file.

Valore predefinito: None

Restituisce

Tipo Descrizione
str

Percorso conda normalizzato.

sdk_origin_url

Restituire l'URL dell'indice di origine SDK.

static sdk_origin_url()

Restituisce

Tipo Descrizione
str

Restituisce l'URL dell'indice di origine SDK.

serialize_to_string

Serializzare l'oggetto dipendenze conda in una stringa.

serialize_to_string()

Restituisce

Tipo Descrizione
str

Oggetto dipendenze conda serializzato in una stringa.

set_pip_index_url

Impostare l'URL dell'indice pip.

set_pip_index_url(index_url)

Parametri

Nome Descrizione
index_url
Necessario
str

URL dell'indice pip da usare.

set_pip_option

Aggiungere un'opzione pip.

set_pip_option(pip_option)

Parametri

Nome Descrizione
pip_option
Necessario
str

Opzione pip da aggiungere.

set_pip_requirements

Sovrascrivere l'intera sezione pip delle dipendenze conda.

set_pip_requirements(pip_requirements)

Parametri

Nome Descrizione
pip_requirements
Necessario
list[str]

Elenco di pacchetti pip e opzioni.

set_python_version

Impostare la versione di Python.

set_python_version(version)

Parametri

Nome Descrizione
version
Necessario
str

Versione di Python da aggiungere.

Restituisce

Tipo Descrizione
None

Attributi

conda_channels

Restituire i canali conda.

Restituisce

Tipo Descrizione
iter

Restituisce le dipendenze del canale. Le dipendenze restituite sono una copia e le modifiche apportate ai canali restituiti non aggiornerà i canali conda in questo oggetto.

conda_packages

Restituire pacchetti conda.

Restituisce

Tipo Descrizione
iter

Restituisce le dipendenze del pacchetto. Restituisce una copia dei pacchetti conda e le modifiche apportate all'elenco restituito non verranno riflesse nei pacchetti conda di questo oggetto.

pip_options

Restituire le opzioni pip.

Restituisce

Tipo Descrizione
iter

Restituisce le opzioni pip. Restituisce una copia delle opzioni pip e le modifiche apportate all'elenco restituito non verranno riflesse nelle opzioni pip di questo oggetto.

pip_packages

Restituire le dipendenze pip.

Restituisce

Tipo Descrizione
iter

Restituisce le dipendenze pip. Restituisce una copia dei pacchetti pip e le modifiche apportate all'elenco restituito non verranno riflesse nei pacchetti pip di questo oggetto.

DEFAULT_NUMBER_OF_CONDA_PACKAGES 

DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0

DEFAULT_NUMBER_OF_PIP_PACKAGES 

DEFAULT_NUMBER_OF_PIP_PACKAGES = 0