Compartir a través de

CondaDependencies Clase

  • Referencia

Administra las dependencias de la aplicación en un entorno de Azure Machine Learning.

Nota

Si no se especifica ningún parámetro, se agrega azureml-defaults como la única dependencia de pip.

Si no se especifica el parámetro conda_dependencies_file_path, el objeto CondaDependencies solo contiene los paquetes de Azure Machine Learning (azureml-defaults). La dependencia azureml-defaults no se anclará a una versión específica y se dirigirá a la versión más reciente disponible en PyPi.

Inicialice un nuevo objeto para administrar las dependencias.

Herencia
builtins.object
CondaDependencies

Constructor

CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)

Parámetros

Nombre Description
conda_dependencies_file_path
str

Ruta de acceso local a un archivo de configuración de Conda. El uso de este parámetro permite cargar y editar un archivo de entorno de Conda existente.

Valor predeterminado: None
_underlying_structure
Valor predeterminado: None

Comentarios

Puede cargar un archivo de entorno de Conda existente o elegir configurar y administrar las dependencias de la aplicación en memoria. Durante el envío del experimento, se ejecuta un paso de preparación que crea y almacena en caché un entorno de Conda en el que se ejecuta el experimento.

Si la dependencia está disponible tanto mediante Conda como mediante pip (de PyPi), utilice la versión de Conda, ya que los paquetes de Conda normalmente incluyen archivos binarios pregenerados que hacen que la instalación sea más confiable. Para obtener más información, consulte la descripción de Conda y PIP.

Consulte el repositorio https://github.com/Azure/AzureML-Containers para más información sobre las dependencias de imagen base.

En el siguiente ejemplo, se muestra cómo agregar un paquete con 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))

El ejemplo completo está disponible en https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/manage-azureml-service/authentication-in-azureml/authentication-in-azureml.ipynb.

También se puede agregar un paquete de pip y las dependencias establecidas en el objeto Environment.


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

El ejemplo completo está disponible en https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/using-environments/using-environments.ipynb.

Métodos

add_channel

Agrega un canal de Conda.

Puede encontrar una lista de canales en https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/.
add_cntk_package

Agrega un paquete de Microsoft Cognitive Toolkit (CNTK).
add_conda_package

Agrega un paquete de Conda.
add_pip_package

Agrega un paquete de pip.

Nota

Al agregar una dependencia de un paquete al que ya se ha hecho referencia, se quitará la referencia anterior y se agregará una nueva referencia al final de la lista de dependencias. Esto puede cambiar el orden de las dependencias.
add_tensorflow_conda_package

Agrega un paquete de Conda de Tensorflow.
add_tensorflow_pip_package

Agrega un paquete de pip de Tensorflow.
as_dict

Devuelve las dependencias de Conda.
create

Inicializa un nuevo objeto CondaDependencies.

Devuelve una instancia de un objeto CondaDependencies con las dependencias especificadas por el usuario.

Nota

Si no se especifica pip_packages, se agregará azureml-defaults como dependencias predeterminadas. Las dependencias de pip_packages especificadas por el usuario invalidarán los valores predeterminados.

Si pin_sdk_version se establece en true, las dependencias de pip de los paquetes distribuidos como parte del SDK de Python de Azure Machine Learning se anclarán a la versión del SDK instalada en el entorno actual.
get_default_number_of_packages

Devuelve el número predeterminado de paquetes.
get_python_version

Devuelve la versión de Python.
merge_requirements

Combina los requisitos de paquetes.
remove_channel

Quita un canal de Conda.
remove_conda_package

Quita un paquete de Conda.
remove_pip_option

Quita una opción de pip.
remove_pip_package

Quita un paquete de pip.
save

Guarda el objeto de dependencias de Conda en archivo.
save_to_file

EN DESUSO, utilice save.

Guarda el objeto de dependencias de Conda en archivo.
sdk_origin_url

Devuelve la dirección URL del índice de origen del SDK.
serialize_to_string

