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

conda_dependencies_file_path: str

valor padrão: None

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.

_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

channel: str

Obrigatório

O canal conda a ser adicionado.

Tipo de retorno

None

add_cntk_package

Adicionar um pacote do CNTK (Microsoft Cognitive Toolkit).

add_cntk_package(core_type='cpu')

Parâmetros

core_type: str

valor padrão: cpu

'cpu' ou 'gpu'.

add_conda_package

Adicionar um pacote conda.

add_conda_package(conda_package)

Parâmetros

conda_package: str

Obrigatório

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

pip_package: str

Obrigatório

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

core_type: str

valor padrão: cpu

'cpu' ou 'gpu'.

version: str

valor padrão: None

A versão do pacote.

add_tensorflow_pip_package

Adicionar um pacote de pip do Tensorflow.

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

Parâmetros

core_type: str

valor padrão: cpu

'cpu' ou 'gpu'.

version: str

valor padrão: None

A versão do pacote.

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.8.13', pin_sdk_version=True)

Parâmetros

pip_indexurl: str

valor padrão: None

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

pip_packages: list[str]

valor padrão: None

Uma lista de pacotes pip.

conda_packages: list[str]

valor padrão: None

Uma lista de pacotes conda.

python_version: str

valor padrão: 3.8.13

A versão do Python.

pin_sdk_version: bool

valor padrão: True

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

Retornos

Um objeto de dependência conda.

Tipo de retorno

CondaDependencies

get_default_number_of_packages

Retornar o número padrão de pacotes.

get_default_number_of_packages()

Retornos

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

Tipo de retorno

int

get_python_version

Retornar a versão do Python.

get_python_version()

Retornos

A versão do Python.

Tipo de retorno

str

merge_requirements

Mesclar os requisitos do pacote.

static merge_requirements(requirements)

Parâmetros

requirements: list[str]

Obrigatório

Uma lista de requisitos de pacotes a serem mesclados.

Retornos

Uma lista de requisitos de pacote mesclados.

Tipo de retorno

list[str]

remove_channel

Remover um canal conda.

remove_channel(channel)

Parâmetros

channel: str

Obrigatório

O canal conda a ser removido.

remove_conda_package

Remover um pacote conda.

remove_conda_package(conda_package)

Parâmetros

conda_package: str

Obrigatório

O pacote conda a ser removido.

remove_pip_option

Remover uma opção de pip.

remove_pip_option(pip_option)

Parâmetros

pip_option: str

Obrigatório

A opção de pip a ser removida.

remove_pip_package

Remover um pacote pip.

remove_pip_package(pip_package)

Parâmetros

pip_package: str

Obrigatório

O pacote pip a ser removido.

save

Salvar o objeto de dependências conda no arquivo.

save(path=None)

Parâmetros

path: str

valor padrão: None

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

Retornos

O caminho de conda normalizado.

Tipo de retorno

str

Exceções

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

base_directory: str

Obrigatório

O diretório base para salvar o arquivo.

conda_file_path: str

valor padrão: None

O nome de arquivo.

Retornos

O caminho de conda normalizado.

Tipo de retorno

str

sdk_origin_url

Retornar a URL do índice de origem do SDK.

static sdk_origin_url()

Retornos

Retorna a URL do índice de origem do SDK.

Tipo de retorno

str

serialize_to_string

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

serialize_to_string()

Retornos

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

Tipo de retorno

str

set_pip_index_url

Definir URL do índice pip.

set_pip_index_url(index_url)

Parâmetros

index_url: str

Obrigatório

A URL do índice pip a ser usada.

set_pip_option

Adicionar uma opção de pip.

set_pip_option(pip_option)

Parâmetros

pip_option: str

Obrigatório

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

pip_requirements: list[str]

Obrigatório

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

set_python_version

Definir a versão do Python.

set_python_version(version)

Parâmetros

version: str

Obrigatório

A versão do Python a ser adicionada.

Tipo de retorno

None

Atributos

conda_channels

Retornar canais conda.

Retornos

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.

Tipo de retorno

iter

conda_packages

Retornar pacotes conda.

Retornos

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.

Tipo de retorno

iter

pip_options

Retornar opções de pip.

Retornos

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.

Tipo de retorno

iter

pip_packages

Retornar dependências de pip.

Retornos

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.

Tipo de retorno

iter

DEFAULT_NUMBER_OF_CONDA_PACKAGES

DEFAULT_NUMBER_OF_CONDA_PACKAGES = 0

DEFAULT_NUMBER_OF_PIP_PACKAGES

DEFAULT_NUMBER_OF_PIP_PACKAGES = 0