Partilhar via

CondaDependencies Classe

Gerencia dependências de aplicativos em um ambiente do Azure Machine Learning.

Observação

Se nenhum parâmetro for especificado, azureml-defaults será adicionado como a única dependência pip.

Se o conda_dependencies_file_path parâmetro não for especificado, o objeto CondaDependencies conterá apenas os pacotes do Azure Machine Learning (azureml-defaults). A dependência azureml-defaults não será fixada a uma versão específica e terá como alvo a versão mais recente disponível no PyPi.

Inicialize um novo objeto para gerenciar dependências.

Construtor

CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)

Parâmetros

Name Description
conda_dependencies_file_path
str

Um caminho local para um arquivo de configuração conda. O uso deste parâmetro permite carregar e editar um arquivo de ambiente Conda existente.

Default value: None
_underlying_structure
Default value: None

Observações

Você pode carregar um arquivo de ambiente conda existente ou optar por configurar e gerenciar as dependências do aplicativo na memória. Durante o envio do experimento, uma etapa de preparação é executada que cria e armazena em cache um ambiente de conda no qual o experimento é executado.

Se a sua dependência estiver disponível através do Conda e do pip (do PyPi), use a versão Conda, pois os pacotes Conda normalmente vêm com binários pré-construídos que tornam a instalação mais confiável. Para obter mais informações, consulte Noções básicas sobre Conda e Pip.

Consulte o repositório https://github.com/Azure/AzureML-Containers para obter detalhes sobre as dependências da imagem base.

O exemplo a seguir mostra como adicionar um pacote usando o 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))

A amostra completa está disponível em https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/manage-azureml-service/authentication-in-azureml/authentication-in-azureml.ipynb

Um pacote pip também pode ser adicionado e as dependências definidas no Environment objeto.


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

A amostra completa está disponível em https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/using-environments/using-environments.ipynb

Métodos

add_channel

Adicione um canal conda.

Uma lista de canais pode ser encontrada em https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/
add_cntk_package

Adicione um pacote do Microsoft Cognitive Toolkit (CNTK).
add_conda_package

Adicione um pacote de conda.
add_pip_package

Adicione um pacote pip.

Observação

Adicionar uma dependência de um pacote já referenciado removerá a referência anterior e adicionará uma nova referência ao final da lista de dependências. Isso pode alterar a ordem das dependências.
add_tensorflow_conda_package

Adicione um pacote Conda Tensorflow.
add_tensorflow_pip_package

Adicione um pacote de pip Tensorflow.
as_dict

Return conda dependecies.
create

Inicialize um novo objeto CondaDependencies.

Retorna uma instância de um objeto CondaDependencies com dependências especificadas pelo usuário.

Observação

Se pip_packages não for especificado, azureml-defaults será adicionado como as dependências padrão. As dependências de pip_packages especificadas pelo usuário substituirão os valores padrão.

Se pin_sdk_version estiver definido como true, as dependências pip dos pacotes distribuídos como parte do SDK Python do Azure Machine Learning serão fixadas à versão do SDK instalada no ambiente atual.
get_default_number_of_packages

Retornar o número padrão de pacotes.
get_python_version

Retorne a versão do Python.
merge_requirements

Mesclar requisitos de pacote.
remove_channel

Remova um canal de conda.
remove_conda_package

Remova um pacote de conda.
remove_pip_option

Remova uma opção pip.
remove_pip_package

Remova um pacote pip.
save

Salve o objeto conda dependencies no arquivo.
save_to_file

DEPRECATED, use save.

Salve o objeto conda dependencies no arquivo.
sdk_origin_url

Retornar a URL do índice de origem do SDK.
serialize_to_string

Serialize o objeto conda dependencies em uma cadeia de caracteres.
set_pip_index_url

Defina o URL do índice pip.
set_pip_option

Adicione uma opção pip.
set_pip_requirements

Substitua toda a seção pip das dependências conda.
set_python_version

Defina a versão do Python.

add_channel

Adicione um canal conda.

Uma lista de canais pode ser encontrada em https://docs.anaconda.com/anaconda/user-guide/tasks/using-repositories/

add_channel(channel)

Parâmetros

Name Description
channel
Necessário
str

O canal conda para adicionar.

Devoluções

Tipo Description
None

add_cntk_package

Adicione um pacote do Microsoft Cognitive Toolkit (CNTK).

add_cntk_package(core_type='cpu')

Parâmetros

Name Description
core_type
str

'CPU' ou 'GPU'.

Default value: cpu

add_conda_package

Adicione um pacote de conda.

add_conda_package(conda_package)

Parâmetros

Name Description
conda_package
Necessário
str

O pacote conda para adicionar.

add_pip_package

Adicione um pacote pip.

Observação

Adicionar uma dependência de um pacote já referenciado removerá a referência anterior e adicionará uma nova referência ao final da lista de dependências. Isso pode alterar a ordem das dependências.

add_pip_package(pip_package)

Parâmetros

Name Description
pip_package
Necessário
str

O pacote pip a ser adicionado.

add_tensorflow_conda_package

Adicione um pacote Conda Tensorflow.

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

Parâmetros

Name Description
core_type
str

'CPU' ou 'GPU'.

Default value: cpu
version
str

A versão do pacote.

Default value: None

add_tensorflow_pip_package

Adicione um pacote de pip Tensorflow.

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

Parâmetros

Name Description
core_type
str

'CPU' ou 'GPU'.

Default value: cpu
version
str

A versão do pacote.

Default value: None

as_dict