Serializa el objeto de dependencias de Conda en una cadena.
set_pip_index_url

Establece la dirección URL del índice de pip.
set_pip_option

Agrega una opción de pip.
set_pip_requirements

Sobrescribe toda la sección de pip de las dependencias de Conda.
set_python_version

Establece la versión de Python.

add_channel

Agrega un canal de Conda.

Puede encontrar una lista de canales en https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/.

add_channel(channel)

Parámetros

Nombre Description
channel
Requerido
str

Canal de Conda que se va a agregar.

Devoluciones

Tipo Description
None

add_cntk_package

Agrega un paquete de Microsoft Cognitive Toolkit (CNTK).

add_cntk_package(core_type='cpu')

Parámetros

Nombre Description
core_type
str

"cpu" o "gpu".

Valor predeterminado: cpu

add_conda_package

Agrega un paquete de Conda.

add_conda_package(conda_package)

Parámetros

Nombre Description
conda_package
Requerido
str

Paquete de Conda que se va a agregar.

add_pip_package

Agrega un paquete de pip.

Nota

Al agregar una dependencia de un paquete al que ya se ha hecho referencia, se quitará la referencia anterior y se agregará una nueva referencia al final de la lista de dependencias. Esto puede cambiar el orden de las dependencias.

add_pip_package(pip_package)

Parámetros

Nombre Description
pip_package
Requerido
str

Paquete de pip que se va a agregar.

add_tensorflow_conda_package

Agrega un paquete de Conda de Tensorflow.

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

Parámetros

Nombre Description
core_type
str

"cpu" o "gpu".

Valor predeterminado: cpu
version
str

Versión del paquete.

Valor predeterminado: None

add_tensorflow_pip_package

Agrega un paquete de pip de Tensorflow.

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

Parámetros

Nombre Description
core_type
str

"cpu" o "gpu".

Valor predeterminado: cpu
version
str

Versión del paquete.

Valor predeterminado: None

as_dict

Devuelve las dependencias de Conda.

as_dict() -> Any

create

Inicializa un nuevo objeto CondaDependencies.

Devuelve una instancia de un objeto CondaDependencies con las dependencias especificadas por el usuario.

Nota

Si no se especifica pip_packages, se agregará azureml-defaults como dependencias predeterminadas. Las dependencias de pip_packages especificadas por el usuario invalidarán los valores predeterminados.

Si pin_sdk_version se establece en true, las dependencias de pip de los paquetes distribuidos como parte del SDK de Python de Azure Machine Learning se anclarán a la versión del SDK instalada en el entorno actual.

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

Parámetros

Nombre Description
pip_indexurl
str

Dirección URL del índice de pip. Si no se especifica, se usará la dirección URL del índice de origen del SDK.

Valor predeterminado: None
pip_packages
list[str]

Lista de paquetes de pip.

Valor predeterminado: None
conda_packages
list[str]

Lista de paquetes de Conda.

Valor predeterminado: None
python_version
str

Versión de Python.

Valor predeterminado: 3.9.12
pin_sdk_version
bool

Indica si se deben anclar los paquetes del SDK a la versión del cliente.

Valor predeterminado: True

Devoluciones

Tipo Description
CondaDependencies

Objeto de dependencia de Conda.

get_default_number_of_packages

Devuelve el número predeterminado de paquetes.

get_default_number_of_packages()

Devoluciones

Tipo Description
int

Número predeterminado de paquetes de Conda y pip.

get_python_version

Devuelve la versión de Python.

get_python_version()

Devoluciones

Tipo Description
str

Versión de Python.

merge_requirements

Combina los requisitos de paquetes.

static merge_requirements(requirements)

Parámetros

Nombre Description
requirements
Requerido
list[str]

Lista de requisitos de paquetes para combinar.

Devoluciones

Tipo Description
list[str]

Lista de requisitos de paquetes combinados.

remove_channel

Quita un canal de Conda.

remove_channel(channel)

Parámetros

Nombre Description
channel
Requerido
str

