CondaDependencies Classe

  • Referência

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 de pip.

Se o parâmetro conda_dependencies_file_path 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 destino a versão mais recente disponível no PyPi.

Inicialize um novo objeto para gerenciar dependências.

Herança
builtins.object
CondaDependencies

Construtor

CondaDependencies(conda_dependencies_file_path=None, _underlying_structure=None)

Parâmetros

Nome Description
conda_dependencies_file_path
str

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

Valor padrão: None
_underlying_structure
Valor padrão: None

Comentários

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, é executada uma etapa de preparação, que cria e armazena em cache um ambiente conda no qual o experimento é executado.

Se sua dependência estiver disponível por meio do Conda e do pip (do PyPi), use a versão do Conda, pois os pacotes do 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 dependências de 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))

O exemplo completo 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 objeto Environment.


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

O exemplo completo 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

Adicionar um canal do conda.

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

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

Adicionar um pacote conda.
add_pip_package

Adicionar 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

Adicionar um pacote conda do Tensorflow.
add_tensorflow_pip_package

Adicionar um pacote de pip do Tensorflow.
as_dict

Retornar dependências do conda.
create

Inicializar um novo objeto CondaDependencies.

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

Observação

Se pip_packages 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 for definido como true, as dependências pip dos pacotes distribuídos como parte do SDK do 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

Retornar a versão do Python.
merge_requirements

Mesclar os requisitos do pacote.
remove_channel

Remover um canal conda.
remove_conda_package

Remover um pacote conda.
remove_pip_option

Remover uma opção de pip.
remove_pip_package

Remover um pacote pip.
save

Salvar o objeto de dependências conda no arquivo.
save_to_file

PRETERIDO, use save.

Salvar o objeto de dependências conda no arquivo.
sdk_origin_url

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

Serializar o objeto de dependências conda em uma cadeia de caracteres.
set_pip_index_url

Definir URL do índice pip.
set_pip_option

Adicionar uma opção de pip.
set_pip_requirements

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

Definir a versão do Python.

add_channel

Adicionar um canal do conda.

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

add_channel(channel)

Parâmetros

Nome Description
channel
Obrigatório
str

O canal conda a ser adicionado.

Retornos

Tipo Description
None

add_cntk_package

Adicionar um pacote do CNTK (Microsoft Cognitive Toolkit).

add_cntk_package(core_type='cpu')

Parâmetros

Nome Description
core_type
str

'cpu' ou 'gpu'.

Valor padrão: cpu

add_conda_package

Adicionar um pacote conda.

add_conda_package(conda_package)

Parâmetros

Nome Description
conda_package
Obrigatório
str

O pacote conda a ser adicionado.

add_pip_package

Adicionar 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

Nome Description
pip_package
Obrigatório
str

O pacote pip a ser adicionado.

add_tensorflow_conda_package

Adicionar um pacote conda do Tensorflow.

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

Parâmetros

Nome Description
core_type
str

'cpu' ou 'gpu'.

Valor padrão: cpu
version
str

A versão do pacote.

Valor padrão: None

add_tensorflow_pip_package

Adicionar um pacote de pip do Tensorflow.

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

Parâmetros

Nome Description
core_type
str

'cpu' ou 'gpu'.

Valor padrão: cpu
version
str

A versão do pacote.

Valor padrão: None

as_dict

Retornar dependências do conda.

as_dict() -> Any

create

Inicializar um novo objeto CondaDependencies.

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

Observação

Se pip_packages 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 for definido como true, as dependências pip dos pacotes distribuídos como parte do SDK do 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

Nome Description
pip_indexurl
str

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

Valor padrão: None
pip_packages
list[str]

Uma lista de pacotes pip.

Valor padrão: None
conda_packages
list[str]

Uma lista de pacotes conda.

Valor padrão: None
python_version
str

A versão do Python.

Valor padrão: 3.9.12
pin_sdk_version
bool

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

Valor padrão: True

Retornos

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

Retornos

Tipo Description
int

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

get_python_version

Retornar a versão do Python.

get_python_version()

Retornos

Tipo Description
str

A versão do Python.

merge_requirements

Mesclar os requisitos do pacote.

static merge_requirements(requirements)

Parâmetros

Nome Description
requirements
Obrigatório
list[str]

Uma lista de requisitos de pacotes a serem mesclados.

Retornos

Tipo Description
list[str]

Uma lista de requisitos de pacote mesclados.

remove_channel

Remover um canal conda.

remove_channel(channel)

Parâmetros

Nome Description
channel
Obrigatório
str

O canal conda a ser removido.

remove_conda_package

Remover um pacote conda.

remove_conda_package(conda_package)

Parâmetros

Nome Description
conda_package
Obrigatório
str

O pacote conda a ser removido.

remove_pip_option

Remover uma opção de pip.

remove_pip_option(pip_option)

Parâmetros

Nome Description
pip_option
Obrigatório
str

A opção de pip a ser removida.

remove_pip_package

Remover um pacote pip.

remove_pip_package(pip_package)

Parâmetros

Nome Description
pip_package
Obrigatório
str

O pacote pip a ser removido.

save

Salvar o objeto de dependências conda no arquivo.

save(path=None)

Parâmetros

Nome Description
path
str

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

Valor padrão: None

Retornos

Tipo Description
str

O caminho de conda normalizado.

Exceções

Tipo Description
UserErrorException

Gerado para problemas ao salvar as dependências.

save_to_file

PRETERIDO, use save.

Salvar o objeto de dependências conda no arquivo.

save_to_file(base_directory, conda_file_path=None)

Parâmetros

Nome Description
base_directory
Obrigatório
str

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

O nome de arquivo.

Valor padrão: None

Retornos

Tipo Description
str

O caminho de conda normalizado.

sdk_origin_url

Retornar a URL do índice de origem do SDK.

static sdk_origin_url()

Retornos

Tipo Description
str

Retorna a URL do índice de origem do SDK.

serialize_to_string

Serializar o objeto de dependências conda em uma cadeia de caracteres.

serialize_to_string()

Retornos

Tipo Description
str

O objeto de dependências conda serializado em uma cadeia de caracteres.

set_pip_index_url

Definir URL do índice pip.

set_pip_index_url(index_url)

Parâmetros

Nome Description
index_url
Obrigatório
str

A URL do índice pip a ser usada.

set_pip_option

Adicionar uma opção de pip.

set_pip_option(pip_option)

Parâmetros

Nome Description
pip_option
Obrigatório
str

A opção de pip a ser adicionada.

set_pip_requirements

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

set_pip_requirements(pip_requirements)

Parâmetros

Nome Description
pip_requirements
Obrigatório
list[str]

A lista de pacotes e opções de pip.

set_python_version

Definir a versão do Python.

set_python_version(version)

Parâmetros

Nome Description
version
Obrigatório
str

A versão do Python a ser adicionada.

Retornos

Tipo Description
None

Atributos

conda_channels

Retornar canais conda.

Retornos

Tipo Description
iter

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

conda_packages

Retornar pacotes conda.

Retornos

Tipo Description
iter

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

pip_options

Retornar opções de pip.

Retornos

Tipo Description
iter

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

pip_packages

Retornar dependências de pip.

Retornos

Tipo Description
iter

Retorna as dependências de pip. Retorna uma cópia dos pacotes pip, e as edições na lista retornada não serão refletidas nos pacotes de 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