Return conda dependecies.

as_dict() -> Any

create

Inicialize um novo objeto CondaDependencies.

Retorna uma instância de um objeto CondaDependencies com dependências especificadas pelo usuário.

Observação

Se pip_packages não for especificado, azureml-defaults será adicionado como as dependências padrão. As dependências de pip_packages especificadas pelo usuário substituirão os valores padrão.

Se pin_sdk_version estiver definido como true, as dependências pip dos pacotes distribuídos como parte do SDK Python do Azure Machine Learning serão fixadas à versão do SDK instalada no ambiente atual.

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

Parâmetros

Name Description
pip_indexurl
str

A URL do índice pip. Se não for especificado, a URL do índice de origem do SDK será usada.

Default value: None
pip_packages
list[str]

Uma lista de pacotes pip.

Default value: None
conda_packages
list[str]

Uma lista de pacotes de conda.

Default value: None
python_version
str

A versão Python.

Default value: 3.9.12
pin_sdk_version
bool

Indica se os pacotes SDK devem ser fixados na versão do cliente.

Default value: True

Devoluções

Tipo Description
CondaDependencies

Um objeto de dependência conda.

get_default_number_of_packages

Retornar o número padrão de pacotes.

get_default_number_of_packages()

Devoluções

Tipo Description
int

O número padrão de pacotes conda e pip.

get_python_version

Retorne a versão do Python.

get_python_version()

Devoluções

Tipo Description
str

A versão Python.

merge_requirements

Mesclar requisitos de pacote.

static merge_requirements(requirements)

Parâmetros

Name Description
requirements
Necessário
list[str]

Uma lista de requisitos de pacotes para mesclagem.

Devoluções

Tipo Description
list[str]

Uma lista de requisitos de pacotes mesclados.

remove_channel

Remova um canal de conda.

remove_channel(channel)

Parâmetros

Name Description
channel
Necessário
str

O canal conada para remover.

remove_conda_package

Remova um pacote de conda.

remove_conda_package(conda_package)

Parâmetros

Name Description
conda_package
Necessário
str

O pacote conda para remover.

remove_pip_option

Remova uma opção pip.

remove_pip_option(pip_option)

Parâmetros

Name Description
pip_option
Necessário
str

A opção pip para remover.

remove_pip_package

Remova um pacote pip.

remove_pip_package(pip_package)

Parâmetros

Name Description
pip_package
Necessário
str

O pacote pip para remover.

save

Salve o objeto conda dependencies no arquivo.

save(path=None)

Parâmetros

Name Description
path
str

O caminho totalmente qualificado do arquivo no qual você deseja salvar.

Default value: None

Devoluções

Tipo Description
str

O caminho normalizado conda.

Exceções

Tipo Description
UserErrorException

Levantado por questões que salvam as dependências.

save_to_file

DEPRECATED, use save.

Salve o objeto conda dependencies no arquivo.

save_to_file(base_directory, conda_file_path=None)

Parâmetros

Name Description
base_directory
Necessário
str

O diretório base para salvar o arquivo.
conda_file_path
str

O nome do arquivo.

Default value: None

Devoluções

Tipo Description
str

O caminho normalizado conda.

sdk_origin_url

Retornar a URL do índice de origem do SDK.

static sdk_origin_url()

Devoluções

Tipo Description
str

Retorna a URL do índice de origem do SDK.

serialize_to_string

Serialize o objeto conda dependencies em uma cadeia de caracteres.

serialize_to_string()

Devoluções

Tipo Description
str

O objeto conda dependencies serializado em uma cadeia de caracteres.

set_pip_index_url

Defina o URL do índice pip.

set_pip_index_url(index_url)

Parâmetros

Name Description
index_url
Necessário
str

A URL do índice pip a ser usada.

set_pip_option

Adicione uma opção pip.

set_pip_option(pip_option)

Parâmetros

Name Description
pip_option
Necessário
str

A opção pip para adicionar.

set_pip_requirements

Substitua toda a seção pip das dependências conda.

set_pip_requirements(pip_requirements)

Parâmetros

Name Description
pip_requirements
Necessário
list[str]

A lista de pacotes pip e opções.

set_python_version

Defina a versão do Python.

set_python_version(version)

Parâmetros

Name Description
version
Necessário
str

A versão Python a ser adicionada.

Devoluções

Tipo Description
None

Atributos

conda_channels

Canais de retorno conda.

Devoluções

Tipo Description
iter

Retorna as dependências do canal. As dependências retornadas são uma cópia e quaisquer alterações nos canais retornados não atualizarão os canais conda neste objeto.

conda_packages

Devolver pacotes de conda.

Devoluções

Tipo Description
iter

Retorna as dependências do pacote. Retorna uma cópia dos pacotes conda, e quaisquer edições na lista retornada não serão refletidas nos pacotes conda deste objeto.

pip_options

Opções de pip de retorno.

Devoluções

Tipo Description
iter

Retorna as opções de pip. Retorna uma cópia das opções pip e quaisquer edições na lista retornada não serão refletidas nas opções pip deste objeto.

pip_packages

Retornar dependências de pip.

Devoluções

Tipo Description
iter

Retorna as dependências pip. Retorna uma cópia dos pacotes pip e quaisquer edições na lista retornada não serão refletidas nos pacotes pip deste objeto.

DEFAULT_NUMBER_OF_CONDA_PACKAGES 

DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0

DEFAULT_NUMBER_OF_PIP_PACKAGES 

DEFAULT_NUMBER_OF_PIP_PACKAGES = 0