Canal de Conda que se va a quitar.

remove_conda_package

Quita un paquete de Conda.

remove_conda_package(conda_package)

Parámetros

Nombre Description
conda_package
Requerido
str

Paquete de Conda que se va a quitar.

remove_pip_option

Quita una opción de pip.

remove_pip_option(pip_option)

Parámetros

Nombre Description
pip_option
Requerido
str

Opción de pip que se va a quitar.

remove_pip_package

Quita un paquete de pip.

remove_pip_package(pip_package)

Parámetros

Nombre Description
pip_package
Requerido
str

Paquete de pip que se va a quitar.

save

Guarda el objeto de dependencias de Conda en archivo.

save(path=None)

Parámetros

Nombre Description
path
str

Ruta de acceso completa del archivo en el que desea guardar.

Valor predeterminado: None

Devoluciones

Tipo Description
str

Ruta de acceso normalizada de Conda.

Excepciones

Tipo Description
UserErrorException

Se genera para los problemas al guardar las dependencias.

save_to_file

EN DESUSO, utilice save.

Guarda el objeto de dependencias de Conda en archivo.

save_to_file(base_directory, conda_file_path=None)

Parámetros

Nombre Description
base_directory
Requerido
str

Directorio base para guardar el archivo.
conda_file_path
str

Nombre del archivo.

Valor predeterminado: None

Devoluciones

Tipo Description
str

Ruta de acceso normalizada de Conda.

sdk_origin_url

Devuelve la dirección URL del índice de origen del SDK.

static sdk_origin_url()

Devoluciones

Tipo Description
str

Devuelve la dirección URL del índice de origen del SDK.

serialize_to_string

Serializa el objeto de dependencias de Conda en una cadena.

serialize_to_string()

Devoluciones

Tipo Description
str

Objeto de dependencias de Conda serializado en una cadena.

set_pip_index_url

Establece la dirección URL del índice de pip.

set_pip_index_url(index_url)

Parámetros

Nombre Description
index_url
Requerido
str

Dirección URL del índice de pip que se va a usar.

set_pip_option

Agrega una opción de pip.

set_pip_option(pip_option)

Parámetros

Nombre Description
pip_option
Requerido
str

Opción de pip que se va a agregar.

set_pip_requirements

Sobrescribe toda la sección de pip de las dependencias de Conda.

set_pip_requirements(pip_requirements)

Parámetros

Nombre Description
pip_requirements
Requerido
list[str]

Lista de opciones y paquetes de pip.

set_python_version

Establece la versión de Python.

set_python_version(version)

Parámetros

Nombre Description
version
Requerido
str

Versión de Python que se va a agregar.

Devoluciones

Tipo Description
None

Atributos

conda_channels

Devuelve los canales de Conda.

Devoluciones

Tipo Description
iter

Devuelve las dependencias del canal. Las dependencias devueltas son una copia y los cambios en los canales devueltos no actualizarán los canales de Conda en este objeto.

conda_packages

Devuelve los paquetes de Conda.

Devoluciones

Tipo Description
iter

Devuelve las dependencias del paquete. Devuelve una copia de los paquetes de Conda y las modificaciones de la lista devuelta no se reflejarán en los paquetes de Conda de este objeto.

pip_options

Devuelve las opciones de pip.

Devoluciones

Tipo Description
iter

Devuelve las opciones de pip. Devuelve una copia de las opciones de pip y las modificaciones de la lista devuelta no se reflejarán en las opciones de pip de este objeto.

pip_packages

Devuelve las dependencias de pip.

Devoluciones

Tipo Description
iter

Devuelve las dependencias de pip. Devuelve una copia de los paquetes de pip y las modificaciones de la lista devuelta no se reflejarán en los paquetes de pip de este objeto.

DEFAULT_NUMBER_OF_CONDA_PACKAGES 

DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0

DEFAULT_NUMBER_OF_PIP_PACKAGES 

DEFAULT_NUMBER_OF_PIP_PACKAGES = 0